Lógica

Para que serve a Lógica

A aba Lógica permite escrever código Python que é executado em momentos-chave do ciclo do agente. A partir daqui você pode calcular valores e preparar variáveis que depois usa na Mensagem Inicial ou nas Instruções do agente.

Os dois blocos de código

Código Inicial

É executado uma única vez quando o agente é ativado pela primeira vez.Ideal para:

Calcular a data atual e salvá-la no contexto.
Preparar variáveis derivadas do arquivo de campanha.
Inicializar contadores ou flags de estado.

from datetime import date

context["agent_name"] = "Ana"
context["today_formatted"] = date.today().strftime("%d de %B de %Y")
context["max_attempts"] = 3

Neste exemplo, context["agent_name"] = "Ana" define o nome com o qual o agente se apresenta. Essa variável é injetada automaticamente no prompt — é a mesma {agent_name} que você pode usar na Mensagem Inicial ou nas Instruções (veja Identidade) — então, durante toda a conversa, o agente se chama “Ana”.

Código Pré-Instruções

É executado antes de cada interação com o LLM — ou seja, a cada turno da conversa.Ideal para:

Atualizar contadores ou flags de acordo com o que aconteceu no turno anterior.
Recalcular variáveis derivadas à medida que a conversa avança.
Registrar métricas ou logs por turno.

context["turnos_decorridos"] = context.get("turnos_decorridos", 0) + 1

O dicionário `context`

Todos os valores do agente — variáveis de campanha, estado da conversa, configuração dinâmica — vivem no dicionário context. Você pode ler e escrever livremente, e qualquer variável que você salvar ali fica disponível para uso com {variable} na Mensagem Inicial e nas Instruções do agente.

Exemplo completo

# Código Inicial — executado uma vez ao ativar o agente
from datetime import date

context["agent_name"] = "Ana"
context["hoje"] = date.today().strftime("%d/%m/%Y")
context["turnos_decorridos"] = 0

# Código Pré-Instruções — executado antes de cada turno
context["turnos_decorridos"] = context.get("turnos_decorridos", 0) + 1

Com turnos_decorridos disponível no contexto, você pode referenciá-lo diretamente nas Instruções do agente, por exemplo:

Se já passaram mais de 5 turnos ({turnos_decorridos}) sem chegar a um acordo, resuma a proposta e pergunte diretamente se o contato aceita ou não.

Para verificar se o seu código funciona como esperado, use Abrir conversa — você pode carregar variáveis de teste e ver em tempo real como o agente se comporta com os valores que você calculou na Lógica.

Ferramentas Mudança de Agente

Início

Primeiros passos

Boas práticas

Construa seu agente

Configure seu bot

Entrada de Campanha

Para que serve a Lógica

Os dois blocos de código

O dicionário `context`

Exemplo completo

​Para que serve a Lógica

​Os dois blocos de código

​O dicionário context

​Exemplo completo

Para que serve a Lógica

Os dois blocos de código

O dicionário `context`

Exemplo completo