Skip to main content
A Tig.ai tem um modelo de dados simples para passar informações por uma chamada. Entendê-lo é fundamental para criar agentes que pareçam personalizados e para extrair resultados úteis após uma chamada.

​
Os três objetos de contexto

​
initial_context

Dados disponíveis para o agente antes de a chamada começar — o nome do contato, os detalhes da conta, informações do agendamento, qualquer coisa que o agente deva saber de antemão. Pode ser definido de vários lugares:
  • Pre-call data fetch — enriqueça o contexto com dados do seu CRM ou ERP por meio de uma chamada HTTP conforme a chamada começa
  • Pre-call data fetch — enriqueça o contexto com dados do seu CRM ou ERP por meio de uma chamada HTTP assim que a chamada começa, antes de o agente falar
  • Agent Settings — defina variáveis de contexto de template no agente para testes; elas são incluídas nas chamadas de teste do editor de workflow e ignoradas nas chamadas de produção

​
Template variables

Os valores de initial_context ficam disponíveis no prompt do seu agente usando a sintaxe {{double_brace}}.
Quando a chamada começa, a Tig.ai substitui os valores antes de enviar o prompt ao LLM — para que o agente fale naturalmente, como se já conhecesse o contato.

​
Valores de fallback

Se uma variável pode estar ausente ou vazia, use uma barra vertical (|) para fornecer um valor padrão:
Quando customer_name não está definido, o agente dirá “Hello there” em vez de deixar um espaço em branco. A sintaxe é:
Se a variável estiver presente e não vazia, o fallback é ignorado e o valor real é usado.

​
Variáveis padrão

Variáveis integradas para hora e dia da semana atuais, disponíveis em qualquer prompt sem configurar initial_context. Substitua <TIMEZONE> por um nome de fuso horário IANA, como Asia/Kolkata, America/New_York ou Europe/London.
Quando você usa um sufixo de fuso horário em qualquer uma das variáveis current_time ou current_weekday, a outra variável sem sufixo usará automaticamente o mesmo fuso horário em vez de UTC. Por exemplo, se o seu prompt contiver {{current_time_Asia/Kolkata}} e {{current_weekday}}, o dia da semana também será resolvido em Asia/Kolkata.

​
Variáveis de telefonia

Para chamadas telefônicas recebidas, a Tig.ai adiciona automaticamente estas variáveis ao initial_context: Para chamadas recebidas, caller_number é o número do cliente e called_number é o seu número da Tig.ai.

​
gathered_context

Dados que o agente extrai durante a chamada — na direção oposta do initial_context. Use-o para transformar uma conversa em dados estruturados: o que o cliente quer, se confirmou algo, um valor que ele informou em voz alta.

​
Como ele é preenchido

Ative a extração em um nó Agent ou End Call e defina uma ou mais variáveis a extrair. Cada variável tem: Variáveis extraídas Quando a conversa alcança esse nó, o LLM lê a transcrição até aquele ponto e preenche cada variável com base no seu prompt. Se um valor não puder ser determinado a partir da conversa, a variável permanece vazia em vez de ser adivinhada — deixe o prompt específico o suficiente para que o LLM saiba exatamente o que conta como correspondência. Você pode adicionar extração a mais de um nó. As variáveis extraídas de cada nó são mescladas no mesmo objeto gathered_context conforme a chamada avança, identificadas por name — reutilize um name em um nó posterior se quiser sobrescrever um valor anterior.

​
Como referenciá-lo a jusante

O gathered_context não fica disponível nos prompts de Agent — um prompt só pode referenciar campos de initial_context, porque a extração geralmente acontece depois da conversa que o usaria. Para agir sobre os dados extraídos, envie-os por meio de um nó:
Consulte Webhook Payloads para ver a lista completa de variáveis disponíveis junto com gathered_context em um template de payload.

​
Exemplo de fluxo de dados

​
Onde as variáveis estão disponíveis