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": 15,
      "defaultStepTimeoutMs": 30000,
      "planningModel": "gpt-5.2",
      "executionModel": "gpt-4.1-mini",
      "costModel": {
        "planningLlmCalls": 1,
        "executionLlmCallsPerStep": 1,
        "estimatedTotalLlmCallsFormula": "1 + stepCount"
      }
    }
  }
}

Campos da Resposta

data
object

Consulte este endpoint para entender quais ações estão disponíveis, como formular instruções eficazes e para estimar o custo antes de executar. O costControl global permite calcular o total esperado de chamadas LLM: 1 (planejamento) + N (steps).

Erros

CódigoDescrição
500Erro interno do servidor