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, conectá-lo a um canal de voz ou Telegram.

Pré-requisitos​

  • Uma conta na plataforma (se ainda não tem, cadastre-se — o trial gratuito de 14 dias já está disponível).
  • 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. Acesse o painel admin em #/admin/specialists e 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. Vá em #/admin/mcp-servers 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)​

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​