Você pode testar esta rota diretamente em nossa documentação interativa.

Use após o Chunk Advisor identificar problemas (nota menor que 5) e criar issues.

Endpoint

POST /api/externalAPIs/public/advisor/insightByDemand

Parâmetros

issueIds
array
required

Array de IDs das issues do tipo "chunk" a analisar.

hostId
string
required

ID do host.

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

Modelo LLM a ser usado.

provider
string
default: "cerebras"

Provider LLM a ser usado.

completionTimeoutMs
number
default: "60000"

Timeout em milissegundos para a chamada LLM.

Exemplo

curl -X POST {{BASE_URL}}/api/externalAPIs/public/advisor/insightByDemand \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "issueIds": [
      "bf047297-ff98-4b4d-b6b7-07f8f50ca36c",
      "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    ],
    "hostId": "b302f8ad-991b-411c-beb3-12cd648c95cc"
  }'

Resposta

{
  "selectedIssues": [
    {
      "id": "bf047297-ff98-4b4d-b6b7-07f8f50ca36c",
      "snippet": "Trecho do chunk que contém o problema identificado...",
      "problemDescription": "Descrição detalhada do problema identificado",
      "recommendation": "Recomendação geral para resolver o problema",
      "score": 4,
      "chunkId": "chunk-uuid",
      "createdAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "suggestions": [
    {
      "issueId": "bf047297-ff98-4b4d-b6b7-07f8f50ca36c",
      "suggestedChange": "Sugestão detalhada de alteração específica no conteúdo do chunk",
      "reasoning": "Explicação do porquê esta alteração resolve o problema identificado",
      "priority": "high",
      "estimatedImpact": "Descrição do impacto esperado da alteração"
    }
  ],
  "otherIssues": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "snippet": "Trecho de outro chunk com problema...",
      "problemDescription": "Descrição de outro problema",
      "score": 3.5,
      "chunkId": "outro-chunk-uuid",
      "createdAt": "2024-01-15T09:15:00.000Z"
    }
  ]
}

Campos da Resposta

selectedIssues
array

Issues selecionadas para análise.

suggestions
array

Sugestões detalhadas de alteração para as issues selecionadas.

otherIssues
array

Outras issues não resolvidas do mesmo host, não selecionadas. Estrutura idêntica a selectedIssues.

Apenas issues do tipo "chunk" podem ser analisadas por este endpoint.

Erros

CódigoDescrição
400Campos obrigatórios ausentes ou inválidos
401Token inválido ou ausente
404Uma ou mais issues não encontradas
500Erro interno do servidor