Modo Expert do VoiceAgent

Este artigo explica como ver e editar a configuração completa do seu VoiceAgent na secção Avançado, incluindo definições que não pode alterar em mais nenhum lado.

Nível de utilizador: Admin

O Modo Expert dá-lhe a configuração completa do seu VoiceAgent em JSON. Mostra todas as definições, incluindo as que nunca alterou, com os respetivos valores atuais. Pode ajustar definições que não estão disponíveis nas outras secções, como o modelo de IA, o comportamento da voz e a gestão de chamadas.

Abrir o Modo Expert

No Dashboard, aceda a AI Voice Agents > Agentes e abra o seu VoiceAgent.
No menu da esquerda, em Construir, clique em Avançado.

A secção Avançado de um VoiceAgent, com o painel Configuração a mostrar o JSON completo e a barra de estado Sem problemas

O painel Configuração mostra a configuração completa. Acima dele, também pode pedir ao AI Composer que faça alterações por si, em linguagem simples.

O que vê

Todas as definições, com o respetivo valor. As definições que não alterou mostram o valor predefinido, para que possa ver tudo o que pode ajustar. Não precisa de guardar primeiro para as ver.
Definições para todos os fornecedores de voz. elevenLabsSettings e deepgramSettings aparecem ambos, independentemente do fornecedor que o seu VoiceAgent utiliza.
Uma barra de estado acima do JSON. Indica Sem problemas quando a configuração é válida. Se algo estiver errado, por exemplo um valor não suportado, indica o que tem de corrigir antes de poder guardar.

Editar a configuração

Altere os valores pretendidos no painel Configuração.
Confirme que a barra de estado indica Sem problemas.
Clique em Guardar.

Para anular as alterações não guardadas, clique em Reverter. As outras secções (Identidade, Base de conhecimento e Competências e cenários) e a secção Avançado apresentam a mesma configuração de duas formas diferentes. Uma alteração feita numa é refletida na outra.

Copiar uma configuração para outro VoiceAgent

Na secção Avançado, clique em Copiar para copiar a configuração completa, incluindo os valores predefinidos.
Abra a secção Avançado do outro VoiceAgent, substitua a configuração dele pela que copiou e clique em Guardar.

Como a cópia inclui todas as definições, o outro VoiceAgent comporta-se exatamente da mesma forma.

Altere o agentName. Cada VoiceAgent precisa de um nome único.
Volte a ligar os recursos específicos da conta. Uma configuração pode fazer referência a elementos que pertencem à sua conta, como bases de conhecimento, ferramentas personalizadas, números de telefone ou uma integração de calendário. Quando copia uma configuração para outra conta, configure-os novamente nessa conta.
Após uma importação bem-sucedida, guarde o VoiceAgent duas vezes. Um conjunto conhecido de casos limite só aparece após a segunda gravação.

Referência de definições

Identidade

Campo JSON	O que define
`agentName`	O nome do VoiceAgent. Tem de ser único na sua conta.
`direction`	Se o agente processa chamadas de entrada ou de saída: `"inbound"` ou `"outbound"`.
`language`	O idioma que o VoiceAgent fala.
`secondaryLanguages`	Idiomas adicionais que o VoiceAgent consegue detetar e para os quais pode mudar durante uma chamada. Opcional.
`voice`	A voz utilizada pelo VoiceAgent.
`greeting`	A frase de abertura exata que o VoiceAgent diz no início de uma chamada. Se estiver vazio, os agentes de chamadas de entrada utilizam uma predefinição genérica; os agentes de chamadas de saída começam com silêncio.
`startSpeakingFirst`	Se o VoiceAgent fala primeiro quando a chamada é estabelecida (`true`) ou aguarda pelo interlocutor (`false`).
`defaultOutboundNumberId`	O número de telefone a partir do qual o VoiceAgent liga.
`failoverOutboundNumberId`	Um número alternativo a partir do qual ligar, caso não seja possível utilizar o número predefinido.

Conhecimento e comportamento

Campo JSON	O que define
`knowledgeBaseIds`	As bases de conhecimento que o VoiceAgent pode utilizar para responder a perguntas.
`goalPrompt`	As instruções principais que definem o comportamento do VoiceAgent durante uma chamada.
`skills`	Capacidades estruturadas, por exemplo `takeMessage` e `extractData`. Cada competência tem `enabled` e as suas próprias definições.
`scenarios`	Como o VoiceAgent responde a situações específicas. Cada cenário tem `when`, `reply` e, opcionalmente, uma `action`, como `"hangup"`.
`guardrails`	Respostas fixas para situações que exigem uma resposta consistente, independentemente do contexto.

