Procedimientos

Información general

Un procedimiento contiene instrucciones para una tarea específica. Cada procedimiento tiene un activador que describe cuándo se aplica y contenido que describe qué hacer. Cuando una conversación coincide con el activador, el agente carga el procedimiento.

Usa procedimientos cuando tu agente necesite gestionar muchas tareas distintas. Un ejemplo de uso es un agente de atención al cliente, donde cada procedimiento cubre un tipo de solicitud: reembolsos, verificación de identidad, recuperación de cuentas o resolución de problemas de conexión.

Tipos de procedimientos

Hay dos tipos de procedimientos:

• Procedimientos de formato libre se redactan como instrucciones en lenguaje natural que el agente interpreta y adapta a la situación.
• Procedimientos estructurados son una lista ordenada de pasos tipados que el agente ejecuta siempre de la misma forma.

Puedes usar ambos tipos en el mismo agente. El agente elige el procedimiento relevante según su activador, independientemente del tipo.

Un agente puede tener procedimientos, un flujo de trabajo o ambos. Cuando están presentes ambos, todos los procedimientos están disponibles desde cualquier punto del flujo de trabajo; un procedimiento no puede limitarse a nodos específicos del flujo de trabajo. La mayoría de agentes se crean en torno a un enfoque u otro, pero ambos se pueden combinar.

Cuándo usar procedimientos

Cada agente tiene un prompt del sistema. Los procedimientos y los flujos de trabajo son dos formas de añadir estructura, y un agente puede usar ambos. Elige un punto de partida según cuánto pueda variar la conversación.

Los procedimientos de formato libre son la opción predeterminada. Son los más rápidos de redactar, se leen como un documento para que equipos no técnicos puedan encargarse de ellos y el agente puede recuperarse cuando una conversación se desvía del guion. Usa un procedimiento estructurado cuando el coste de omitir o reordenar un paso sea alto, por ejemplo, en autenticación, escalado o una transacción financiera. Usa un flujo de trabajo cuando necesites lógica de enrutamiento o control del modelo por paso que no ofrezca ninguno de los tipos de procedimiento.

Gestionar procedimientos

El panel es la forma recomendada de crear procedimientos. Usa la CLI o la API para gestionar procedimientos mediante programación o integrarlos en herramientas de despliegue.

Elegir procedimientos por conversación

De forma predeterminada, todas las conversaciones pueden usar todos los procedimientos del agente, y el agente solo carga un procedimiento después de que la conversación coincida con su activador. A menudo, tu aplicación sabe más antes de que empiece la conversación: quién es el usuario, en qué región se encuentra o por qué ha llamado. Pasa los ID de procedimientos en los datos de cliente de inicio de la conversación para usar esa información. Tú decides qué procedimientos puede usar el agente y cuáles sigue desde el primer turno.

Un procedimiento en start_procedure_ids ya está cargado cuando el usuario habla por primera vez, por lo que el agente omite la llamada al LLM que lo cargaría. Cualquier procedimiento activo permanece en el prompt en cada turno, tanto si lo inició el agente como tu aplicación. Un procedimiento iniciado que la conversación nunca necesita sigue añadiendo su contenido a cada turno, así que inicia solo los procedimientos que probablemente vaya a usar la conversación.

{
  "type": "conversation_initiation_client_data",
  "procedure_ids": [
    "agtprc_4101k8f3w2pqv6xs9mhdr0tz7n3b",
    "agtprc_2301k8f3xq9zfa7tkrqs6m4bdn5e",
    "agtprc_7801k8f3yt4mfzh2xbq9d0vcpw1r"
  ],
  "start_procedure_ids": ["agtprc_4101k8f3w2pqv6xs9mhdr0tz7n3b"]
}

Ambos campos siguen estas reglas:

• Cada ID de procedure_ids debe pertenecer al agente. Si un procedimiento seleccionado llama a subprocedimientos, incluye también los subprocedimientos.
• Cada ID de start_procedure_ids debe ser un procedimiento de formato libre. Si también pasas procedure_ids, cada ID también debe estar en esa lista.
• procedure_ids se aplica solo al agente con el que se inicia la conversación. No se aplica después de una transferencia de agente.
• Los procedimientos iniciados cuentan para el límite de cinco procedimientos activos de Limitaciones. El historial de la conversación registra cada uno como una llamada a la herramienta start_procedure.

Limitaciones

• El contenido de un procedimiento está limitado a 50.000 caracteres.
• El agente conserva en el contexto los cinco procedimientos iniciados más recientemente. Cuando se han iniciado más en una conversación, el contenido, las herramientas integradas y los documentos de la base de conocimiento de los procedimientos de formato libre más antiguos salen del prompt. Mantén los procedimientos centrados y usa subprocedimientos para que haya pocos activos a la vez.
• No puedes cambiar el tipo de un procedimiento después de crearlo. Para convertir entre formato libre y estructurado, crea un procedimiento nuevo y actualiza todas sus referencias.
• Los procedimientos pertenecen a un único agente. No se pueden compartir entre agentes ni almacenar como recursos a nivel de espacio de trabajo.
• Duplicar un agente copia sus procedimientos en lugar de compartirlos. Las copias reciben nuevos ID de procedimientos, por lo que las referencias del agente duplicado deben usar esos nuevos ID.
• Los procedimientos no pueden limitarse a nodos específicos del flujo de trabajo. Cuando un agente tiene ambos, todos los procedimientos están disponibles desde cada nodo.
• Los procedimientos estructurados no pueden hacer referencia a documentos de la base de conocimiento.