Pular para o conteúdo principal

​
Instrução

A instrução define o comportamento base do agente: qual papel ele adota, qual tom utiliza e quais passos segue antes de responder. Certifique-se de que seja breve, concreta e sem ambiguidades. Se precisar aprofundar a escrita de instruções, consulte o guia de boas práticas em @prompting.mdx. Ver recomendações e exemplos de prompting

​
Modelo

Escolha o modelo que melhor se adapta ao tipo de interação desejada. Considere latência, custo e complexidade da tarefa antes de selecionar um.

​
Modelos disponíveis

  • Llama 4 Scout: um modelo ágil e de baixa latência, ideal para ideias rápidas e interações leves.
  • GPT 4.1 Mini: uma variante simplificada do GPT-4.1 otimizada para respostas rápidas com menor demanda de recursos.
  • Claude 3.5 Sonnet: excelente para tarefas complexas que exigem textos mais elaborados e contextos extensos.
  • GPT 4-o (Azure): uma versão do GPT 4-o hospedada no Azure, focada em estabilidade e desempenho em ambientes corporativos.
  • Llama 4 Maverick: um modelo de alto desempenho projetado para raciocínio exigente e resolução de problemas em múltiplas etapas.
  • GPT 4.1: uma evolução refinada do GPT-4, com melhor compreensão, raciocínio e precisão.
  • GPT 4-o Mini: uma versão mais rápida e leve do GPT 4-o, orientada para casos em que a velocidade é prioridade.

​
Temperatura

A temperatura controla o nível de criatividade do modelo. Use valores entre 0 e 1: em 0 você obterá respostas determinísticas e consistentes; conforme se aproxima de 1, as respostas serão mais criativas e variadas. Ajuste esse parâmetro dependendo se você precisa de precisão ou exploração.

​
Bases de Conhecimento

Reforce o agente com documentação específica para que ele responda com informações atualizadas e verificáveis.
  • Arquivos: faça upload de arquivos de até 2 MB nos formatos .pdf ou .csv.
  • URLs: adicione links cujo download não ultrapasse 5 MB. Verifique se o conteúdo é publicamente acessível.

​
MCPs

Conecte Model Context Protocols (MCPs) para expandir as capacidades do agente. Cada integração requer:
  • URL do endpoint para onde a consulta será enviada.
  • Cabeçalhos opcionais com credenciais ou metadados necessários para autenticação.
  • Nome identificador para reconhecer o MCP dentro do studio.
  • Descrição que resume quais informações ou ações ele fornece.

​
Ferramentas

As ferramentas permitem que o agente execute ações externas. Você pode configurá-las de duas formas:
  • Ferramentas criadas na plataforma: defina-as diretamente no Brain Studio para integrações reutilizáveis e gerenciadas.
  • Chamadas HTTP: especifique um endpoint, método e esquema de entrada/saída para fazer requisições pontuais aos seus serviços.
Combine esses elementos para que o agente selecione automaticamente a ferramenta adequada durante a conversa.

​
Configuração Avançada

Na aba de configuração avançada do nó de Agente de IA, você encontrará opções adicionais que expandem as capacidades do agente para processar diferentes tipos de conteúdo e mensagens interativas.

​
Suporte à leitura de payload em mensagens recebidas

Ative esta opção para permitir que o Agente de IA processe payloads de resposta rápida de mensagens interativas. Quando ativado, o agente pode interpretar e responder às ações do usuário em botões de resposta rápida, melhorando a experiência em fluxos conversacionais que utilizam elementos interativos. Quando ativar:
  • Quando seu fluxo inclui mensagens com botões de resposta rápida.
  • Se precisar que o agente processe as informações enviadas por meio de payloads em vez do texto visível do botão.
  • Para fluxos que precisam capturar dados estruturados de interações com botões.

​
Suporte a documentos PDF

Ative esta configuração para que o Agente de IA possa ler e processar documentos PDF enviados pelos usuários durante a conversa. O agente extrairá o conteúdo do documento e poderá responder perguntas ou executar ações com base nas informações que ele contém. Observação importante: Esta funcionalidade processa apenas o texto do PDF. Imagens contidas no documento não serão processadas nem analisadas pelo agente. Quando ativar:
  • Quando você espera que os usuários enviem documentos PDF como parte da interação.
  • Se precisar que o agente analise, resuma ou extraia informações de arquivos PDF.
  • Para casos de uso como validação de documentos, extração de dados ou análise de conteúdo.

​
Ler imagem com URL e legenda

Esta configuração permite que o Agente de IA processe imagens que incluam uma legenda. O agente poderá acessar tanto a imagem quanto o texto descritivo associado, processando ambos os elementos juntos. Quando ativar:
  • Quando os usuários enviam imagens com descrições de texto.
  • Se precisar que o agente processe tanto o conteúdo visual quanto o contexto textual da imagem.
  • Para fluxos que requerem análise combinada de imagem e texto.

​
Boas Práticas

  • É recomendável sempre ativar a seção de Base de Conhecimento para ancorar as respostas do agente à documentação oficial do seu negócio ou à documentação básica necessária para o prompt. Isso reduz drasticamente o risco de alucinações, pois o modelo priorizará as informações dos seus arquivos sobre seu conhecimento geral. Para maximizar sua eficácia, atribua descrições claras a cada arquivo enviado, permitindo que o agente saiba exatamente quando deve buscar informações neles.