Principal Central IA
🧙‍♂️

Central IA

Christopher
Por Christopher
7 artigos

Assistentes

A sua Vitrine de Talentos Virtuais (Agentes de IA) Para gerenciar o seu time de inteligências artificiais e visualizar quem já está trabalhando na sua operação, siga este caminho: Acessando o menu: No painel lateral esquerdo, clique em Central IA e depois em Agentes de IA (conforme indicado pelas setas vermelhas). Nesta tela, você verá todos os seus assistentes de IA disponíveis. A Vitrine da sua IA: A área central da tela (destacada pelo grande quadro vermelho) exibe a listagem completa de todos os seus agentes já criados. - Cada bloco (card) representa um robô diferente, mostrando o seu nome e as instruções básicas que ele segue no dia a dia. Contratando um novo agente: Se precisar de um robô novo para uma função específica, basta clicar no botão azul + Criar um novo assistente, localizado no canto superior direito da sua tela. Gerenciando os seus Agentes (Opções Rápidas) Você tem acesso a um menu rápido de gestão para cada inteligência criada, sem precisar abrir todas as configurações dela: O Menu Oculto: Olhe para o canto superior direito do card do seu assistente (no exemplo da imagem, o card da IA DE SUPORTE). Você notará um pequeno ícone com três pontinhos verticais (indicado pela seta vermelha). Opções de Gestão: Ao clicar nestes três pontinhos, um pequeno menu suspenso (destacado pelo quadro vermelho) se abrirá com as seguintes ações: - Ver canais conectados: Uma das funções mais importantes! É aqui que você confere em quais canais (ex: número de WhatsApp do Suporte, Instagram, Webchat) este robô específico está "trabalhando". Lembre-se: um robô sem um canal conectado não consegue receber nem enviar mensagens aos clientes! - Mover para pasta: Excelente para manter a organização quando a sua operação crescer e você tiver dezenas de assistentes. Permite agrupar os robôs por categoria (ex: criar uma pasta só para "Robôs de Vendas" e outra para "Robôs de Triagem"). - Excluir Agente de IA: Destacado em letras vermelhas, este botão serve para deletar/demitir o assistente definitivamente do sistema. Muito cuidado ao utilizá-lo! Testando e Editando a sua IA (Atalhos do Card) Ainda na sua vitrine de assistentes, repare no canto inferior direito de cada bloco. Ali ficam dois botões de acesso direto essenciais para a manutenção diária do seu robô: Ações Rápidas (Quadro Vermelho): Olhando para o card da sua inteligência artificial (no exemplo da imagem, a IA DE SUPORTE), você verá dois pequenos ícones destacados: - Ícone de Balão de Chat (Testar Assistente): Este é o seu ambiente idêntico a uma conversa real. Ao clicar nele, uma janela de chat (como mostrado abaixo) se abrirá para você conversar com a IA exatamente como se fosse um cliente. É a ferramenta perfeita para testar se as regras e o tom de voz que você configurou estão funcionando na prática antes de conectar o robô a um número de WhatsApp ou Instagram oficial. - Ícone de Ajustes (Configurações): O botão com o desenho de "barrinhas de controle" é o seu acesso direto ao painel de edição. Ao clicar nele, o sistema abrirá todas as configurações daquele assistente para que você possa afinar as instruções (o prompt), corrigir o comportamento ou adicionar novos superpoderes (automações) à sua IA. Monitorando a Atualização da sua IA (Rodapé do Card) Ainda observando o card do seu assistente na vitrine, vamos olhar para o rodapé por completo: Tempo de Última Edição (Quadro Vermelho): No canto inferior esquerdo do bloco da IA (logo antes dos botões de testar e configurar que vimos no passo anterior), você verá um pequeno indicador de tempo, como no exemplo: há 2 dias, há 10 dias ou há cerca de 2 meses. - Por que isso é útil: Esse pequeno texto mostra exatamente a última vez que alguém da sua equipe abriu as configurações desse robô e salvou alguma alteração. É o recurso ideal para o gestor bater o olho e saber rapidamente se o prompt (as regras) daquela IA está atualizado com as novidades da empresa ou se já faz muito tempo que o robô não passa por uma revisão. 📘 O teste por chat (Playground) consome créditos de IA reais da conta e reflete exatamente o comportamento em produção. Menu do agente No menu ⋮ de cada card: Iniciar Chat, Editar, Ver canais conectados, Mover para pasta, Ver logs de atividade, Ver auditoria de execução, Duplicar, Transferir para outra conta e Excluir.

