Un agente es una aplicación o un bot que llama a proveedores de modelos a través de la pasarela alojada. Tiene un nombre, una descripción, los destinos a los que puede llamar (de 1 a 32), dos protecciones (Bloquear la inyección de prompts, enforce_injection, y Bloquear fugas de datos, block_dlp, las dos activadas por defecto), un interruptor disabled y su propio token. Cada cambio necesita un admin de toda la organización. Para crear uno, mira empezar.
En la API, los agentes se nombran por id (…/egress/agents/{id}, donde … es https://dash.openwaf.dev/v1/orgs/{org}); en MCP, por nombre o id. Los cambios admiten la cabecera opcional X-Change-Reason (en MCP, el reason obligatorio), que queda en la auditoría; no son configuración versionada, así que no hay dry_run ni If-Match.
Cambiar destinos y protección
Solo cambian los campos que envías; allowed_targets se sustituye entero. El nombre no se puede cambiar, porque forma parte de las URL del agente en la pasarela: crea un agente nuevo.
En Egress IA → Agentes, elige Editar en la fila del agente, cambia su descripción, destinos o protección y guarda.
curl -sS -X PATCH "https://dash.openwaf.dev/v1/orgs/$ORG/egress/agents/$AGENT_ID" \
-H "Authorization: Bearer $OPENWAF_TOKEN" -H "Content-Type: application/json" \
-H "X-Change-Reason: el bot de soporte también llama a OpenAI" \
-d '{"allowed_targets": ["openrouter", "openai"]}'egress_update_agent con agent, los campos que cambian (description, allowed_targets, enforce_injection, block_dlp, disabled) y un reason; confirm=false enseña el cambio y confirm=true lo aplica.
Desactiva una protección solo en un agente que tenga que procesar texto con pinta de ataque, como informes de seguridad: los detectores no se pueden desactivar de uno en uno.
Desactivar un agente
El token de un agente desactivado se rechaza (401) hasta que lo vuelvas a activar; no cambia nada más. Marca Desactivado en el diálogo de edición del agente, envía {"disabled": true} con PATCH o llama a egress_update_agent con disabled: true.
Rotar el token
Rotar emite un token nuevo, que se enseña una sola vez, y el actual deja de funcionar en segundos. Actualiza antes todas las aplicaciones que lo usen.
En Egress IA → Agentes, elige Rotar token en la fila del agente y confirma. Copia el token nuevo del diálogo.
curl -sS -X POST "https://dash.openwaf.dev/v1/orgs/$ORG/egress/agents/$AGENT_ID/rotate-token" \
-H "Authorization: Bearer $OPENWAF_TOKEN" -H "X-Change-Reason: token filtrado en un log de CI"La respuesta es {"agent": …, "token": "OWE_TOKEN_…"}, como en el alta.
egress_rotate_token con agent y reason, y después otra vez con confirm=true. El token nuevo solo va en esa respuesta.
Si un token se filtra, rótalo o desactiva el agente: un token solo sirve contra la pasarela, para los destinos permitidos del agente y con sus protecciones, pero hasta entonces puede gastar la clave del proveedor.
Borrar un agente
Al borrar un agente su token deja de funcionar al momento; sus peticiones bloqueadas siguen en el registro. No se puede deshacer. En el panel elige Borrar en la fila del agente; en la API envía DELETE …/egress/agents/{id}; por MCP llama a egress_delete_agent.
Borrar agentes, destinos y claves sigue funcionando aunque Egress IA se desactive para la organización, así que siempre puedes retirar lo que montaste.
Auditoría
Cada cambio deja una entrada en la auditoría de la organización: egress.agent.create, egress.agent.update, egress.agent.rotate_token y egress.agent.delete, con el actor, el motivo y, en los cambios hechos por MCP, "channel": "mcp". El token nunca aparece; solo su prefijo (OWE_TOKEN_ y 6 caracteres).