Assistants
KI-Assistenten-Endpunkte
https://app.meingpt.com/api/assistants/v1/Verfügbare Assistenten abrufen
Ruft alle Assistenten ab, die dem authentifizierten Benutzer zur Verfügung stehen
🔒 ApiKeyAuth
Parameter
| Parameter | In | Typ | Beschreibung |
|---|---|---|---|
| Authorization* | header | string | API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'. |
Responses
| Feld | Typ | Beschreibung |
|---|---|---|
| assistants | Array<object> |
| Feld | Typ | Beschreibung |
|---|---|---|
| status | string | |
| message | string |
https://app.meingpt.com/api/assistants/v1/{assistantId}/runEinen Assistenten ausführen
Führt einen Assistenten mit den bereitgestellten Nachrichten aus und gibt die Antwort des Assistenten mit Tool-Aufrufen und Begründungen zurück. Alternativ kannst Du auch `multipart/form-data` verwenden, um Dateien mitzugeben. Dabei wird `messages` als JSON-String gesendet und Dateien über `files` hochgeladen.
🔒 ApiKeyAuth
Parameter
| Parameter | In | Typ | Beschreibung |
|---|---|---|---|
| Authorization* | header | string | API-Schlüssel zur Authentifizierung. Verwende das Format 'Bearer <Dein-API-Schlüssel>'. |
| assistantId* | path | string | Die Assistenten-ID |
Request Body · application/json
| Feld | Typ | Beschreibung |
|---|---|---|
| messages* | Array<ChatMessage> |
Responses
| Feld | Typ | Beschreibung |
|---|---|---|
| text | string | Antworttext des Assistenten |
| model | string | Verwendetes Modell für die Generierung |
| messages | Array<object> | Antwortnachrichten des Assistenten inkl. Tool-Aufrufen und Begründungen |
| usage | object | |
| citations | Array<string> | Zitate aus Tool-Nutzung |
| Feld | Typ | Beschreibung |
|---|---|---|
| status | string | |
| message | string |
| Feld | Typ | Beschreibung |
|---|---|---|
| status | string | |
| message | string |
| Feld | Typ | Beschreibung |
|---|---|---|
| status | string | |
| message | string |
Dateien an einen Assistenten-Lauf anhängen
Du kannst einem Assistenten-Lauf Dateien mitgeben. Der aktuell tatsächlich durchgesetzte Größenlimit liegt bei 50 MB pro Datei — die in der API-Referenz teils genannten 150 MB sind nicht der Wert, der serverseitig geprüft wird. Prüfe im Zweifel die API-Referenz für den jeweils aktuellen Wert, da sich dieser ändern kann.
Achtung
Konnektoren (z. B. Outlook, SharePoint) stehen bei einem Assistenten-Lauf über die externe API nicht zur Verfügung — sie funktionieren nur im interaktiven Chat.
AssistantId finden
- Gehe in den Bearbeitungsmodus deines Assistenten
- In der URL findest du hinter
/assistants/die AssistantId
