Este endpoint retorna informações sobre os agentes disponíveis para um host específico.

Endpoint

POST /api/externalAPIs/public/tolkyReasoning/agentsListHelper

Parâmetros

ParâmetroTipoDescrição
hostIdstring (UUID)UUID do host (obrigatório)

Exemplo de Requisição

curl -X POST \
  '{BASE_URL}/api/externalAPIs/public/tolkyReasoning/agentsListHelper' \
  -H 'Content-Type: application/json' \
  -d '{
    "hostId": "uuid-do-host"
  }'

Exemplo de Resposta

{
  "code": 200,
  "message": "Success",
  "data": {
    "agents": [
      {
        "id": "uuid-do-agente",
        "createdAt": "2024-11-21T19:28:56.621624+00:00",
        "updatedAt": "2025-03-19T19:03:26.35329+00:00",
        "agentName": "nome-do-agente",
        "description": "descricao-do-agente",
        "frontSchema": {
          "id": "id-do-agente",
          "type": "object",
          "title": "titulo",
          "schema": "url-para-o-schema",
          "required": [],
          "properties": {
            "testBlock": {
              "type": "boolean",
              "default": false,
              "description": "descricao-do-test"
            }
          },
          "description": "descricao-do-schema"
        },
        "schemaName": "public",
        "schemaId": "uuid-do-schema",
        "lucideIcon": "nome-do-icone",
        "frontName": "nome-exibido-no-front",
        "advanced": true
      }
    ],
    "schemas": [
      {
        "id": "uuid-do-schema",
        "createdAt": "2024-11-09T14:04:49.163551+00:00",
        "updatedAt": "2024-11-09T14:04:49.163551",
        "schemaName": "public",
        "description": "descricao-do-schema",
        "deleted": false
      }
    ]
  }
}

Códigos de Erro

  • 400: Campos obrigatórios ausentes ou inválidos
  • 401: Token de autenticação inválido ou ausente
  • 500: Erro interno do servidor