> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Procedimientos

## 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](/docs/_fern-img/38b190b7a08cb9e628da309a86c5e4b315eabccf238a41d5d3a6c2646aba11af.webp)

## Tipos de procedimientos

Hay dos tipos de procedimientos:

* Los **[procedimientos de formato libre](/docs/es/eleven-agents/customization/procedures/free-form-procedures)** se redactan como instrucciones en lenguaje natural que el agente interpreta y adapta a la situación.
* Los **[procedimientos estructurados](/docs/es/eleven-agents/customization/procedures/structured-procedures)** 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.

> **Tip**
>
> Los procedimientos pueden llamarse entre sí. Un procedimiento de formato libre llama a otro procedimiento con una [referencia integrada](/docs/es/eleven-agents/customization/procedures/free-form-procedures#inline-references), y un procedimiento estructurado llama a otro procedimiento estructurado con un paso de [subprocedimiento](/docs/es/eleven-agents/customization/procedures/structured-procedures#sub-procedure). 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](/docs/es/eleven-agents/customization/agent-workflows) 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](/docs/es/eleven-agents/best-practices/prompting-guide). Los procedimientos y los [workflows](/docs/es/eleven-agents/customization/agent-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](/docs/es/eleven-agents/customization/procedures/free-form-procedures) | 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](/docs/es/eleven-agents/customization/procedures/structured-procedures)    | 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](/docs/es/eleven-agents/customization/agent-workflows)                                       | 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

Abre tu agente en el [panel de control](https://elevenlabs.io/app/agents) 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](/docs/es/eleven-agents/customization/procedures/free-form-procedures) y [Procedimientos estructurados](/docs/es/eleven-agents/customization/procedures/structured-procedures) para obtener orientación sobre su creación.

#### Gestionar desde la CLI

La [CLI de ElevenLabs](/docs/es/eleven-agents/operate/cli) gestiona procedimientos con el grupo de comandos `elevenlabs agents procedures`. Primero, configura `ELEVENLABS_API_KEY` en tu entorno.

```bash
# List the procedures on a branch
elevenlabs agents procedures list \
  --agent-id agent_7101k5zvyjhmfg983brhmhkd98n6 \
  --branch-id agtbranch_0901k4aafjxxfxt93gd841r7tv5t

# Create a procedure
elevenlabs agents procedures create \
  --agent-id agent_7101k5zvyjhmfg983brhmhkd98n6 \
  --branch-id agtbranch_0901k4aafjxxfxt93gd841r7tv5t \
  --json '{"name": "Refund request", "type": "free_form", "trigger": "When the user asks to refund an order", "content": "Ask for the order ID."}'

# Publish every changed procedure draft on the branch
elevenlabs agents update \
  --agent-id agent_7101k5zvyjhmfg983brhmhkd98n6 \
  --branch-id agtbranch_0901k4aafjxxfxt93gd841r7tv5t \
  --json '{"version_description": "Publish refund procedure"}'
```

Usa `elevenlabs agents procedures drafts` para leer, actualizar o descartar un borrador, y `elevenlabs agents procedures remove` para preparar una eliminación. Añade `--schema` a cualquier comando para ver su contrato de entrada y salida.

#### Gestionar mediante la API

Los borradores de procedimientos siguen el [ciclo de vida de versionado de agentes](/docs/es/eleven-agents/operate/versioning#drafts). Son específicos de cada usuario y rama, por lo que cada miembro del equipo tiene borradores separados en cada rama. Al publicar, tus cambios en los procedimientos se guardan en una nueva versión inmutable del agente en esa rama. Los borradores de otros usuarios no se ven afectados.

Las respuestas de configuración del agente incluyen metadatos de procedimientos, como ID, nombres, tipos y activadores, pero no los cuerpos de los procedimientos ni los borradores. Usa las rutas de procedimientos para leer y editar el contenido completo. Todas las rutas de procedimientos están anidadas bajo `/v1/convai/agents/{agent_id}/branches/{branch_id}`.

### Crear o actualizar un borrador

Crea un procedimiento con `POST /procedures`. Actualízalo con `PATCH /procedures/{procedure_id}/draft`, incluyendo `name`, `content`, `type` y `trigger` en cada solicitud. El `type` debe coincidir con el tipo existente del procedimiento.

Usa `GET /procedures/{procedure_id}/draft` para leer cambios sin publicar. Si no tienes borrador, la ruta devuelve la versión publicada.

### Publicar los cambios

Publica los borradores creando una nueva versión del agente con [Actualizar agente](/docs/es/api-reference/agents/update). Una solicitud publica todos los borradores de procedimientos modificados de la rama, para ambos tipos de procedimientos. Si la rama tiene procedimientos estructurados, la publicación los valida y compila (convierte sus pasos en el formato que ejecuta el agente) y devuelve cualquier error. Si la validación se completa correctamente, se publica la configuración del agente. No tienes que compilar nada tú.

Sigue las instrucciones específicas para [procedimientos de formato libre](/docs/es/eleven-agents/customization/procedures/free-form-procedures#manage-a-free-form-procedure) o [procedimientos estructurados](/docs/es/eleven-agents/customization/procedures/structured-procedures#manage-a-structured-procedure).

### Descartar o eliminar un procedimiento

`DELETE /procedures/{procedure_id}/draft` descarta las ediciones sin publicar y restaura la versión publicada. Si el procedimiento nunca se ha publicado, se elimina.

`DELETE /procedures/{procedure_id}` prepara la eliminación de un procedimiento publicado. Publica el cambio mediante el mismo flujo.

Consulta la [referencia de la API de procedimientos](/docs/es/api-reference/agents/procedures/) para ver los esquemas completos de las rutas.

## 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.