Crear Skill

Permite crear un Skill de nivel de organización en una organización específica, o un Skill privado de un Agent determinado.

Mediante esta interfaz, se puede crear un Skill de nivel de organización en una organización específica, o crear un Skill privado de un Agent determinado.

Método de solicitud

POST

URL de la solicitud

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

Autenticación de la solicitud

Utiliza la autenticación Basic con DevKey / DevSecret a nivel de cuenta y requiere que la cuenta que realiza la llamada tenga permiso de creación de Skill de la organización.

Solicitud

Ejemplo de solicitud

curl -X POST 'https://api.${endpoint}/v1/org/skill/create' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -H 'Content-Type: application/json' \ -d '{ "org_id": "p-xxxx", "name": "refund-policy", "display_name": "退款政策", "description": { "en_US": "Handling customer refund requests", "zh_CN": "处理客户退款请求" }, "owner_agent_id": "bot-xxxx" }'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/skill/create' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{
    "org_id": "p-xxxx",
    "name": "refund-policy",
    "display_name": "退款政策",
    "description": {
      "en_US": "Handling customer refund requests",
      "zh_CN": "处理客户退款请求"
    },
    "owner_agent_id": "bot-xxxx"
  }'

Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Campo	Tipo	Descripción
Authorization	Basic ${BASIC_TOKEN}	Basic Token resultante de codificar `DevKey:DevSecret` en Base64.
Content-Type	application/json	Formato del cuerpo de la solicitud.

Parámetros de la solicitud (Body Parameters)

Campo	Tipo	Descripción	Obligatorio
org_id	String	ID de la organización.	true
name	String	Nombre del Skill, hasta 50 caracteres.	true
display_name	String	Nombre de visualización del Skill, hasta 50 caracteres.	false
description	Object	Descripción multilingüe del Skill; debe incluir `en_US`.	true
owner_agent_id	String	ID del Agent al que pertenece el Skill privado. Si no se indica, se crea un Skill de nivel de organización.	false

Respuesta

Ejemplo de respuesta

{ "code": 0, "message": "OK", "data": { "skill_id": "skill-xxxx", "name": "refund-policy", "owner_type": "ORGANIZATION" } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "skill_id": "skill-xxxx",
    "name": "refund-policy",
    "owner_type": "ORGANIZATION"
  }
}

Este bloque de código en una ventana flotante

Respuesta correcta

Campo	Tipo	Descripción
skill_id	String	ID del Skill recién creado.
name	String	Nombre del Skill.
owner_type	String	Tipo de propietario del Skill.

Respuesta fallida

Campo	Tipo	Descripción
code	Integer	Código de error.
message	String	Detalles del error.

Códigos de estado

Código de estado	Descripción
200	Correcto
400	Error de parámetros
401	No autorizado
403	Permisos insuficientes
429	Demasiadas solicitudes
500	Error del servidor