> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crie seu primeiro agente de voz

> O criador de agentes de ponta a ponta: prompt, mecanismo, voz e idiomas, ferramentas e conhecimento, conversa e implantação.

Tudo sobre um agente fica no criador em **Agentes de voz**
(`/dashboard/agents`) — crie um e você entrará nele. Este guia
segue o mesmo caminho do tour no app "Criar um agente".

<Tip>
  É sua primeira vez aqui? O [início rápido do dashboard](/pt/quickstart-dashboard)
  reúne esta página, além de cobrança, números e simulações, no
  assistente de configuração em cinco etapas.
</Tip>

## 1. Escreva o prompt

O prompt é o roteiro do seu agente de voz. Descreva — em qualquer
idioma — quem é o agente e como ele deve conduzir a chamada: sua
persona, o que ele sabe e o que deve ou não deve fazer.

As ações da chamada também são definidas no prompt. Transferências,
toques de teclado e desligamentos são linhas simples no prompt, como *"Se
quem liga pedir para falar com uma pessoa, transfira a chamada para +1 555…"* —
sem configuração separada.

<Tip>
  O específico supera o genérico. "Confirme o número do pedido com quem
  liga antes de fazer alterações" funciona melhor do que "tenha cuidado
  com pedidos."
</Tip>

## 2. Escolha um mecanismo

Na aba **Configuração**, o seletor de mecanismo equilibra custo e
desempenho em três níveis — **Spark** é otimizado para custo,
**Bolt** para velocidade e **Storm** para inteligência em prompts complexos.
Cada cartão mostra o preço por minuto. Altere a qualquer momento; veja a
[comparação completa dos níveis](/api-reference/agents#product-tiers-at-a-glance).

## 3. Escolha uma voz e os idiomas

Escolha uma voz e reproduza sua amostra diretamente no criador. Defina o
**idioma principal** em que a chamada começa, além de quaisquer **idiomas
adicionais** — o agente alterna automaticamente quando quem liga usa um deles.
A lista de vozes é filtrada para vozes compatíveis com todos os idiomas que você
selecionou. Consulte [Idiomas compatíveis](/pt/guides/supported-languages) para
ver o catálogo completo (idiomas premium adicionam 2¢/min).

## 4. Conecte ferramentas e conhecimento

Quatro seções na aba Configuração oferecem recursos ao agente:

* **Apps conectados** — o caminho mais fácil:
  [conecte Slack, HubSpot, Google e mais](/pt/guides/connect-apps) em
  poucos cliques e permita que seu agente os use durante as chamadas.
* **Conexões de API** — para qualquer outra API,
  [crie uma conexão de API](/pt/guides/api-connections) para as ações
  de que seu agente precisa (cole um comando cURL e o assistente de IA cria
  um rascunho da ferramenta).
* **Conhecimento** — conecte uma
  [base de conhecimento](/pt/guides/knowledge-base) que o agente pode pesquisar
  durante a chamada.
* **Servidores MCP** — [adicione um servidor MCP](/pt/guides/mcp-servers) por URL.

Consulte [Conexões](/pt/guides/concepts) para entender como os quatro
tipos diferem.

## 5. Acompanhe sua tarifa total

O criador mostra sua **tarifa total por minuto** — mecanismo mais
sobretaxas — e a atualiza em tempo real conforme você altera as configurações. Sem
surpresas na fatura.

## 6. Converse com ele

Clique em **Falar** e diga olá — seu agente responde diretamente no navegador
(ele solicitará acesso ao microfone). Este é o ciclo de iteração mais rápido:
ajuste o prompt, converse, repita. Quando quiser alguém do outro
lado em vez de você, [execute uma simulação](/pt/guides/simulate-a-call).

## 7. Implante

Cada edição é **salva automaticamente no seu rascunho** — procure por "Salvo" na
barra superior. As alterações no rascunho não entram em produção até você clicar em **Implantar**.

Cada implantação é registrada na aba **Histórico**: inspecione o que
mudou entre as versões e restaure qualquer versão anterior. Isso torna
seguro implantar com frequência — você sempre pode reverter.

## 8. Conecte-o ao mundo

As seções **Números de telefone** e **Widgets da web** da aba Configuração conectam
pontos de acesso sem sair do criador — conecte um número existente,
provisione um novo número de demonstração, importe via VoIP ou vincule um widget da web.

***

## Próximas etapas

<CardGroup cols={2}>
  <Card title="Obter um número de telefone" icon="phone" href="/pt/guides/get-a-phone-number">
    Número de demonstração em segundos ou use o seu próprio via VoIP.
  </Card>

  <Card title="Simular uma chamada" icon="flask" href="/pt/guides/simulate-a-call">
    Quem liga com IA tem uma conversa real com seu agente.
  </Card>

  <Card title="Revisar as chamadas" icon="headset" href="/pt/guides/review-calls">
    Transcrições, gravações, ouvir chamadas ao vivo e sussurro.
  </Card>

  <Card title="Referência da API de agentes" icon="code" href="/api-reference/agents">
    Crie e gerencie agentes programaticamente.
  </Card>
</CardGroup>