Última atualização em Aug 16, 2026

Documentos

Alimentando o Cérebro do Robô (Aba Documentos) Um assistente de IA só é bom se ele tiver boas informações para consultar. Para ensinar tudo sobre os seus produtos, serviços e regras ao seu robô, você usará a base de conhecimento: Acessando a Biblioteca: No painel lateral esquerdo, logo abaixo de Assistentes, clique na aba Documentos (conforme indicado pelas setas vermelhas). A Base de Conhecimento (Quadro Vermelho): A área central da sua tela passará a exibir a lista completa de todos os materiais (textos, links e arquivos) que os seus robôs já leram e aprenderam. Anatomia da Lista: Cada linha dessa vitrine representa um documento diferente. Nela, você bate o olho e já identifica: - O Título do material (ex: Como Importar Contatos | Central de Ajuda). - A qual Assistente aquele documento pertence (indicado pela tag rosa, como teste). - A Origem da informação (seja um texto colado ou um link de um site). - A Data da última atualização (no canto direito). Ensinando coisas novas: Quando a sua empresa lançar um produto novo ou mudar uma regra, basta olhar para o canto superior direito da tela e clicar no botão azul + Criar um novo documento. É por ali que você envia o material novo para a IA estudar. Gerenciando a sua Base de Conhecimento (Opções do Documento) Depois que um arquivo ou link é adicionado à sua biblioteca, você mantém controle total sobre ele. Para gerenciar um material existente, siga estes passos: O Menu de Opções: Olhe para o extremo direito da linha do documento que você deseja gerenciar (no exemplo da imagem, o arquivo Configure Você Mesmo). Lá você encontrará um pequeno botão com três pontinhos verticais (indicado pela seta vermelha). Ações de Manutenção (Quadro Vermelho): Ao clicar neste botão, um pequeno menu suspenso se abrirá oferecendo duas ferramentas essenciais para a sua gestão: - Visualizar Respostas relacionadas: Uma excelente ferramenta de auditoria. Ao clicar aqui, o sistema mostra como a IA está compreendendo e utilizando esse documento na prática, exibindo as respostas ou tópicos que o robô aprendeu a partir deste texto específico. - Excluir Documento: Destacado em letras vermelhas, este é o botão de limpeza. Se uma política da empresa mudar, um produto sair de linha ou o documento ficar obsoleto, clique aqui para apagá-lo. A IA "esquecerá" aquela informação, garantindo que o seu cliente não receba dados desatualizados no atendimento. Monitorando a Atualização da Base (Idade do Documento) Ainda na tela de listagem dos seus Documentos, existe um indicador visual muito importante para ajudar o gestor a manter as informações do robô sempre "frescas": Indicador de Tempo (Quadro Vermelho): Olhe para o extremo direito da linha de qualquer documento cadastrado, logo abaixo do botão de opções (três pontinhos). Você verá um pequeno texto informando o tempo decorrido (no exemplo da imagem: há cerca de 2 meses). Por que isso é estratégico: Esse "carimbo" mostra exatamente quando aquele material foi adicionado ou atualizado pela última vez na base de conhecimento. - 💡 Dica de Auditoria: Crie o hábito de bater o olho nessa coluna periodicamente. Se você notar que um documento crítico (como tabelas de preços, manuais de garantia ou regras de negócio) está com uma data muito antiga, é um forte sinal de que pode ser a hora de revisá-lo e atualizá-lo. Isso garante que a sua Inteligência Artificial nunca passe dados defasados para o cliente.

Última atualização em Apr 06, 2026

Agente de IA: guia completo de criação e configuração

