Insight por Demanda
Retorna sugestões detalhadas de alteração para issues específicas de chunks, além de listar outras issues não endereçadas do mesmo host
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
Array de IDs das issues do tipo "chunk" a analisar.
ID do host.
Modelo LLM a ser usado.
Provider LLM a ser usado.
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
Issues selecionadas para análise.
Sugestões detalhadas de alteração para as issues selecionadas.
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ódigo | Descrição |
|---|---|
400 | Campos obrigatórios ausentes ou inválidos |
401 | Token inválido ou ausente |
404 | Uma ou mais issues não encontradas |
500 | Erro interno do servidor |