Deaktivierte Agenten sind mit
disabled: true enthalten, aber Chat-Completions lehnen sie mit 403 und dem Code ASSISTANT_DISABLED ab, bis sie wieder aktiviert werden.Bevor du startest
- API-Key-Scope: Erfordert den Scope Agenten lesen oder den bisherigen Scope Agenten-API (voller Zugriff).
- Veraltete Assistants API: Dies ist die neue Agents API mit nativer Vercel AI SDK Kompatibilität. Wenn du die veraltete Assistants API verwendest, siehe den Migrations-Guide.
Basis-URL
Parameter
Beispiele
Erste Seite
Validierungsregeln
Die API erzwingt die folgenden Validierungsregeln:- API-Schlüssel-Zugriff: Die Liste enthält nur Agenten, die mit diesem API-Schlüssel zum Aufrufen geteilt sind
- Workspace: Agenten müssen zum selben Workspace gehören wie dein API-Schlüssel
- Ausgelassene Agenten: Gelöschte und archivierte Agenten fehlen. Projekte sind nicht enthalten. Deaktivierte Agenten bleiben in der Liste, mit
disabledauftrue. Du kannst erst wieder mit ihnen chatten, wenn sie wieder aktiviert sind
model auto.
Jeder Eintrag enthält weniger Felder als Agenten-Details abrufen. owner ist der aktuelle Besitzer, solange dieser Nutzer noch eine aktive Mitgliedschaft im Workspace hat. Gibt es mehrere Besitzer, ist es der zuletzt vergebene, der noch aktives Mitglied ist. Der Wert ist null, wenn kein verbleibender Besitzer ein aktives Mitglied ist.
nextCursor ist nur enthalten, wenn eine weitere Seite existiert. Sende ihn als cursor, um die nächste Seite zu laden. Ein gültiger UUID-Cursor, der zu keinem Agenten passt, liefert 200 mit einem leeren agents-Array.
Antwortformat
Erfolgsantwort (200 OK)
Fehlerbehandlung
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.