Os Agentes de IA do SimplesDesk atendem seus clientes de ponta a ponta: respondem com base no conhecimento da sua empresa, seguem o tom de voz da sua marca, executam ações (consultar pedidos, agendar, atualizar cadastro) e transferem para um atendente humano na hora certa. Este guia mostra o caminho completo — da criação à ativação — com dicas práticas em cada etapa. Antes de começar Separe três coisas — elas definem 80% da qualidade do agente: 📘 Materiais que valem ouro: páginas do seu site (FAQ, políticas, preços), manuais em PDF e as respostas que sua equipe mais repete no dia a dia. Tudo isso vira base de conhecimento. 1. Escopo: o que o agente DEVE resolver (ex.: dúvidas de produto, status de pedido) e o que ele NÃO deve tentar (ex.: negociação de dívida → humano). 2. Tom de voz: como sua marca fala — formal, próxima, técnica? 3. Canal piloto: escolha um canal para começar (ex.: o WhatsApp de suporte). Expandir depois é um clique. Criando o agente — os 8 passos Acesse Central IA > Agentes de IA e clique em Criar um novo agente. O assistente de criação é dividido em 8 passos (abas numeradas no topo) e mostra uma pré-visualização ao vivo de como o agente vai soar. Tudo é salvo automaticamente como rascunho: se fechar a janela, ao voltar você pode Continuar de onde parou. Tela Agentes de IA com o botão Criar um novo agente 1. Identidade Defina nome, função (o papel do agente: vendedor, suporte, recepcionista...) e a primeira frase — a mensagem de abertura que o cliente recebe. A plataforma pode gerar as instruções automaticamente a partir do contexto que você descrever; revise o texto gerado e ajuste o que for específico do seu negócio. Passo 1 — Identidade: nome, função, idioma e primeira frase ✅ Dica: na primeira frase, deixe claro que é um assistente virtual e o que ele sabe resolver. Isso reduz frustração e pedidos imediatos de "falar com humano". 2. Personalidade Escolha o tom em cartões com exemplos reais de resposta, defina o uso de emojis (nunca / espelhar o cliente / sempre) e cadastre palavras proibidas — termos que o agente jamais deve usar. Os comportamentos afinam a postura: confirmar antes de executar ações, manter-se no assunto, evitar repetição. Passo 2 — Personalidade: tom de voz, emojis e palavras proibidas 3. Modelo e limites Aqui você escolhe o modelo de IA e os limites de resposta: - Mantenha o modelo padrão (GPT-4.1 mini) a menos que tenha um motivo forte: ele resolve a grande maioria dos atendimentos e é o que consome menos créditos de IA (multiplicador 1×). Modelos maiores consomem 5× a 7× mais por resposta. - Temperatura: quanto menor, mais previsível; quanto maior, mais criativo. Para atendimento, valores baixos/médios funcionam melhor. - Máximo de tokens por resposta: limita o tamanho das respostas — bom para manter mensagens objetivas no WhatsApp e controlar custo. Passo 3 — Modelo e limites: modelo principal, plano B e sliders 4. Base de conhecimento Adicione sites (as páginas viram documentos automaticamente) e documentos (PDF, DOCX, planilhas). É daqui que o agente tira as respostas sobre o SEU negócio. 📘 Qualidade > quantidade: documentos objetivos e atualizados rendem respostas melhores do que dezenas de arquivos genéricos. Remova versões antigas de tabelas de preço e políticas — o agente não sabe qual vale. Passo 4 — Base de conhecimento: sites e comportamento sem resposta 5. Respostas prontas Cadastre pares gatilho → resposta para as perguntas mais críticas e frequentes (horário de funcionamento, formas de pagamento, política de troca). Quando o assunto bate com o gatilho, o agente usa a resposta pronta como referência — padronização total no que não pode variar. Passo 5 — Respostas prontas 6. Regras O passo mais importante para o comportamento no dia a dia: - Follow-up: o agente retoma contato com quem parou de responder (com limite de tentativas e janela de horário). - Horário de funcionamento: quando o agente atua. - Validação de contato: exigir CPF/CNPJ ou outro dado antes de prosseguir. - Manter no assunto: impede que o agente converse sobre temas fora do escopo. - Tempo de inatividade e desistir após N tentativas: quando encerrar ou transferir. Passo 6 — Regras: follow-up, horário, CPF/CNPJ, assunto e desistência 7. Roteamento Crie regras por intenção: se o cliente demonstra interesse X, a conversa vai para outro agente de IA, um time ou um atendente específico. É assim que você monta uma "recepção inteligente" que distribui para especialistas. Passo 7 — Roteamento por assunto 8. Ativar Revise o resumo e ative. Você é levado direto para a página de edição do agente. Passo 8 — Ativar: resumo final e botão Ativar agente Depois de criar: a página de edição A edição organiza tudo em 6 grupos: Perfil, Conhecimento, Instruções & Modelo, Ações & Integrações, Regras & Transferência e Acesso & Canais. Use a busca de configuração (aceita busca sem acento) para pular direto a qualquer seção. No topo, o medidor "% pronto" analisa a configuração e mostra uma dica por vez do que falta — clique na dica para ir direto à seção. Verde = pronto para produção. Página de edição: 6 grupos, medidor % pronto e Playground Conectar aos canais Em Acesso & Canais, escolha em quais canais o agente atende. Comece pelo canal piloto; com o comportamento validado, adicione os demais. Transferência para humanos Em Regras & Transferência, configure a mensagem de transferência e a detecção de pedido de humano. Um bom agente sabe a hora de sair de cena — transferir bem vale mais do que insistir. Teste antes de ativar nos canais Use o Playground do agente para conversar com ele como se fosse um cliente. ⚠️ Atenção: o Playground é uma conversa REAL — consome créditos de IA e executa as ações configuradas. Teste com objetividade: valide a primeira frase, 3-4 perguntas típicas, uma pergunta fora do escopo e um pedido de atendente humano. Checklist final - [ ] Instruções revisadas (não apenas o texto gerado) - [ ] Base de conhecimento com documentos atualizados - [ ] Respostas prontas para as 5 perguntas mais frequentes - [ ] Regras de horário, follow-up e transferência configuradas - [ ] Testado no Playground (incluindo pedido de humano) - [ ] Ativado em UM canal piloto Com o agente rodando, o próximo passo é otimizar qualidade e custo — veja o tutorial Como melhorar seu Agente de IA e economizar créditos.

