Decision Advisor
Analisa os parâmetros de treinamento do Orchestrator e/ou Smart Tags, identificando problemas e retornando recomendações
Você pode testar esta rota diretamente em nossa documentação interativa.
Permite executar módulos de forma seletiva para reduzir o tempo de análise.
Módulos Disponíveis
| Módulo | O que analisa |
|---|---|
decision | Decision chains: contradições, conflitos, ambiguidades, lacunas e problemas de configuração |
smartTags | Smart tags: sobreposições semânticas, redundâncias e critérios de ativação ambíguos |
Se modules não for informado, ambos os módulos são executados em sequência (primeiro decision, depois smartTags).
Com múltiplos módulos, decision sempre roda antes de smartTags.
Endpoint
POST /api/externalAPIs/public/advisor/decisionAdvisor
Parâmetros
ID do host.
Módulos a executar. Valores válidos: "decision", "smartTags". Padrão: ambos.
ID do Avatar (usado pelo módulo decision). Se não informado, busca o Avatar principal automaticamente.
Modelo LLM a ser usado.
Provider LLM a ser usado.
Exemplos
curl -X POST {{BASE_URL}}/api/externalAPIs/public/advisor/decisionAdvisor \
-H "Authorization: Bearer {TOKEN}" \
-H "Content-Type: application/json" \
-d '{"hostId": "1754b7e6-dbd7-4ca3-a843-7f06fad4e4c0"}'
Resposta
A resposta sempre agrupa os resultados por módulo. Apenas os módulos solicitados aparecem no objeto retornado.
{
"decision": {
"issues": [
{
"snippet": "Trecho exato do parâmetro problemático",
"problemDescription": "Descrição do problema identificado",
"recommendation": "Recomendação de melhoria",
"decisionChainId": "uuid-da-chain",
"decisionChainName": "Nome da chain",
"problematicAgents": [{ "agentName": "agent1", "schemaName": "schema1", "agentId": "uuid-do-agent", "frontName": "Nome Front do Agent" }]
}
],
"summary": "Resumo geral dos problemas encontrados nas decision chains",
"issueUpdates": [],
"metadata": {
"hostId": "1754b7e6-dbd7-4ca3-a843-7f06fad4e4c0",
"avatarId": "984c2dee-4f81-4fdf-b299-88baa0be86df",
"avatarName": "Nome do avatar",
"totalDecisionChains": 5,
"activeDecisionChains": 4,
"totalAgents": 12,
"analysisDate": "2024-01-15T10:30:00.000Z"
}
},
"smartTags": {
"issues": [
{
"snippet": "Trecho da smart tag problemática",
"problemDescription": "Descrição do problema identificado",
"recommendation": "Recomendação de melhoria",
"smartTagId": "uuid-da-tag",
"smartTagName": "Nome da tag"
}
],
"summary": "Resumo geral dos problemas encontrados nas smart tags",
"issueUpdates": [],
"metadata": {
"hostId": "1754b7e6-dbd7-4ca3-a843-7f06fad4e4c0",
"totalUserTags": 8,
"totalAgentTags": 3,
"analysisDate": "2024-01-15T10:30:00.000Z"
}
}
}
Campos da Resposta
Módulo decision
Lista de problemas identificados nas decision chains.
Resumo geral dos problemas encontrados.
Atualizações de issues existentes.
Informações sobre o escopo da análise.
Módulo smartTags
Lista de problemas identificados nas smart tags.
Informações sobre o escopo da análise.
Erros
| Código | Descrição |
|---|---|
400 | Campos obrigatórios ausentes ou inválidos |
401 | Token inválido ou ausente |
404 | Host ou avatar não encontrado |
500 | Erro interno do servidor |