Agent-Version importieren

Ermöglicht das Hochladen einer .bot-Datei, um die aktuelle Agent-Konfiguration zu ersetzen und als neue Version zu speichern.

Diese Schnittstelle verwendet zur Authentifizierung den API Key des jeweiligen Ziel-Agent und kann nur von Agent aufgerufen werden, für die die Berechtigung zur Versionsverwaltung aktiviert ist.

Anfragemethode

POST

Anfrage-URL

https://api.${endpoint}/v1/agent/version/import

Authentifizierung der Anfrage

Einzelheiten finden Sie in den Erläuterungen zur Authentifizierung in der API-Übersicht. Verwenden Sie den API Key des Ziel-Agent als token.

Anfrage

Beispielanfrage

curl -X POST 'https://api.${endpoint}/v1/agent/version/import' \ -H 'Authorization: Bearer ${token}' \ -F 'file=@/path/to/agent.bot' \ -F 'versionDesc=Update prompt and tools'

                      
                      curl -X POST 'https://api.${endpoint}/v1/agent/version/import' \
  -H 'Authorization: Bearer ${token}' \
  -F 'file=@/path/to/agent.bot' \
  -F 'versionDesc=Update prompt and tools'

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Bearer ${token}	Verwenden Sie den API Key des Ziel-Agent zur Authentifizierung der Anfrage.
Content-Type	multipart/form-data	Formular für den Datei-Upload.

Anfrageparameter (Form Data)

Parameter	Typ	Beschreibung	required
file	File	`.bot`-Datei.	true
versionDesc	String	Versionsbeschreibung.	false

Antwort

Antwort-Body

{ "code": 0, "message": "OK", "data": { "botId": "bot-xxxx", "botType": "Agent", "version": "v2", "warning": null } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "botId": "bot-xxxx",
    "botType": "Agent",
    "version": "v2",
    "warning": null
  }
}

Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld	Typ	Beschreibung
botId	String	Ziel-Agent-ID.
bot_type	String	Agent-Typ: `Agent`, `FlowAgent`, `LoopAgent`, `Audio`.
version	String	Gespeicherte Versionsnummer, die zugleich zur aktuellen Version wird.
warning	String	Warnhinweis beim Import; null, wenn keiner vorliegt.

Fehlerantwort

Feld	Typ	Beschreibung
code	int	Fehlercode.
message	string	Fehlermeldung.

Statuscodes

Statuscode	Beschreibung
200	Erfolgreich
400	Ungültige Parameter
401	Nicht autorisiert
403	Unzureichende Berechtigungen oder API Key hat keine Berechtigung zur Versionsverwaltung
429	Zu viele Anfragen
500	Serverfehler