Última atualização em Aug 16, 2026

Como melhorar seu Agente de IA e economizar créditos (cache e boas práticas)

Seu Agente de IA já está no ar? Este guia mostra como melhorar as respostas e, ao mesmo tempo, reduzir o consumo de créditos de IA — incluindo como funciona o cache, o mecanismo que faz a mesma conversa custar até metade. Como a cobrança funciona O consumo de IA é medido em créditos de IA: 1 crédito equivale a 1 milhão de tokens no modelo padrão (GPT-4.1 mini). Modelos mais avançados consomem créditos proporcionalmente ao custo deles: | Modelo | Multiplicador | ≈ Conversas resolvidas por crédito | | --- | --- | --- | | GPT-4.1 mini (padrão) | 1× | ~25 | | Haiku | 2,5× | ~10 | | GPT-4.1 | 5× | ~5 | | Sonnet | 7× | ~3 | 📘 Tradução prática: uma conta que resolve as mesmas conversas no modelo padrão gasta até 7× menos créditos do que no modelo mais avançado. Use modelos maiores apenas onde eles fazem diferença real. Onde acompanhar: o saldo aparece no topo da plataforma (badge de créditos); o detalhamento fica em Central IA > Análises — créditos utilizados, uso ao longo do tempo, consumo por agente e exportação CSV com a coluna de créditos. Recargas ficam no Marketplace, aba Créditos de IA. O que é o cache (e por que ele economiza) A cada resposta, o agente envia ao modelo de IA um "pacote" com duas partes: 1. Parte fixa: instruções, personalidade, regras e ferramentas do agente — igual em toda resposta. 2. Parte variável: a mensagem do cliente, o histórico recente e os trechos da base de conhecimento relevantes àquela pergunta. Quando várias respostas acontecem em uma janela curta de tempo, a parte fixa é reaproveitada pelo provedor de IA (cache) — e o SimplesDesk repassa esse desconto automaticamente: tokens atendidos pelo cache são cobrados pela metade na sua cota de créditos. Em contas com fluxo contínuo de atendimento, o efeito é grande: operações com alto aproveitamento de cache chegam a reduzir o débito de créditos em mais de 40% — sem mudar nada na qualidade. Você não precisa "ligar" o cache — ele é automático. Mas dá para aumentar o aproveitamento: Como aumentar o aproveitamento do cache 1. Não edite o agente em horário de pico Cada alteração nas instruções, personalidade ou regras invalida o cache — a parte fixa muda e precisa ser reprocessada do zero. Agrupe os ajustes e aplique-os fora do horário de movimento (início da manhã, fim do dia). Evite o ciclo "editar → salvar → editar de novo" com o agente atendendo. 2. Mantenha fluxo contínuo no mesmo agente O cache é reaproveitado entre respostas próximas no tempo do mesmo agente. Dez conversas em uma hora aproveitam muito mais cache do que dez conversas espalhadas no dia. Na prática: - Se dois canais têm o mesmo escopo de atendimento, use o mesmo agente nos dois em vez de criar um agente clone para cada canal — o volume somado mantém o cache "quente". - Reserve agentes separados para escopos realmente diferentes (vendas × suporte técnico). 3. Não fique trocando de modelo Cada modelo tem o próprio cache. Trocar o modelo do agente no meio do dia zera o aproveitamento. Escolha o modelo com calma (comece sempre pelo padrão) e mantenha. 4. Instruções completas, base de conhecimento fatiada Aqui há um detalhe que vale dinheiro: a parte fixa (instruções) é a que recebe desconto de cache; a parte variável (trechos da base recuperados por pergunta) é sempre preço cheio. Portanto: - O que é regra permanente do atendimento (políticas, tom, limites, passos) pertence às instruções — texto estável, cacheável. - O que é conteúdo de consulta (tabelas, especificações, catálogo) pertence à base de conhecimento, em documentos objetivos e bem divididos — o agente recupera só o trecho relevante, em vez de arrastar um manual inteiro a cada resposta. ⚠️ Evite colar um catálogo de 50 páginas dentro das instruções: além de piorar as respostas, infla a parte fixa desnecessariamente. Menos idas e vindas = menos tokens Cada troca de mensagens custa créditos. As configurações que melhoram a qualidade também reduzem o custo, porque a conversa termina antes: - Respostas prontas para as perguntas mais frequentes: resposta certa de primeira, sem o agente "raciocinar" à toa. - Base de conhecimento atualizada: documento desatualizado gera resposta errada → cliente contesta → mais mensagens. - Manter no assunto (em Regras): impede conversas improdutivas fora do escopo. - Máximo de tokens por resposta (em Instruções & Modelo): respostas objetivas custam menos e funcionam melhor no WhatsApp. - Desistir após N tentativas + transferência bem configurada: quando o agente não está resolvendo, insistir só queima créditos — transfira para um humano. - Follow-up com limite de tentativas e janela de horário: retomadas automáticas são poderosas, mas configure o teto. Medindo o resultado Em Central IA > Análises você acompanha: - Créditos utilizados no período e o uso ao longo do tempo; - Consumo por agente — identifique qual agente concentra o custo; - Tempo economizado pela IA e conversas resolvidas sem humano; - Exportação CSV detalhada (dia a dia, com créditos e tokens) para análise fina. Revise mensalmente: se um agente consome muito e resolve pouco, o problema quase sempre está em base de conhecimento fraca ou escopo mal definido — não no modelo. Checklist de economia - [ ] Modelo padrão (mini) nos agentes — modelos maiores só onde comprovadamente necessário - [ ] Edições de configuração agrupadas e fora do pico - [ ] Um agente por escopo (não um clone por canal) - [ ] Regras permanentes nas instruções; conteúdo de consulta na base, em documentos fatiados - [ ] Respostas prontas para o top 5 de perguntas - [ ] Limite de tokens por resposta configurado - [ ] Transferência para humano e "desistir após N" configurados - [ ] Análises revisadas mensalmente Ainda não criou seu agente? Comece pelo guia Agente de IA: guia completo de criação e configuração.

