API de prueba de Agent (actualizar / publicar)

Permite a los desarrolladores, en herramientas de IA como CodeX, Claude, etc. (con el GPTBots Agent Skill instalado), importar la configuración del archivo .bot generada por las Skills a un Agent de destino en la plataforma GPTBots y publicarlo.

⚠️ Solo se pueden invocar los Agents en «modo de prueba». Las invocaciones en modo formal devuelven 403200. El modo de prueba se selecciona al crear el Agent y no se puede modificar después de la creación.

API de actualización de Agent (importar .bot para reemplazar la versión actual)

Importa el archivo .bot al Agent de destino (modo de prueba) y guarda la configuración actual reemplazada como una nueva versión de borrador (que pasa a ser también la «versión actual»). Las reglas concretas son las siguientes:

• Bases de conocimiento (grupos de datos) / tablas de base de datos / documentos de conocimiento: según la dimensión AgentID, se conservan los que sigan perteneciendo al Agent de destino; en caso contrario, se descartan;
• Workflows / herramientas (plugins) asociados: según la dimensión organización, se conservan los que sigan siendo válidos; en caso contrario, se descartan;
• Los montajes de bases de conocimiento de nivel superior no se exportan junto con el .bot; al importar se conservan las bases de conocimiento que el propio Agent de destino ya tenga montadas;
• Credenciales de terceros: al importar a un Agent existente, se rellenan las credenciales ya configuradas en el destino según el «mismo ID de componente/nodo/plugin», sin vaciar los componentes ya autenticados, para garantizar su disponibilidad;

Método de solicitud

POST

URL de solicitud

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

Solicitud

Ejemplo de solicitud

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/agent/version/import' \
-H 'Authorization: Bearer {AGENT_API_KEY}' \
-H 'Content-Type: multipart/form-data' \
-F 'file=@my-agent.bot' \
-F 'versionDesc=Imported by AI tool'

                    

Cabeceras de la solicitud

Parámetros de la solicitud

El número de versión lo genera automáticamente el servidor (se toma el último segmento de la versión más reciente +1; si no hay versiones históricas, será 1.0.0).

Respuesta

Ejemplo de respuesta

                      
                      {
  "code": 0,
  "msg": "OK",
  "data": {
    "botId": "xxx",
    "botType": "QuestionAnswer",
    "version": "1.0.3"
  }
}

                    

Respuesta de éxito

Respuesta de error

API de publicación de Agent (publicar como versión en producción según el número de versión)

Publica el número de versión especificado del Agent de destino (modo de prueba) como versión de producción en línea (esa versión pasa a estar «en línea» y las demás versiones vuelven al estado de borrador).

Método de solicitud

POST

URL de solicitud

https://api-${endpoint}.gptbots.ai/v1/agent/version/release

Solicitud

Ejemplo de solicitud

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/agent/version/release' \
-H 'Authorization: Bearer {AGENT_API_KEY}' \
-H 'Content-Type: application/json' \
-d '{
        "version": "1.0.3"
}'

                    

Cabeceras de la solicitud

Parámetros de la solicitud

Respuesta

Ejemplo de respuesta

                      
                      {
  "code": 0,
  "msg": "OK"
}

                    

Respuesta de éxito

Sin cuerpo de datos; si code es 0, la publicación se ha realizado correctamente.

Respuesta de error

Códigos de error

Las interfaces de actualización y publicación comparten el mismo conjunto de códigos de error: