DokumentationIhren Assistenten erstellen
Ihre Assistenten
Ihren Assistenten erstellen
Ein Assistent vereint Anweisungen, ein Modell und ein Konversationsgedächtnis. Sie erstellen ihn über die API und sprechen dann in Threads mit ihm.
Auf dieser Seite
Zugriff
Die Routen der Assistenten handeln im Namen einer Person. Sie verlangen deren Learnya-Zugriffstoken, das über OAuth für die Audience https://api.learnya.ai ausgestellt wird. API-Schlüssel geben nur Zugriff auf die Modelle.
Einen Assistenten erstellen
POST /v1/assistant Erstellt den Assistenten und gibt seine ID zurück.
curl https://api.learnya.ai/v1/assistant \
-H "Authorization: Bearer $LEARNYA_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Billing desk",
"model": "learnya-flash",
"instructions": "Answer billing questions plainly.",
"visibility": "private",
"contextWindow": { "mode": "last_n", "historyLimit": 20 }
}'import os
import requests
API = "https://api.learnya.ai/v1"
TOKEN = os.environ["LEARNYA_TOKEN"]
HEADERS = {"Authorization": f"Bearer {TOKEN}"}
assistant = requests.post(
f"{API}/assistant",
headers=HEADERS,
json={
"name": "Billing desk",
"model": "learnya-flash",
"instructions": "Answer billing questions plainly.",
"visibility": "private",
"contextWindow": {"mode": "last_n", "historyLimit": 20},
},
).json()
print(assistant["id"])const API = "https://api.learnya.ai/v1"
const headers = {
Authorization: `Bearer ${process.env.LEARNYA_TOKEN}`,
"Content-Type": "application/json",
}
const response = await fetch(`${API}/assistant`, {
method: "POST",
headers,
body: JSON.stringify({
name: "Billing desk",
model: "learnya-flash",
instructions: "Answer billing questions plainly.",
visibility: "private",
contextWindow: { mode: "last_n", historyLimit: 20 },
}),
})
const assistant = await response.json()
console.log(assistant.id)interface Assistant {
id: string
name: string
model: string
instructions?: string | null
visibility: "private" | "org" | "instance"
createdAt: string
}
const API = "https://api.learnya.ai/v1"
const headers = {
Authorization: `Bearer ${process.env.LEARNYA_TOKEN}`,
"Content-Type": "application/json",
}
const response = await fetch(`${API}/assistant`, {
method: "POST",
headers,
body: JSON.stringify({
name: "Billing desk",
model: "learnya-flash",
instructions: "Answer billing questions plainly.",
visibility: "private",
contextWindow: { mode: "last_n", historyLimit: 20 },
}),
})
const assistant = (await response.json()) as Assistant
console.log(assistant.id){
"id": "6f1c2b0e-3a4d-4c8e-9b7a-2d5e8f1a0c34",
"name": "Billing desk",
"instructions": "Answer billing questions plainly.",
"model": "learnya-flash",
"tools": [],
"responseFormat": { "type": "text" },
"contextWindow": { "mode": "last_n", "historyLimit": 20 },
"visibility": "private",
"ownerUserId": "0b9d4e2a-7c1f-4a6b-8e3d-5f2a9c7b1e08",
"createdAt": "2026-10-09T09:41:12.000Z"
}Die Felder
nameTexterforderlich- Sein Name, wie Personen ihn in Learnya sehen.
modelTexterforderlich- Das Modell, das ihn antreibt: learnya-flash oder learnya-max.
instructionsText- Seine Anweisungen, bis zu 500’000 Zeichen.
visibilityText- private beschränkt ihn auf die Person, die ihn erstellt. org und instance teilen ihn mit der Organisation oder dem ganzen Arbeitsbereich und erfordern Administratorrechte.
contextWindowObjekt- Was er aus einem Thread erneut liest: full, none oder die letzten Nachrichten mit last_n und historyLimit, von 1 bis 500.
responseFormatObjekt- text oder json mit einem Schema, um die Antwort in Ihrem Code zu lesen.
Lesen, ändern, löschen
GET /v1/assistants Die Assistenten, die die Person verwenden kann.
GET /v1/assistant/{id} Ein einzelner Assistent.
PUT /v1/assistant/{id} Ändert die gesendeten Felder, und nur diese.
DELETE /v1/assistant/{id} Löscht den Assistenten.
Nur die Person, die einen Assistenten erstellt hat, und die Administratoren des Arbeitsbereichs können ihn ändern oder löschen.