Pular para o conteúdo principal

Seu primeiro agente

Este tutorial leva você do zero a uma primeira conversa com o agente. Você vai criar um especialista, testá-lo no chat web e, se quiser, colocá-lo para atender no WhatsApp — ou por voz e Telegram.

Pré-requisitos​

  • Uma conta ativa na plataforma.
  • Seu agente já vem com o modelo padrão configurado; você só precisa definir as instruções.

Passo 1 — Criar o especialista​

O especialista é a configuração do seu agente. No painel, clique em Criar especialista.

Preencha:

  • ID: um identificador único, como meu-primeiro-agente

  • Versão: "1.0.0"

  • Prompt: as instruções do agente. Exemplo:

    Você é um assistente prestativo. Responda em português, de forma clara e
    objetiva. Se não souber algo, diga que não sabe.

Os campos obrigatórios restantes (modelo, teto de custo) já vêm pré-preenchidos com valores seguros. O formulário monta o YAML do especialista para você.

Clique em Salvar. Seu primeiro especialista está criado.

Passo 2 — Testar no chat web​

No próprio painel, vá para a tela de chat. Selecione o especialista que você acabou de criar (pelo ID) e digite uma mensagem:

"Olá! Qual é o seu nome?"

O agente deve responder de acordo com as instruções que você definiu.

Passo 3 — Adicionar uma ferramenta (opcional)​

Vamos adicionar busca na web ao agente. Primeiro, conecte uma fonte de ferramentas:

  1. No painel, abra a lista de fontes de ferramentas e clique em Adicionar servidor.
  2. Preencha:
    • Nome: tavily
    • URL: https://mcp.tavily.com
    • Autenticação: escolha "Sua própria chave" e cole sua chave de API do Tavily.
  3. Salve.

Agora edite o especialista que você criou e adicione no campo Tools:

tavily.tavily_search
tavily.tavily_extract

Atualize o prompt para orientar quando usar a ferramenta:

Você é um assistente de pesquisa. Quando a pergunta exigir informação
atual, use `tavily_search` para buscar na web. Sempre cite as fontes.

Salve e teste de novo no chat:

"Qual é a capital do Brasil?"

Passo 4 — Conectar um canal (opcional)​

WhatsApp​

É o canal onde o seu cliente já está — e o mais rápido de ligar: dá para usar o próprio número que a sua equipe já tem, sem conta na Meta e sem configuração técnica.

  1. No painel, vá em Canais → WhatsApp.
  2. Em Backend, deixe QR Code.
  3. Escolha o agente que vai atender e, se quiser, dê um rótulo ao número (ex.: "Suporte").
  4. Salve — o número aparece na lista como desconectado, com a janela de conexão aberta.
  5. No celular, abra o WhatsApp em Aparelhos conectados → Conectar um aparelho e escaneie o QR da tela.

Assim que o pareamento acontece, o painel confirma a conexão. Mande uma mensagem para esse número de outro celular: o agente responde.

QR Code é para testar

A conexão por QR Code não é oficial. Não use para envio em massa: a Meta bloqueia números que disparam mensagens em volume por ela, e nós desaconselhamos o seu uso. Para atender clientes e disparar, conecte pela Cloud API.

Está no próprio celular que quer conectar?

Não dá para escanear o QR que está na tela dele. Use Conectar pelo número, gere o código de 8 caracteres e digite-o no WhatsApp, em Conectar um aparelho → Conectar com número de telefone.

Para um número oficial da Meta (Cloud API), templates de mensagem, disparo em lista e as regras de acesso por número, veja a página do canal WhatsApp.

Voz​

Se quiser que o agente atenda por voz, verifique se voice_enabled está como true no especialista (o padrão). No chat web, clique no botão de microfone ao lado do campo de texto para iniciar uma chamada.

Telegram​

Para conectar ao Telegram:

  1. Crie um bot no @BotFather e copie o token.
  2. No painel, vá em Configurações > Canais.
  3. Clique em Adicionar bot do Telegram.
  4. Cole o token, escolha o agente e salve.
  5. Clique em Registrar webhook.

Agora envie uma mensagem para o seu bot no Telegram. O agente responde.

Próximos passos​