Lógica

Para qué sirve la Lógica

La tab Lógica te permite escribir código Python que se ejecuta en momentos clave del ciclo del agente. Desde acá podés calcular valores y preparar variables que después usás en el Mensaje Inicial o en las Instrucciones del agente.

Los dos bloques de código

Código Inicial

Se ejecuta una sola vez cuando el agente se activa por primera vez.Ideal para:

Calcular la fecha actual y guardarla en el contexto.
Preparar variables derivadas del archivo de campaña.
Inicializar contadores o banderas 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

En este ejemplo, context["agent_name"] = "Ana" define el nombre con el que se presenta el agente. Esa variable se inyecta automáticamente en el prompt — es la misma {agent_name} que podés usar en el Mensaje Inicial o las Instrucciones (ver Identidad) — así que durante toda la conversación el agente se llama “Ana”.

Código Pre Instrucciones

Se ejecuta antes de cada interacción con el LLM — es decir, en cada turno de la conversación.Ideal para:

Actualizar contadores o banderas según lo que pasó en el turno anterior.
Recalcular variables derivadas a medida que avanza la conversación.
Registrar métricas o logs por turno.

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

El diccionario `context`

Todos los valores del agente — variables de campaña, estado de la conversación, configuración dinámica — viven en el diccionario context. Podés leer y escribir libremente, y cualquier variable que guardes ahí queda disponible para usar con {variable} en el Mensaje Inicial y en las Instrucciones del agente.

Ejemplo completo

# Código Inicial — se ejecuta una vez al activarse el agente
from datetime import date

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

# Código Pre Instrucciones — se ejecuta antes de cada turno
context["turnos_transcurridos"] = context.get("turnos_transcurridos", 0) + 1

Con turnos_transcurridos disponible en el contexto, podés referenciarlo directamente en las Instrucciones del agente, por ejemplo:

Si ya pasaron más de 5 turnos ({turnos_transcurridos}) sin llegar a un acuerdo, resumí la propuesta y preguntá directamente si el contacto acepta o no.

Para verificar que tu código funciona como esperás, usá Abrir conversación — podés cargar variables de prueba y ver en tiempo real cómo se comporta el agente con los valores que calculaste en Lógica.

Herramientas Cambio de Agente

Inicio

Primeros pasos

Buenas prácticas

Construí tu agente

Configurá tu bot

Entrada de Campaña

Para qué sirve la Lógica

Los dos bloques de código

El diccionario `context`

Ejemplo completo

​Para qué sirve la Lógica

​Los dos bloques de código

​El diccionario context

​Ejemplo completo

Para qué sirve la Lógica

Los dos bloques de código

El diccionario `context`

Ejemplo completo