Última atualização em Aug 16, 2026

Maestro e Roteamento: orquestre vários Agentes de IA

Quando um único Agente de IA precisa dar conta de vendas, suporte e financeiro ao mesmo tempo, as respostas ficam genéricas. A solução é dividir para conquistar: agentes especializados + um orquestrador que entrega cada conversa ao especialista certo. Neste guia você aprende as três camadas de roteamento do SimplesDesk — do mais simples ao mais poderoso. As 3 camadas de roteamento | Camada | Como decide | Quando usar | | --- | --- | --- | | Roteamento por assunto (criação do agente) | Palavras-chave da mensagem | Casos simples: "boleto" → Financeiro | | Regras de Roteamento (condições) | Canal, etiquetas, prioridade | Regras fixas de operação: canal VIP → agente dedicado | | Maestro (orquestrador) | A IA entende a intenção e delega | Operações com vários especialistas e assuntos que se misturam | As três podem conviver — mas comece pela mais simples que resolve o seu caso. Camada 1 — Roteamento por assunto Ainda no assistente de criação do agente (passo 7, Roteamento), você cadastra assuntos com palavras-chave: quando a mensagem do cliente contém aquelas palavras, a conversa é encaminhada ao destino configurado. Passo Roteamento do assistente de criação 📘 É a forma mais direta de separar temas óbvios ("boleto", "nota fiscal" → Financeiro). O limite: palavras-chave não entendem contexto — "não recebi o boleto" e "quero cancelar o boleto" caem no mesmo balde. Camada 2 — Regras de Roteamento (condições objetivas) Na página de edição do agente, grupo Regras & Transferência, abra a seção Regras de Roteamento: Seções do grupo Regras & Transferência Cada regra define condições e um assistente de destino. As regras são avaliadas em ordem de prioridade (menor número = avaliada primeiro) e a primeira que corresponder vence: - Canais: a conversa chegou por um canal específico? (selecione na lista) - Labels do contato e Labels da conversa: o contato/conversa tem determinada etiqueta? (ex.: vip, premium) - Prioridade: desempate entre regras. Formulário de uma Regra de Roteamento ✅ Exemplo clássico: regra "Suporte VIP" — label do contato vip → assistente "Agente VIP", prioridade 0. Todo cliente VIP cai direto no agente premium, sem depender de interpretação da IA. Camada 3 — Maestro (Orquestrador Multi-Agente) O Maestro é um agente especial que coordena outros agentes: ele lê a mensagem, entende a intenção e delega para o sub-assistente especializado — com contexto, mensagem a mensagem. É a camada mais inteligente e flexível. Na edição do agente, grupo Regras & Transferência, seção Orquestrador Multi-Agente (Maestro), marque Habilitar Orquestrador Maestro. Na primeira vez, um guia de boas-vindas resume o fluxo em 4 passos: Boas-vindas do Maestro: configuração em 4 passos Configurando na prática Configuração do Maestro: modo estrito, sub-assistente e regras determinísticas 1. Crie os agentes especializados primeiro (ex.: Vendas, Suporte, Financeiro), cada um com suas instruções e base de conhecimento próprias. 2. Adicione cada um como sub-assistente: selecione o agente, dê um nome (ex.: "Especialista em Vendas") e — o campo mais importante — preencha "Quando usar este sub-assistente" (ex.: "Use quando o cliente perguntar sobre preços, planos ou quiser contratar"). 3. Ative o Modo Orquestrador Estrito (recomendado): com ele, o Maestro nunca responde diretamente — a única função dele é identificar o especialista correto e delegar. Ideal para o agente "recepcionista". 4. Regras de Roteamento Determinístico (opcional): pares campo → valor comparados com os dados da conversa. Se todas as regras de um sub-assistente corresponderem, ele é selecionado automaticamente, sem consultar a IA (ex.: campo tipo_servico = orcamento → Especialista em Orçamentos). Use quando você já tem a informação estruturada e não quer gastar uma decisão da IA com isso. 5. Salve (Atualizar) e teste no Playground com frases reais de cada área — inclusive ambíguas — para conferir se a delegação está indo para o lugar certo. ⚠️ A dica que mais muda o resultado: quanto mais específicas forem as instruções de "Quando usar" de cada sub-assistente, mais preciso é o roteamento. Escreva com exemplos ("perguntas sobre preço, formas de pagamento, contratação") e evite escopos que se sobrepõem — dois sub-assistentes com descrições parecidas confundem o orquestrador. Qual camada escolher? - A informação já está estruturada (canal, etiqueta, campo preenchido)? → Regras de Roteamento ou roteamento determinístico — decisão instantânea, sem custo de IA. - A decisão depende de entender o que o cliente escreveu? → Maestro. - Só precisa separar meia dúzia de temas óbvios por palavra? → Roteamento por assunto resolve. Ainda não criou seus agentes? Comece pelo guia completo de criação e configuração.

