osFoundry / Platform
Configuración de herramientas
Define nuevas herramientas como entradas + handler. Cualquier cosa que se pueda llamar desde Maestro.
Qué es
Las configuraciones de herramientas son la forma de enseñar a los agentes de osFoundry a hacer cosas que ninguna función integrada te ofrece. Una configuración de herramienta es una definición breve con dos partes: las entradas que acepta (los parámetros con nombre y sus tipos) y un handler (lo que realmente se ejecuta cuando se llama a la herramienta). Una vez definida, la herramienta pasa a formar parte del conjunto de recursos que Maestro, el runtime de agentes de osFoundry, puede invocar mientras trabaja, igual que usa el chat, la búsqueda o las operaciones con archivos. Si puedes describir una acción como "estos son los argumentos y esto es lo que se ejecuta", puedes convertirla en una herramienta que tus agentes llaman por su nombre.
Dentro de osFoundry esto vive en Studio, junto al resto de la configuración de agentes y flujos de trabajo, así que una herramienta que definas queda disponible para los agentes, loops y equipos que construyes en el mismo espacio de trabajo. Como osFoundry es bring-your-own-key y local-first, el handler se ejecuta desde tu espacio con tus propias credenciales y claves: no hay un revendedor entre tu agente y el servicio al que llama, ni un límite por usuario sobre cuántas herramientas defines o con qué frecuencia se ejecutan. El esquema de entradas es lo que el modelo lee para decidir cuándo y cómo llamar a la herramienta, así que un conjunto claro de entradas con nombre es lo que hace que el agente la use correctamente; el handler es la parte que controlas de principio a fin.
Por qué importa: la mayor parte del trabajo real de un agente depende de acciones específicas de tu stack, como llamar a una API interna, ejecutar un script o extraer datos de un sistema al que solo tú tienes acceso. En lugar de esperar a que una función cubra cada caso, las configuraciones de herramientas te permiten añadir justo la capacidad que necesitas y que Maestro la use de inmediato. La herramienta se convierte en un bloque reutilizable: la defines una vez y cualquier agente o flujo del espacio de trabajo puede llamarla.
Capacidades principales
- Define una herramienta con dos piezas: las entradas que recibe y el handler que se ejecuta al llamarla
- Entradas con nombre y tipo dan al modelo un contrato claro sobre cuándo y cómo invocar la herramienta
- Cualquier herramienta que definas queda invocable por Maestro, el runtime de agentes de osFoundry, por su nombre
- Los handlers se ejecutan desde tu propio espacio con tus claves: BYOK, sin revendedor en el camino
- Reutiliza una herramienta definida en los agentes, loops y equipos que construyes en el mismo Studio
Casos de uso
- Desarrollador: envuelve un endpoint REST interno como herramienta con entradas tipadas para que un agente lo consulte durante una tarea sin codificar la llamada a mano
- Ingeniero de operaciones: define una herramienta cuyo handler ejecuta un script de mantenimiento y deja que un agente programado lo invoque como paso rutinario
- Líder de equipo: añade una herramienta de consulta a medida en Studio y la reutiliza en todos los agentes y flujos del espacio en lugar de rehacerla en cada uno
Preguntas frecuentes
¿Qué es exactamente una configuración de herramienta en osFoundry?
Es una definición con dos partes: las entradas que acepta la herramienta (sus parámetros con nombre y tipo) y un handler que se ejecuta cuando se invoca. Tras definirla, la herramienta queda disponible para que Maestro la llame mientras un agente trabaja.
¿Qué puede hacer el handler de una herramienta?
El handler es la acción que se ejecuta al invocarla. El principio de fondo es que una herramienta puede ser cualquier cosa que puedas llamar desde Maestro. Defines las entradas que pasa el agente y el handler realiza el trabajo usando tu espacio y tus propias credenciales.
¿En qué se diferencia esto de los plugins de una plataforma alojada?
osFoundry es bring-your-own-key y local-first, así que las herramientas se ejecutan desde tu espacio con tus claves y no a través de un revendedor, y no hay tarifas por usuario que limiten cuántas defines. Añades la capacidad que necesitas en vez de esperar a que una función integrada la cubra.