Upload an attachment
Agents API
Upload Attachment API
Dateien hochladen, die mit Agents verwendet werden können
POST
Upload an attachment
Lade Dateien hoch, auf die in Agent-Konversationen über ihre Anhangs-IDs verwiesen werden kann.
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.
Autorisierungen
API key as Bearer token. Format "Bearer YOUR_API_KEY"
Body
multipart/form-data
The file to upload