Importer et créer un Agent

Permet de téléverser un fichier .bot et de l'importer en tant qu'Agent au sein de l'organisation.

Cette interface permet de téléverser un fichier .bot et de l'importer en tant qu'Agent au sein de l'organisation. Après une importation réussie, une API Key est créée automatiquement, mais la gestion des versions est désactivée par défaut pour cette clé.

Méthode de requête

POST

URL de la requête

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

Authentification de la requête

Utilise l'authentification Basic avec la DevKey / le DevSecret de niveau compte et requiert que le compte appelant dispose de l'autorisation de création d'Agent de l'organisation.

Requête

Exemple de requête

curl -X POST 'https://api.${endpoint}/v1/org/agent/import' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -F 'file=@/path/to/agent.bot' \ -F 'org_id=p-xxxx' \ -F 'custom_name=Imported Agent' \ -F 'enable_api=true' \ -F 'group_id=group-xxxx'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/agent/import' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -F 'file=@/path/to/agent.bot' \
  -F 'org_id=p-xxxx' \
  -F 'custom_name=Imported Agent' \
  -F 'enable_api=true' \
  -F 'group_id=group-xxxx'

Ce bloc de code dans la fenêtre flottante

En-têtes de la requête

Champ	Type	Description
Authorization	Basic ${BASIC_TOKEN}	Utilisez le Basic Token obtenu en encodant `DevKey:DevSecret` en Base64.
Content-Type	multipart/form-data	Formulaire de téléversement de fichier.

Paramètres de la requête (Form Data)

Champ	Type	Description	required
file	File	Fichier `.bot`. Les fichiers MultiAgent ne sont pas pris en charge.	true
org_id	String	ID de l'organisation.	true
custom_name	String	Nom d'Agent personnalisé après l'importation.	false
enable_api	Boolean	Indique s'il faut tenter d'activer l'API, `true` par défaut. Si le forfait ne prend pas en charge l'API, l'importation réussit tout de même et renvoie `api_enabled=false`.	false
group_id	String	Rejoint le groupe d'Agents spécifié après une importation réussie.	false

Réponse

Exemple de réponse

{ "code": 0, "message": "OK", "data": { "agent_id": "bot-xxxx", "name": "Imported Agent", "bot_type": "AGENT", "api_key": "app-xxxx", "api_enabled": true, "version_manage_enabled": false, "warning": null } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "agent_id": "bot-xxxx",
    "name": "Imported Agent",
    "bot_type": "AGENT",
    "api_key": "app-xxxx",
    "api_enabled": true,
    "version_manage_enabled": false,
    "warning": null
  }
}

Ce bloc de code dans la fenêtre flottante

Réponse en cas de succès

Champ	Type	Description
agent_id	String	ID de l'Agent après l'importation.
name	String	Nom de l'Agent.
bot_type	String	Type d'Agent : `Agent`, `FlowAgent`, `LoopAgent`, `Audio`.
api_key	String	API Key créée automatiquement, renvoyée une seule fois. Cette clé ne dispose pas de l'autorisation de publication ; pour publier, vous devez créer une clé manuellement.
api_enabled	Boolean	Indique si l'API est activée.
version_manage_enabled	Boolean	Indique si la gestion des versions est autorisée ; désactivée par défaut lors de l'importation.
warning	String	Avertissement d'importation.

Réponse en cas d'échec

Champ	Type	Description
code	Integer	Code d'erreur.
message	String	Détails de l'erreur.

Codes d'état

Code d'état	Description
200	Succès
400	Erreur de paramètre
401	Non autorisé
403	Autorisation insuffisante
429	Requêtes trop fréquentes
500	Erreur du serveur