> ## Documentation Index > Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt > Use this file to discover all available pages before exploring further. # Guia Geral para Construir com IA > Configure instruções, modelos, temperatura, bases de conhecimento, MCPs e ferramentas para seus Agentes de IA ## 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](/pt/guias/agentes-ia/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.