Última atualização em Aug 16, 2026

Servidores MCP: conecte ferramentas externas ao seu Agente de IA

Os Agentes de IA do SimplesDesk já vêm com ferramentas nativas — consulta à base de conhecimento, busca na web, leitura de páginas, busca de contatos, chamadas HTTP. Quando você precisa ir além, entra o MCP (Model Context Protocol): um protocolo aberto que conecta servidores de ferramentas externos ao seu agente. É assim que o agente ganha superpoderes específicos do seu negócio — consultar um sistema interno, buscar documentação técnica, interagir com serviços de terceiros. 📘 Recurso avançado: configurar um servidor MCP envolve comandos e credenciais. Se a sua necessidade é só consultar uma API REST (buscar um pedido no ERP, por exemplo), veja antes as Ferramentas HTTP, na mesma tela — mais simples e resolve a maioria dos casos. Onde configurar Na edição do agente, abra o grupo Ações & Integrações. Ali ficam as ferramentas nativas, as Ferramentas HTTP e a seção Servidores MCP: Grupo Ações & Integrações: ferramentas nativas, HTTP e Servidores MCP Clique em Adicionar Servidor e preencha: Formulário de servidor MCP - Nome: identificação do servidor (ex.: context7). - Comando: o executável que inicia o servidor (ex.: uvx, npx). - Argumentos: um por linha (ex.: context7-mcp). - Variáveis de ambiente: uma por linha no formato CHAVE=valor — é aqui que entram tokens e credenciais que o servidor precisa (ex.: GITHUB_TOKEN=ghp_xxx). - Ativo: liga/desliga o servidor sem removê-lo. Clique em Salvar. Pronto: as ferramentas expostas pelo servidor passam a fazer parte do arsenal do agente. Como funciona por baixo do capô 1. Ao gerar uma resposta, o agente enxerga a lista de ferramentas que o servidor MCP oferece (cada servidor descreve as próprias ferramentas automaticamente — você não precisa cadastrá-las uma a uma). 2. Quando a conversa pede (ex.: "qual o status do meu chamado?"), o agente decide chamar a ferramenta, envia os parâmetros, e o servidor executa. 3. O resultado volta para o agente, que o usa para compor a resposta ao cliente — tudo dentro da mesma mensagem. Cada chamada de ferramenta tem tempo limite de execução; se o servidor não responder, o agente segue sem a ferramenta (e o erro fica registrado nos logs do agente). Cuidados importantes ⚠️ Use apenas servidores MCP confiáveis. O comando configurado é executado pela plataforma com as credenciais que você fornecer nas variáveis de ambiente. Um servidor malicioso teria acesso a esses tokens. Prefira servidores oficiais/auditados e conceda credenciais com o menor privilégio possível. - Servidores por URL ainda não são suportados — apenas servidores executados por comando (stdio). - Cada ferramenta adicionada consome tokens na conversa (a descrição das ferramentas acompanha toda resposta do agente). Mantenha ativos apenas os servidores que o agente realmente usa — menos ferramentas = respostas mais baratas e decisões mais precisas. - Teste no Playground após configurar: peça algo que exija a ferramenta e confirme que o agente a aciona corretamente. Lembre que o Playground consome créditos de IA reais. Checklist - [ ] Necessidade não se resolve com ferramentas nativas ou Ferramentas HTTP - [ ] Servidor MCP de fonte confiável - [ ] Credenciais com menor privilégio nas variáveis de ambiente - [ ] Testado no Playground - [ ] Servidores não utilizados desativados Para a configuração completa do agente, veja o guia de criação e configuração.

Última atualização em Aug 16, 2026