Repository navigation
Agent API: Ativar Inferência com Token de Sistema e Acesso Direto à API - v2
O que é a Agent API com Token de Sistema e seus benefícios?
A StackSpot agora oferece uma versão expandida da Agent API que coloca você no controle total de suas interações com agentes. Esta atualização permite que você personalize completamente cada execução da API, selecionando as fontes de conhecimento específicas, ativando modo conversacional, controlando a pesquisa aprofundada e obtendo transparência total sobre os conhecimentos utilizados.
Com essa implementação, você ganha:
- Seleção granular de Knowledge Sources (KSs): Escolha exatamente quais fontes de conhecimento deseja utilizar em cada execução, inclusive project indexing KS
- Modo conversacional persistente: Ative conversas contínuas com um conversationID que persiste entre requisições, mantendo contexto e histórico
- Controle sobre Deep Knowledge Search: Ative ou desative a pesquisa aprofundada conforme necessário para otimizar velocidade e precisão
- Transparência completa: Receba todos os Knowledge Objects (KOs) utilizados na resposta quando solicitado
- Maior flexibilidade: Configure cada aspecto da execução via parâmetros simples na API
- Experiência aprimorada: Tenha acesso às mesmas features poderosas do produto em suas integrações via API
Novas capacidades
Modo Conversacional com Histórico Persistente
O sistema agora suporta conversas contínuas:
- ConversationID gerado automaticamente: Na primeira execução com modo conversacional ativado, um ID único é gerado
- Contexto mantido: Use o mesmo conversationID em múltiplas requisições para manter histórico e contexto
- Ativar/Desativar: Controle total para ativar ou desativar o modo conversacional conforme necessário
- Histórico acessível: O sistema mantém registro de toda a conversa para referência futura
Deep Knowledge Search (DeepKS)
Controle a profundidade da busca de conhecimento:
- Ativar/Desativar via flag: Escolha se deseja uma busca aprofundada ou busca padrão
- Otimização de performance: Desative para respostas mais rápidas quando não necessário
- Precisão aumentada: Ative para análises mais completas e contextualizadas
Retorno de Knowledge Objects (KOs)
Obtenha transparência total sobre as fontes utilizadas:
- Flag "Return KSs" ativada: Todos os KOs utilizados na resposta são retornados automaticamente
- Rastreabilidade completa: Saiba exatamente quais conhecimentos fundamentaram a resposta
- Formato estruturado: KOs retornados em formato claro e compreensível
- Auditoria facilitada: Mantenha registro de quais fontes foram consultadas