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 |
Escrita do critério (campo Quando): Como escrever o Quando da Smart Tag.
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 |