Gerenciamento de Fluxos de Automação
Gerar Payload de Agente
Endpoint para gerar payload completo de um agente específico
Este endpoint gera um payload completo e detalhado para um agente específico.
Endpoint
POST /api/externalAPIs/public/tolkyReasoning/generateAgentHelper
Parâmetros
Parâmetro | Tipo | Descrição |
---|---|---|
agent | objeto | Objeto contendo informações do agente (obrigatório) |
instructions | string | Instruções adicionais para a requisição (obrigatório) |
Estrutura do objeto agent
Propriedade | Tipo | Descrição |
---|---|---|
id | string (UUID) | Identificador único do agente |
createdAt | string (date-time) | Data de criação do agente |
updatedAt | string (date-time) | Data da última atualização do agente |
agentName | string | Nome do agente |
description | string | Descrição do agente |
frontSchema | objeto | Esquema de configuração do front-end |
schemaName | string | Nome do esquema |
schemaId | string (UUID) | ID do esquema |
lucideIcon | string | Nome do ícone Lucide |
frontName | string | Nome exibido no front-end |
advanced | boolean | Indica se é um agente avançado |
Exemplo de Requisição
curl -X POST \
'{BASE_URL}/api/externalAPIs/public/tolkyReasoning/generateAgentHelper' \
-H 'Content-Type: application/json' \
-d '{
"agent": {
"id": "uuid-do-agente",
"agentName": "nome-do-agente",
"description": "descrição do agente",
"frontSchema": {
"id": "id-do-schema",
"type": "object",
"title": "Título do Schema",
"properties": {
"testBlock": {
"type": "boolean",
"default": false,
"description": "Descrição do teste"
}
}
},
"schemaName": "public",
"schemaId": "uuid-do-schema",
"lucideIcon": "icon-name",
"frontName": "Nome no Front",
"advanced": false
},
"instructions": "Instruções adicionais para processamento"
}'
Exemplo de Resposta
{
"code": 200,
"data": {
"id": "agent-id",
"type": "agent-type",
"title": "agent-title",
"schema": "agent-schema",
"required": [],
"properties": {
"testBlock": {
"type": "boolean",
"default": false,
"description": "Valor para determinar se o agente deve ser bloqueado nos testes automatizados",
"value": true
}
},
"description": "agent-description"
},
"message": "OK"
}
Códigos de Erro
400
: Campos obrigatórios ausentes ou inválidos403
: Credenciais inválidas ou sem permissão de acesso408
: A requisição excedeu o limite de tempo de 60 segundos500
: Erro interno do servidor