Privaten Agent-Skill erstellen

Über diese Schnittstelle können Sie einen privaten Skill für den LoopAgent erstellen, zu dem der aktuelle Agent-API-Key gehört.

Es wird nur LoopAgent unterstützt; normale Agenten, Flow Agent und Workflow werden nicht unterstützt.
Es wird nur ein privater Skill für den Agent erstellt, zu dem der aktuelle Agent-API-Key gehört.
Es werden nur .skill und .zip akzeptiert; das Archiv darf maximal 20 MiB groß sein, höchstens 200 gültige Dateien enthalten, eine einzelne Datei nach dem Entpacken maximal 5 MiB und das gesamte Paket nach dem Entpacken maximal 64 MiB.
Im Wurzelverzeichnis des Pakets oder im einzigen obersten Verzeichnis muss SKILL.md enthalten sein, dessen Frontmatter name enthalten muss.
Das Erstellen bindet den Skill nicht automatisch an den Agent und speichert oder veröffentlicht auch keine Agent-Version automatisch.

Anfragemethode

POST

Anfrage-URL

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

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/create' \ -H 'Authorization: Bearer ${API Key}' \ -F 'file=@/path/to/refund-policy.skill'

                      
                      curl -X POST 'https://api.${endpoint}/v1/agent/skill/create' \
  -H 'Authorization: Bearer ${API Key}' \
  -F 'file=@/path/to/refund-policy.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
`file`	File	Ja	`.skill`- oder `.zip`-Skill-Paket.
`category_id`	String	Nein	ID der Skill-Kategorie; bei fehlender Angabe wird ohne Kategorie erstellt.

Antwort

Beispielantwort

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

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

Dieser Codeblock im schwebenden Fenster

Erfolgreiche Antwort

Feld	Typ	Beschreibung
skill_id	String	ID des neu erstellten Skill.
name	String	Skill-Name.
version	String	Versionsnummer des Skill.

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