Endpoint

GET /listActions

Parâmetros

Nenhum. Método GET.

Exemplo

curl -X GET "{{BASE_URL}}/listActions"

Resposta

{
  "data": {
    "actions": [
      {
        "name": "ragSearch",
        "description": "Realiza uma busca semântica na base de conhecimento do host autenticado...",
        "params": {
          "required": ["query"],
          "properties": {
            "query": {
              "type": "string",
              "description": "Pergunta ou texto a ser buscado na base de conhecimento."
            },
            "avatarId": {
              "type": "string",
              "description": "UUID do avatar. Quando fornecido, restringe a busca aos datasets associados a este avatar."
            },
            "maxChunks": {
              "type": "integer",
              "description": "Quantidade máxima de chunks a retornar. Padrão: 3. Máximo: 10."
            },
            "matchThreshold": {
              "type": "number",
              "description": "Limiar mínimo de similaridade semântica entre 0.0 e 1.0. Padrão: 0.2."
            }
          }
        },
        "costControl": {
          "timeoutMs": 30000,
          "retryPolicy": { "maxAttempts": 3, "onExhausted": "abort" },
          "usesLlmForParams": true
        }
      },
      {
        "name": "respondToUser",
        "description": "Entrega uma resposta final ao usuário. Deve ser o último step...",
        "params": {
          "required": ["message"],
          "properties": {
            "message": {
              "type": "string",
              "description": "Resposta final a ser entregue ao usuário."
            }
          }
        },
        "costControl": {
          "timeoutMs": 30000,
          "retryPolicy": { "maxAttempts": 1, "onExhausted": "abort" },
          "usesLlmForParams": true
        }
      }
    ],
    "costControl": {
      "defaultMaxSteps": 28,
      "defaultStepTimeoutMs": 30000,
      "planningModel": "gpt-5.5",
      "executionModel": "gpt-4.1-nano",
      "costModel": {
        "planningLlmCalls": 1,
        "executionLlmCallsPerStep": 1,
        "estimatedTotalLlmCallsFormula": "1 + stepCount",
        "availableActions": 111
      }
    }
  }
}

Campos da Resposta

data
object

Consulte este endpoint para obter o catálogo real de ações (name, description, params, costControl por ação). O objeto costControl global espelha os defaults do motor quando options é omitido em runWithAgents (maxSteps 28, highModel gpt-5.5, lowModel gpt-4.1-nano). Use para estimar custo antes de executar: 1 (planejamento) + N (steps).

Algumas ações só aparecem quando feature flags estão habilitadas no ambiente (Advisor V4, Canvas, Decision Assistant). A contagem em availableActions reflete o catálogo efetivo daquele deploy.

Erros

CódigoDescrição
500Erro interno do servidor