Procedimientos

Instrucciones específicas para cada tarea que tu agente carga cuando son relevantes

Descripció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 caso 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.

Pestaña Procedimientos en el panel de control del agente

Tipos de procedimientos

Hay dos tipos de procedimientos:

Los procedimientos de formato libre se redactan como instrucciones en lenguaje natural que el agente interpreta y adapta a la situación.
Los 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.

Los procedimientos pueden llamarse entre sí. Un procedimiento de formato libre llama a otro procedimiento con una referencia integrada, y un procedimiento estructurado llama a otro procedimiento estructurado con un paso de subprocedimiento. Un patrón habitual consiste en mantener la gestión abierta en un procedimiento de formato libre y delegar las partes que deben ejecutarse siempre de la misma manera a uno estructurado.

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

Cuándo usar procedimientos

Todos los agentes tienen un prompt del sistema. Los procedimientos y los workflows 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.

Requisito	Usar	Motivo
Agente de prueba de concepto sencillo	Solo prompt del sistema	Es la opción más rápida de configurar e iterar, pero un único prompt se vuelve difícil de manejar a medida que el alcance del agente crece.
Tarea en la que el agente puede adaptar la redacción y el orden	Procedimiento de formato libre	Mantiene toda la conversación en el contexto de un LLM, por lo que el agente adapta la redacción y el orden, y puede seguir giros inesperados. Usa más ventana de contexto.
Tarea cuyos pasos deben ejecutarse siempre de la misma forma	Procedimiento estructurado	Cada paso se ejecuta en el orden que establezcas, siempre de la misma forma, y lo redactas como una lista breve de pasos.
Control total sobre ramificaciones complejas y casos límite	Workflow	Se ejecuta como un grafo de subagentes que diseñas y conectas tú, con control total sobre las ramificaciones y el modelo que usa cada paso.

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 gestionarlos, y el agente puede recuperarse cuando una conversación se sale del guion. Usa un procedimiento estructurado cuando el coste de omitir o reordenar un paso sea alto, como en autenticación, escalado o una transacción financiera. Usa un workflow cuando necesites lógica de enrutamiento o control del modelo por paso que ningún tipo de procedimiento ofrezca.

Gestionar procedimientos

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

Crear desde el panel de control

Gestionar desde la CLI

Gestionar mediante la API

Abre tu agente en el panel de control y selecciona Procedimientos. Usa + para crear un procedimiento de formato libre o estructurado. Puedes agrupar procedimientos en carpetas desde el mismo menú. Consulta Procedimientos de formato libre y Procedimientos estructurados para obtener orientación sobre su creación.

Limitaciones

El contenido de un procedimiento está limitado a 50.000 caracteres.
El agente mantiene en contexto los cinco procedimientos iniciados más recientemente. Cuando se han iniciado más en una misma conversación, el contenido, las herramientas integradas y los documentos de la base de conocimientos de los procedimientos de formato libre más antiguos desaparecen 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 cualquier referencia a él.
Los procedimientos pertenecen a un único agente. No se pueden compartir entre agentes ni almacenar como recursos a nivel de espacio de trabajo.
Al duplicar un agente, se copian sus procedimientos en lugar de compartirlos. Las copias reciben nuevos ID de procedimiento, por lo que las referencias en el agente duplicado deben usar esos nuevos ID.
Los procedimientos no pueden limitarse a nodos específicos del workflow. Cuando un agente tiene ambos, todos los procedimientos están disponibles desde todos los nodos.
Los procedimientos estructurados no pueden hacer referencia a documentos de la base de conocimientos.