Los agentes son la identidad principal en RenLayer. Cada traza, política y límite de tasa se ancla a un agente, y cada clave de API se asigna a un agente. La página Agentes es donde los registras, los configuras y los rotas.
Registrar un agente
Para crear un agente, haz clic en Nuevo agente y proporciona:
- Nombre: legible para humanos; aparece en el dashboard y el log de auditoría (p. ej.
support-bot-v1). - Descripción: opcional, una línea para que otros operadores sepan para qué es este agente.
- Upstream: el proveedor de modelo o API de herramienta a través del cual hablará el agente (OpenAI, Anthropic, un endpoint vLLM interno, un servidor MCP).
- Conjunto de políticas por defecto: qué políticas hereda este agente de los valores por defecto del tenant.
Cuando guardas, la consola devuelve el ID de agente y una clave de API inicial. La clave de API se muestra una sola vez; cópiala a tu gestor de secretos inmediatamente.
Claves de API
Cada agente puede tener múltiples claves de API activas a la vez, lo que hace segura la rotación:
- Genera una nueva clave.
- Despliégala al almacén de secretos de tu agente junto a la antigua.
- Cambia el tráfico a la nueva clave.
- Revoca la antigua.
La revocación es inmediata y se propaga a cada instancia del proxy en la siguiente petición.
Límites de tasa por agente
La pestaña Límites del agente expone los límites de tasa por agente y por usuario (peticiones/minuto, tokens/minuto, techos diarios). Consulta límites de tasa para el modelo.
Configuración del upstream
La pestaña Upstream controla a dónde reenvía el proxy el tráfico de este agente. Puedes:
- Sobrescribir la URL base (útil para enrutar a endpoints de staging vs producción).
- Inyectar headers upstream (p. ej. una clave de API upstream, mantenida en el servidor, nunca expuesta al agente).
- Fijar el agente a un modelo específico.
La inyección de headers es el patrón recomendado para mantener tu clave real de OpenAI fuera del host del agente, el proxy guarda el secreto y el agente solo usa la clave emitida por RenLayer.
Sesiones de este agente
La página de detalle del agente incluye una vista filtrada de Sesiones para que veas las trazas de este agente de forma aislada. Útil al hacer triaje de un único agente con mal comportamiento sin perder el contexto general.
Auditoría e historial
Cada cambio sobre un agente (creado, clave generada, clave revocada, upstream editado, límite subido) se registra en el log de auditoría con el operador, la marca de tiempo y el diff.
A dónde ir después
- Políticas: escribe reglas que apunten a agentes específicos.
- Sesiones: investiga lo que hizo un agente.
- Proxy: despliegue: cómo apuntar tu agente al proxy.