Privaten Agent-Skill aktualisieren

Über diese Schnittstelle können Sie einen privaten Skill des Agent aktualisieren, zu dem der aktuelle LoopAgent-API-Key gehört. Die Skill-ID wird über das Multipart-Formularfeld skill_id übergeben und erscheint nicht im URL-Pfad.

Es wird nur LoopAgent unterstützt, und es lassen sich nur private Skill aktualisieren, die dem Agent des aktuellen Agent-API-Key gehören.
Die Zielabfrage wird durch skill_id + projectId + botId eingeschränkt; Skill, die nicht zum aktuellen Agent gehören, werden abgelehnt.
Das Dateiformat entspricht der Erstellungsschnittstelle: Es werden nur .skill und .zip akzeptiert, das Archiv darf maximal 20 MiB groß sein.
Die Aktualisierung speichert nur eine Inhaltsversion des Skill, bindet den Skill jedoch nicht automatisch, speichert keine Agent-Entwurfsversion und veröffentlicht keine produktive Agent-Version.

Anfragemethode

POST

Anfrage-URL

https://api.${endpoint}/v1/agent/skill/update

Authentifizierung der Anfrage

Verwenden Sie den Agent Key des Ziel-LoopAgent; dieser Key muss über die Berechtigung zur Versionsverwaltung verfügen. Einzelheiten finden Sie in den Erläuterungen zur Authentifizierung in der API-Übersicht.

Anfrage

Beispielanfrage

curl -X POST 'https://api.${endpoint}/v1/agent/skill/update' \ -H 'Authorization: Bearer ${API Key}' \ -F 'skill_id=skill-xxxx' \ -F 'file=@/path/to/refund-policy-v2.skill'

                      
                      curl -X POST 'https://api.${endpoint}/v1/agent/skill/update' \
  -H 'Authorization: Bearer ${API Key}' \
  -F 'skill_id=skill-xxxx' \
  -F 'file=@/path/to/refund-policy-v2.skill'

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Bearer ${API Key}	Authentifizierung mit dem API Key des Ziel-LoopAgent; dieser Key muss über die Berechtigung zur Versionsverwaltung verfügen.
Content-Type	multipart/form-data	Upload der Skill-Paketdatei als Formular.

Anfrageparameter (Form Data)

Parameter	Typ	Erforderlich	Beschreibung
`skill_id`	String	Ja	ID des zu aktualisierenden privaten Agent-Skill.
`file`	File	Ja	`.skill`- oder `.zip`-Skill-Paket.
`category_id`	String	Nein	Kategorie-ID nach der Aktualisierung; kann weggelassen werden, in diesem Fall wird die ursprüngliche Kategorie beibehalten.

Der Server vergleicht die aktuelle Datei und die Metadaten des Ziel-Skill; bei vollständiger Übereinstimmung wird direkt die aktuelle Version zurückgegeben, ohne in den Objektspeicher oder in MongoDB zu schreiben, und der Aufrufer muss auch keinen Idempotenz-Header übergeben.

Antwort

Beispielantwort

{ "code": 0, "message": "OK", "data": { "skill_id": "skill-xxxx", "name": "refund_policy", "version": "1.0.2" } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "skill_id": "skill-xxxx",
    "name": "refund_policy",
    "version": "1.0.2"
  }
}

Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld	Typ	Beschreibung
skill_id	String	ID des aktualisierten Skill, bleibt unverändert.
name	String	Skill-Name.
version	String	Versionsnummer des Skill nach der Aktualisierung.

Fehlerantwort

Feld	Typ	Beschreibung
code	Integer	Fehlercode.
message	String	Fehlerdetails.

Statuscodes

Statuscode	Beschreibung
200	Erfolgreich
400	Ungültige Parameter
401	Nicht autorisiert
403	Unzureichende Berechtigungen
429	Zu viele Anfragen
500	Serverfehler