Reavalia issues abertas e marca como resolvidas as que a LLM identificar como corrigidas. Diferente do Decision Advisor, não busca novos problemas — apenas reavalia o que já está aberto.

Endpoint

POST /api/externalAPIs/public/advisor/resolveDecisionIssues

Parâmetros

hostId
string
required

ID do host.

avatarId
string

ID do Avatar. Se não informado, busca o Avatar principal automaticamente.

model
string
default: "gpt-oss-120b"

Modelo LLM a ser usado.

provider
string
default: "cerebras"

Provider LLM a ser usado.

maxChars
number
default: "9000"

Quantidade máxima de caracteres para chunks.

completionTimeoutMs
number
default: "120000"

Timeout em milissegundos para a chamada LLM.

modelOptions
object

Opções adicionais repassadas ao payload da LLM. Exemplo: { "reasoning_effort": "low" }.

Exemplo

curl -X POST {{BASE_URL}}/api/externalAPIs/public/advisor/resolveDecisionIssues \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"hostId": "1754b7e6-dbd7-4ca3-a843-7f06fad4e4c0"}'

Resposta

Quando há issues abertas

{
  "resolved": [
    { "issueId": "uuid-da-issue", "comment": "Explicação do que mudou na configuração" }
  ],
  "stillOpen": [
    { "issueId": "uuid-da-issue", "comment": "Explicação de onde ainda persiste o problema" }
  ],
  "notMentioned": [
    { "issueId": "uuid-da-issue" }
  ],
  "summary": "Resumo objetivo da reavaliação",
  "metadata": {
    "hostId": "1754b7e6-dbd7-4ca3-a843-7f06fad4e4c0",
    "avatarId": "984c2dee-4f81-4fdf-b299-88baa0be86df",
    "avatarName": "Nome do avatar",
    "totalIssuesEvaluated": 5,
    "resolvedCount": 2,
    "stillOpenCount": 2,
    "notMentionedCount": 1,
    "analysisDate": "2024-01-15T10:30:00.000Z"
  }
}

Quando não há issues abertas

{
  "skipped": true,
  "reason": "no_open_issues",
  "message": "Nenhuma issue aberta para reavaliar."
}

Campos da Resposta

resolved
array

Issues marcadas como resolvidas no banco.

stillOpen
array

Issues que a LLM confirmou que ainda existem.

notMentioned
array

Issues que a LLM não avaliou. Não são modificadas.

summary
string

Resumo objetivo da reavaliação.

metadata
object

Informações sobre o escopo da análise.

skipped
boolean

Presente apenas quando não há issues abertas. Indica retorno antecipado sem chamar a LLM.

Issues em notMentioned não são modificadas. A LLM só marca como resolvida quando a decisão é explícita.

Erros

CódigoDescrição
400Campos obrigatórios ausentes ou inválidos
401Token inválido ou ausente
404Host ou avatar não encontrado
500Erro interno do servidor