Em skills.extractData.properties, cada propriedade precisa de um name único. Se duas propriedades partilharem o mesmo nome, a configuração não é guardada.

Estilo de conversa

Estes dois campos controlam a forma como o VoiceAgent fala.

Campo	O que define	Valores
`tone`	Como o VoiceAgent soa. Uma lista de predefinições de estilo; podem ser combinadas, mas uma ou duas funcionam melhor (cada predefinição adicional dilui as restantes). A ordem não importa, os duplicados são removidos automaticamente e não são aceites valores de texto livre.	`"professional"`, `"friendly"`, `"casual"`, `"calm"`, `"empathetic"`, `"direct"`. Predefinição `["friendly", "direct"]`.
`verbosity`	Quanto o VoiceAgent diz em cada resposta. `"concise"` = a resposta útil mais curta possível. `"standard"` = uma a duas frases, oferecendo mais se necessário. `"thorough"` = respostas mais completas com contexto útil (ainda assim breve; isto é uma chamada telefónica).	`"concise"` / `"standard"` / `"thorough"`. Predefinição `"standard"`.

Guia de predefinições de tom:

Predefinição	Efeito
`professional`	Comedido, preciso e respeitoso
`friendly`	Caloroso e simpático
`casual`	Descontraído e informal, como um colega prestável
`calm`	Estável, sem pressa e paciente
`empathetic`	Reconhece os sentimentos do interlocutor antes de avançar para soluções
`direct`	Vai direto à resposta e reduz as formalidades ao mínimo

Independentemente do tom e da verbosidade, o VoiceAgent mantém-se sempre breve em momentos operacionais: confirmações, repetições de informação, despedidas e passos de transferência ou marcação.

Modelo de IA

Campo	O que define
`llm`	O modelo de IA que o VoiceAgent utiliza. Consulte a lista de modelos suportados abaixo.
`provider`	O fornecedor de voz: `"elevenlabs"` ou `"deepgram"`. Na maioria dos casos, o idioma determina o fornecedor automaticamente.
`temperature`	A variedade das respostas do VoiceAgent, entre `0.0` e `1.0`. Para agentes profissionais ou estruturados, recomenda-se `0.1` a `0.3`.

Modelos suportados para llm

Modelo	Valor
GPT-4o Mini	`openai - gpt-4o-mini`
GPT-4o	`openai - gpt-4o`
GPT-4.1	`openai - gpt-4.1`
GPT-4.1 Mini	`openai - gpt-4.1-mini`
GPT-4.1 Nano	`openai - gpt-4.1-nano`
GPT-5	`openai - gpt-5`
GPT-5 Mini	`openai - gpt-5-mini`
GPT-5 Nano	`openai - gpt-5-nano`
GPT-5.1	`openai - gpt-5.1`
Claude 3 Haiku	`anthropic - claude-3-haiku`
Claude Haiku 4.5	`anthropic - claude-haiku-4-5`
Claude 3.7 Sonnet	`anthropic - claude-3-7-sonnet`
Gemini 2.0 Flash Lite	`google - gemini-2.0-flash-lite`
Gemini 1.5 Pro	`google - gemini-1.5-pro`

Ajuste de voz

Campo	O que define	Valores
`stability`	A consistência da voz do VoiceAgent ao longo da chamada. Valores mais altos produzem uma voz mais estável.	`0.0`–`1.0`
`similarity`	A proximidade entre a voz e o modelo de voz original.	`0.0`–`1.0`
`optimizeStreamingLatency`	Troca qualidade de voz por menor latência de resposta. Valores mais altos reduzem a latência, mas podem afetar a qualidade. Não o defina como `4`: desativa a normalização de texto, pelo que números e datas são pronunciados incorretamente.	`0`–`4`

Comportamento da chamada

Campo	O que define	Valores
`maxCallDuration`	Um limite máximo para a duração da chamada, em minutos.	Recomendado: 3–5 para chamadas de saída, 15–30 para chamadas de entrada.
`dialTime`	Durante quanto tempo o VoiceAgent aguarda por uma resposta em chamadas de saída antes de desistir.	`5`–`120` segundos.

