Bevor du startest
- API-Key-Scope: Erfordert einen API-Schlüssel mit dem
KNOWLEDGE_FOLDER_APIScope. Du kannst API-Schlüssel in deinen Workspace Einstellungen erstellen. - Veraltete Assistants API: Dies ist die neue Agents API mit nativer Vercel AI SDK Kompatibilität. Der Upload-Attachment-Endpunkt wird von beiden APIs gemeinsam genutzt. Wenn du die veraltete Assistants API verwendest, siehe den Migrations-Guide.
Basis-URL
Anforderungsformat
Dieser Endpunkt akzeptiertmultipart/form-data Anfragen mit einem einzelnen Datei-Upload.
Antwortformat
Die API gibt die Informationen zur hochgeladenen Datei zurück:Beispiel
Fehlerbehandlung
Upload-Fehler
Ein Fehler bei der Validierung des Dateiinhalts gibt folgende Antwort zurück:
Attachment verwenden
Die hochgeladene Anhangs-ID kann in der Agent-API auf zwei Arten verwendet werden:- Pro Nachricht (empfohlen): Füge die Anhangs-UUID in das
metadata.attachmentsArray der Nachricht ein, wenn du die Completions API aufrufst - Auf Agent-Ebene: Füge die Anhangs-UUID in das
attachmentsArray ein, wenn du einen Agenten erstellst oder aktualisierst
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.