Variáveis de Template

Você pode usar variáveis de template nos prompts dos seus nós de Agent ou ao construir o payload do Webhook Node.

​

Renderização de templates

Você referencia variáveis de template com a sintaxe {{double_brace}}. Os dados vêm do initial_context, incluindo valores retornados por um Pre-Call Data Fetch, e do gathered_context nos payloads de webhook.

A sintaxe depende de onde você usa:

Onde	initial_context	gathered_context
Prompts de nós de Agent	{{field_name}} (referenciado diretamente)	Não disponível
Payloads de Webhook Nodes	{{initial_context.field_name}}	{{gathered_context.field_name}}

​

Prompts de nós de Agent

Em um prompt de nó de Agent, referencie cada campo de initial_context diretamente pelo nome. Valores aninhados são suportados com notação de ponto.

Exemplo: se o contexto inicial é

{
    "initial_context": {
        "user": {
            "name": "John"
        }
    }
}

escreva seu prompt para acessar o nome do usuário da seguinte forma:

Prompt: You are Alice, who is talking to {{user.name}}.

As variáveis extraídas durante a chamada (gathered_context) não estão disponíveis nos prompts de Agent — um prompt só pode referenciar campos de initial_context. Para agir sobre os dados extraídos, envie-os a um Webhook Node.

​

Payloads de Webhook Nodes

Ao construir um payload de Webhook Node, os objetos de contexto ficam aninhados sob seus nomes, então referencie-os com os prefixos initial_context. e gathered_context.:

Valor de payload: {{initial_context.user.name}} ou {{gathered_context.call_disposition}}

​

Usando variáveis de template para testes

As variáveis de template definidas em Settings > Context Variables do seu workflow são incluídas nas chamadas de teste (web e telefone) feitas a partir do editor de workflow. Isso é útil para simular dados que normalmente viriam da telefonia.

Por exemplo, você pode definir caller_number e called_number como variáveis de contexto para testar o Pre-Call Data Fetch sem precisar de uma chamada recebida real.

Os testes de voz no navegador usam o mesmo modelo de contexto das chamadas recebidas.

Essas variáveis de contexto são usadas apenas durante as chamadas de teste do editor de workflow. Nas chamadas recebidas de produção, os dados reais de telefonia são usados e esses valores são ignorados.

​

Nodes

Os agentes de voz da Tig.ai são compostos por vários nós. Esses nós fornecem instruções ao agente de voz, configuram conversas recebidas e enviam resultados para os seus sistemas com um webhook. Nas próximas etapas, documentaremos os nós que você pode usar para construir o agente de voz.