Definições do ElevenLabs

Estas definições aplicam-se quando o seu VoiceAgent utiliza o ElevenLabs, a predefinição para a maioria dos idiomas. Encontram-se dentro do objeto elevenLabsSettings, e não ao nível raiz da configuração.

Campo	O que define	Valores
`speculativeTurn`	O VoiceAgent começa a preparar a resposta antes de o interlocutor terminar de falar, o que reduz o tempo de resposta.	`true` / `false`
`turnEagerness`	A rapidez com que o VoiceAgent toma a vez quando o interlocutor faz uma pausa.	`"patient"` / `"normal"` / `"eager"`
`turnModel`	A versão do modelo de deteção de vez.	`"turn_v2"` / `"turn_v3"`
`vad`	Filtra o ruído de fundo, para que não desencadeie uma resposta não intencional.	`true` / `false`
`asrKeywords`	Palavras ou expressões a priorizar no reconhecimento de voz, como nomes de produtos ou termos técnicos.	Lista de strings
`interruptionIgnoreTerms`	Reconhecimentos curtos do interlocutor (por exemplo, sons de concordância) que não devem contar como interrupção, para que o VoiceAgent continue a falar apesar deles. Escritos no idioma do interlocutor.	Lista de strings
`interruptionIgnoreTermLanguages`	Os idiomas em que os termos a ignorar são correspondidos.	Lista de códigos de idioma
`backgroundSound`	Um som ambiente por baixo da fala do VoiceAgent. `null` significa nenhum.	`null` ou um objeto: `preset` (um de `"office"`, `"office2"`, `"restaurant"`, `"city"`, `"typing"`, `"elevator"`, `"elevator2"`, `"elevator3"`, `"elevator4"`), `volume` (`0.0`–`1.0`, opcional), `crossfadeLoop` (`true`/`false`, opcional; repete o som de forma contínua)

Exemplo:

"elevenLabsSettings": {
  "speculativeTurn": true,
  "turnEagerness": "patient",
  "turnModel": "turn_v3",
  "vad": true,
  "asrKeywords": ["Capil Clinic", "injerto capilar", "Barcelona"],
  "interruptionIgnoreTerms": ["vale", "sí", "ajá"],
  "interruptionIgnoreTermLanguages": ["es"],
  "backgroundSound": {
    "preset": "office",
    "volume": 0.3,
    "crossfadeLoop": true
  }
}

Quando guarda, o objeto elevenLabsSettings que envia substitui o que estava guardado. Para limpar uma única definição, remova-a do objeto.

Definições do Deepgram

deepgramSettings contém as definições dos VoiceAgents que utilizam o Deepgram. Fica vazio quando não há nada a definir.

Geridos pela CloudTalk

minorVersion e hashes são geridos pela CloudTalk. Deixe-os como estão.

Precisa de ajuda ou tem alguma dúvida? Contacte-nos através do nosso Portal de Suporte. Estamos aqui para o ajudar.

Primeiros passos

Números e portabilidade

IA

AI Sales Dialer

CloudTalk Phone e Go

Mensagens

Dashboard

Integrações

Faturação e subscrição

Notícias e atualizações técnicas

Dashboard antigo

Abrir o Modo Expert

O que vê

Editar a configuração

Copiar uma configuração para outro VoiceAgent

Referência de definições

Identidade

Conhecimento e comportamento

Estilo de conversa

Modelo de IA

Ajuste de voz

Comportamento da chamada

Definições do ElevenLabs

Definições do Deepgram

Geridos pela CloudTalk

​Abrir o Modo Expert

​O que vê

​Editar a configuração

​Copiar uma configuração para outro VoiceAgent

​Referência de definições

​Identidade

​Conhecimento e comportamento

​Estilo de conversa

​Modelo de IA

​Ajuste de voz

​Comportamento da chamada

​Definições do ElevenLabs

​Definições do Deepgram

​Geridos pela CloudTalk

Abrir o Modo Expert

O que vê

Editar a configuração

Copiar uma configuração para outro VoiceAgent

Referência de definições

Identidade

Conhecimento e comportamento

Estilo de conversa

Modelo de IA

Ajuste de voz

Comportamento da chamada

Definições do ElevenLabs

Definições do Deepgram

Geridos pela CloudTalk