Herramientas de agente

Cada agente de programación trae sus propias herramientas: leer archivos, ejecutar comandos, editar código. OAR añade un pequeño conjunto encima, para que un agente pueda hacer cosas que solo puede hacer el relay: trabajar con otras sesiones, publicar una vista previa web y hacerte una pregunta que puedes responder con un toque.

Nunca llamas tú a estas herramientas. Pides lo que quieres con palabras normales y el agente elige la herramienta. Esta sección sirve para saber qué puede hacer un agente, para qué necesita tu aprobación y qué envía y recibe exactamente.

Las herramientas #

• relay_toolLa herramienta de agente relay_tool — trabaja con sesiones en este relay y en relays emparejados. Las 23 acciones, sus parámetros y resultados, permisos, límites y errores.
• previewLa herramienta de agente preview — publica un servidor de desarrollo local o una carpeta en un enlace público. Acciones, parámetros, resultados, configuración y límites.
• ask_userCómo te hacen preguntas los agentes con una tarjeta con botones — la herramienta ask_user de OAR y las herramientas de pregunta propias de los proveedores, con sus parámetros por proveedor.

Lo que puedes pedir #

Algunas peticiones y la herramienta que usaría un agente:

Por proveedor #

Lo que hace una herramienta es igual en todos los proveedores. Lo que cambia es si los agentes de un proveedor reciben la herramienta y el nombre con el que la ven.

Los chats de Claude API y DeepSeek ejecutan Claude Code en el host del relay, así que sus agentes reciben las herramientas exactamente igual que los de un chat de Claude. Consulta Claude API y DeepSeek.

Las sesiones de Claude Cloud se ejecutan en un sandbox de Anthropic, no en tu máquina. Las herramientas del relay no llegan hasta allí: una sesión en la nube no tiene relay_tool ni preview. Los agentes de otras sesiones sí pueden iniciar, leer, enviar prompts a y detener una sesión en la nube con relay_tool.

Grok y el motor de extensión de Copilot reciben las herramientas de un pequeño servidor MCP que OAR conecta al agente. Fijar la variable de entorno OAR_MCP_SERVER=0 para el relay desactiva ese servidor; esos agentes se quedan entonces sin relay_tool, y en lugar de tener una herramienta preview se les explica cómo llamar a la API de vistas previas.

Cuándo está disponible una herramienta #

Una sesión sabe si recibe relay_tool cuando arranca su proceso de agente. Después de emparejar el primer relay o de activar las sesiones de agentes, una conversación que ya estaba en marcha puede no tener la herramienta hasta que su agente se haya iniciado de nuevo. Nuevo en 0.9.18 Lo mismo vale para el nuevo nombre de la herramienta: una sesión que estaba en marcha cuando actualizaste a 0.9.18 puede tenerla todavía como remote_relay; consulta El nombre.

Lo que sigues controlando tú #

• Nada que vaya más allá de la conversación está activado de forma predeterminada. Las sesiones de agentes están desactivadas hasta que las activas, un relay emparejado está bloqueado en cada conversación hasta que lo mencionas, y la preview lane está desactivada hasta que la configuras.
• Tarjetas de aprobación. La primera sesión que un agente inicia en una conversación, la primera vez que vigila sesiones en un relay y cada acción de escritura en los modos del relay ask y plan te preguntan primero, con una tarjeta de pregunta.
• Las herramientas nunca le dan un token a un agente. Las llamadas a otro relay pasan por tu propio relay, que guarda el token de ese relay. Esto no es un sandbox: un agente se ejecuta como el usuario del relay y podría leer del disco el archivo de configuración y la base de datos. Consulta Qué expone OAR.
• Los enlaces de vista previa son públicos. Cualquiera que tenga un enlace de vista previa puede abrirlo sin iniciar sesión. Al agente se le dice que lo advierta cuando te dé uno. Un agente solo lista y cierra las vistas previas de su propia conversación Nuevo en 0.9.14; Settings → Previews (Ajustes → Vistas previas) las muestra y cierra todas.

Los detalles están en la página de cada herramienta: relay_tool → Permisos y aprobaciones y preview → Límites.

Lo que no son herramientas #

Algunas cosas que hacen los agentes en OAR funcionan sin ninguna herramienta de OAR:

• Imágenes, vídeo y audio en una respuesta. A los agentes se les dice que pueden insertar un archivo multimedia por su ruta absoluta; el relay lo muestra integrado. Es una instrucción en el prompt, no una herramienta. Los agentes del motor de extensión de Copilot y de Claude Cloud no la reciben.
• /preview en el área de redacción. Puedes publicar, listar y cerrar vistas previas tú mismo escribiendo /preview (área de redacción). No cuesta ningún turn de agente y funciona con todos los proveedores.
• El tablero del plan. Cuando un agente termina de planificar, OAR muestra un tablero Plan ready (Plan listo). En Claude y DeepSeek procede de la herramienta de plan propia de Claude Code, que OAR recoge.