Este endpoint gera um payload completo e detalhado para um agente específico.

Endpoint

POST /api/externalAPIs/public/tolkyReasoning/generateAgentHelper

Parâmetros

ParâmetroTipoDescrição
agentobjetoObjeto contendo informações do agente (obrigatório)
instructionsstringInstruções adicionais para a requisição (obrigatório)

Estrutura do objeto agent

PropriedadeTipoDescrição
idstring (UUID)Identificador único do agente
createdAtstring (date-time)Data de criação do agente
updatedAtstring (date-time)Data da última atualização do agente
agentNamestringNome do agente
descriptionstringDescrição do agente
frontSchemaobjetoEsquema de configuração do front-end
schemaNamestringNome do esquema
schemaIdstring (UUID)ID do esquema
lucideIconstringNome do ícone Lucide
frontNamestringNome exibido no front-end
advancedbooleanIndica 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álidos
  • 403: Credenciais inválidas ou sem permissão de acesso
  • 408: A requisição excedeu o limite de tempo de 60 segundos
  • 500: Erro interno do servidor