> ## 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. # Referência de configurações do agente de voz > Explicação de cada configuração do agente de voz do ThunderPhone: níveis, vozes, idiomas, confirmações, ferramentas, ordem de fala, correio de voz, avisos de consentimento, tratamento de silêncio, testes e implantação. Abra **Agentes de voz**, selecione um agente e use a aba **Configuração** para controlar como ele soa, raciocina, inicia chamadas, usa ferramentas, lida com silêncio e caixa postal e entra em contato com quem liga. As alterações são salvas automaticamente em um rascunho; o tráfego de produção não muda até que você selecione **Implantar**. Esta página é a referência completa do painel. Para nomes de campos e exemplos de solicitações, use a [referência da API de agentes](/api-reference/agents). ## Prompt e identidade O nome do agente o identifica em todo o painel, relatórios, histórico de chamadas e portais de clientes. O prompt é o roteiro operacional do agente: persona, informações da empresa, perguntas obrigatórias, política de escalonamento e ações de chamada. O editor de prompt informa os tokens estimados e sinaliza problemas comuns, como um prompt vazio, espaços reservados de modelo não resolvidos, um caminho de escalonamento ausente ou um prompt muito longo. Os primeiros **5.000 tokens estimados** estão incluídos; prompts mais longos usam [preços com sobretaxa por blocos](/pt/guides/pricing). Transferências, pressionamentos de teclas, comportamento em espera e decisões de encerrar chamadas podem ser escritos diretamente no prompt. Anexe ferramentas de API, aplicativos, MCP ou conhecimento quando o agente precisar de dados ou ações externas. ## Nível do modelo | Nível | Preço base | Melhor para | | --------- | ---------: | --------------------------------------------------------------- | | **Spark** | 2¢/min | Chamadas simples e com foco em custo. | | **Bolt** | 5¢/min | Respostas rápidas e fluxos de trabalho cotidianos equilibrados. | | **Storm** | 9¢/min | Instruções complexas, compreensão de áudio e raciocínio. | Storm oferece dois controles opcionais: * **Confirmação** — **Nenhuma** permanece em silêncio enquanto prepara a resposta completa; **Toque** reproduz um som de espera discreto; **Verbal** fala uma breve confirmação e adiciona **2¢/min**. O texto verbal pode ser gerado a partir do prompt principal ou fornecido manualmente pela API. * **Inteligência extra** — adiciona raciocínio mais aprofundado para chamadas complexas e **3¢/min**. O criador mostra continuamente o **custo total por minuto** do agente, incluindo o nível, o caminho de voz/idioma, o tamanho do prompt, a confirmação verbal, a inteligência extra e a supervisão. ## Voz, plano de fundo e idiomas Selecione uma voz e reproduza sua amostra antes de implantar. O seletor oferece apenas vozes compatíveis com todos os idiomas selecionados e indica combinações premium com sua sobretaxa. Suas vozes personalizadas aparecem no mesmo seletor quando estiverem prontas. Consulte a [Biblioteca de vozes e vozes personalizadas](/pt/guides/voice-library). A **Faixa de plano de fundo** pode ser: * **Nenhuma** — sem áudio ambiente. * **Central de atendimento** — uma ambientação de central de atendimento, com prévia no painel. Defina um **idioma principal** e, em seguida, qualquer número de **idiomas adicionais**. O agente detecta automaticamente quando quem liga muda para um idioma selecionado e responde nele. Algumas combinações de voz/idioma adicionam **3¢/min**; consulte o catálogo gerado de [Idiomas compatíveis](/pt/guides/supported-languages). ## Recursos conectados A aba Configuração tem quatro seções de recursos que podem ser anexadas independentemente: | Seção | Use para | | -------------------------- | ----------------------------------------------------------------------------------------------- | | **Aplicativos conectados** | Operações autorizadas no Google Calendar, Google Sheets, Slack, HubSpot, Salesforce ou Cal.com. | | **Conexões de API** | Seus próprios endpoints HTTP, descritos como funções chamáveis. | | **Conhecimento** | Arquivos ou conteúdo da web que o agente pode pesquisar durante uma chamada. | | **Servidores MCP** | Ferramentas em cache descobertas em servidores remotos do Model Context Protocol. | Um recurso anexado faz parte do rascunho e fica disponível para chamadas de produção após a implantação. Configure primeiro os recursos em **Conexões** ou **Conhecimento** e, em seguida, anexe-os ao agente. ## Endpoints de telefone e web Em **Números de telefone**, anexe um número existente, provisione um número de demonstração ou importe um número por meio de uma conexão VoIP. Um número pode usar agentes diferentes para as direções de entrada e saída. Em **Widgets web**, anexe um widget para que visitantes possam falar com o agente em um site. A disponibilidade do widget também pode ser ativada ou desativada como parte da configuração do agente. ## Comportamento avançado de chamadas Expanda **Avançado** na parte inferior de Config para acessar os controles a seguir. ### Supervisão Quando ativada, uma segunda IA monitora cada turno do agente em relação às instruções e pode intervir silenciosamente. A supervisão adiciona **8¢/min** e não está disponível no Bolt. ### Tom de conexão Reproduza um tom curto imediatamente após a conexão da chamada e antes que qualquer uma das partes fale. ### Som de ferramenta Escolha o som emitido pela ferramenta de som chamável pelo prompt: * **Nenhum** — a ferramenta não é oferecida. * **Campainha**, **Toque** ou **Bipe** — cada um pode ser visualizado no builder. ### Quem fala primeiro Configure chamadas de entrada e saída separadamente: * **Entrada:** o agente fala primeiro ou quem liga fala primeiro. * **Saída:** o agente fala primeiro ou quem recebe a chamada fala primeiro. Essa configuração é útil para discadores de saída que precisam aguardar uma pessoa ou um menu telefônico antes de iniciar o script. ### Tratamento de correio de voz Escolha o que acontece quando uma chamada de saída chega ao correio de voz: | Opção | Comportamento | | ----------------------------------------- | -------------------------------------------------------------------------------- | | **Deixar o agente decidir** | O prompt e o contexto da conversa determinam se o agente deve falar ou desligar. | | **Desligar silenciosamente** | Encerre sem deixar uma mensagem. | | **Deixar uma mensagem e depois desligar** | Diga a mensagem configurada e encerre a chamada. | As mensagens de correio de voz podem conter até **2.000 caracteres** e oferecem suporte a `{agent_name}` e `{org_name}`. Consulte [Preços](/pt/guides/pricing) para saber como o tempo de chamada é medido. ### Aviso de consentimento Por padrão, um aviso curto no início de cada chamada informa a quem liga que está falando com um assistente de IA e que a chamada é gravada. Você pode editar o texto do aviso, com até **2.000 caracteres**; ele é reproduzido literalmente no idioma do agente. Desativar o aviso em um agente qualificado exige que um administrador da organização confirme que a organização fornecerá todos os avisos exigidos por lei e obterá todos os consentimentos exigidos por lei. Reativá-lo e depois desativá-lo exige uma nova confirmação. Consulte o [guia sobre leis de consentimento para gravação](/pt/guides/recording-consent-laws) antes de alterar essa configuração. ### Verificações de silêncio Quando ativada, o agente verifica se quem liga ainda está presente após um período de silêncio, repete até o limite definido e depois desliga: * **Segundos antes da verificação:** 10–120 segundos. * **Máximo de verificações:** 1–10. Os padrões são 15 segundos e 3 verificações. ## Abas do builder e ciclo de vida | Aba ou ação | Finalidade | | ----------------------- | ------------------------------------------------------------------------------------------------ | | **Ao vivo / Conversar** | Fale com o rascunho atual no navegador e inspecione a transcrição e a atividade das ferramentas. | | **Chamadas** | Revise as chamadas atendidas por este agente. | | **A/B** | Crie variantes de prompt ou configuração e compare resultados ao vivo. | | **Simular** | Execute cenários salvos ou ad hoc de quem liga com IA no rascunho. | | **Validação** | Reproduza turnos congelados de chamadas reais no rascunho antes da implantação. | | **Histórico** | Compare revisões implantadas e restaure uma delas no rascunho. | | **Descartar** | Reverta todas as configurações pendentes do rascunho para a versão implantada. | | **Implantar** | Promova atomicamente o rascunho completo e crie uma revisão. | Se outro editor salvar o mesmo agente depois que você o carregou, o ThunderPhone interromperá o salvamento ou a implantação conflitante e solicitará que você atualize a página, em vez de sobrescrever as alterações dessa pessoa. ## Gerencie agentes pela lista A página **Agentes de voz** também oferece suporte a ações de ciclo de vida no nível da organização: * **Duplique** um agente como um novo ponto de partida na mesma organização. * **Transfira** um agente para outra organização à qual você pertence. **Copiar** mantém a origem; **Mover** remove o agente da organização atual e exige acesso de administrador. * Selecione um ou mais agentes e exporte a configuração exibida como **CSV** ou **JSON**. * Exclua um agente ou exclua em massa os agentes selecionados após a confirmação. Copiar ou mover um agente entre organizações não concede silenciosamente à organização de destino acesso a conexões exclusivas da origem. Revise os anexos de app, API, conhecimento, MCP, número de telefone e widget do agente copiado antes de implantá-lo lá. ## Páginas relacionadas Um tour conciso do construtor, do início ao fim. Níveis básicos, complementos, medição de chamadas, números e cobranças únicas. Congele turnos de chamadas reais e reproduza-os antes de implantar. Campos de solicitação, rascunhos, implantações, versões e exemplos.