osFoundry / Platform
Configs d'outils
Définissez de nouveaux outils en entrées + handler. Tout ce que vous pouvez appeler depuis Maestro.
Présentation
Les configurations d'outils permettent d'apprendre aux agents d'osFoundry à faire des choses qu'aucune fonction intégrée ne propose. Une configuration d'outil est une petite définition en deux parties : les entrées qu'il accepte (les paramètres nommés et leurs types) et un handler (ce qui s'exécute réellement lorsque l'outil est appelé). Une fois définie, l'outil rejoint l'ensemble des ressources que Maestro, le runtime d'agents d'osFoundry, peut invoquer pendant qu'il travaille, exactement comme il utilise le chat, la recherche ou les opérations sur fichiers. Si vous pouvez décrire une action sous la forme "voici les arguments, voici ce qui s'exécute", vous pouvez en faire un outil que vos agents appellent par son nom.
Dans osFoundry, cela vit dans Studio, aux côtés du reste de votre configuration d'agents et de workflows, si bien qu'un outil que vous définissez est disponible pour les agents, boucles et équipes que vous construisez dans le même espace de travail. Parce qu'osFoundry est bring-your-own-key et local-first, le handler s'exécute depuis votre espace avec vos propres identifiants et clés : aucun revendeur ne s'intercale entre votre agent et le service qu'il appelle, et aucune limite par siège ne restreint le nombre d'outils que vous définissez ni leur fréquence d'exécution. Le schéma d'entrées est ce que le modèle lit pour décider quand et comment appeler l'outil ; un ensemble clair d'entrées nommées est donc ce qui fait que l'agent l'utilise correctement, tandis que le handler est la partie que vous maîtrisez de bout en bout.
Pourquoi c'est important : la plupart du travail réel d'un agent dépend d'actions propres à votre stack, comme interroger une API interne, exécuter un script ou extraire des données d'un système auquel vous seul avez accès. Plutôt que d'attendre qu'une fonction couvre chaque cas, les configurations d'outils vous laissent ajouter exactement la capacité dont vous avez besoin et faire en sorte que Maestro l'utilise immédiatement. L'outil devient un bloc réutilisable : définissez-le une fois, et chaque agent ou workflow de l'espace peut l'appeler.
Fonctionnalités clés
- Définissez un outil à partir de deux pièces : les entrées qu'il reçoit et le handler qui s'exécute à l'appel
- Des entrées nommées et typées donnent au modèle un contrat clair sur quand et comment invoquer l'outil
- Tout outil que vous définissez devient appelable par son nom par Maestro, le runtime d'agents d'osFoundry
- Les handlers s'exécutent depuis votre propre espace avec vos clés : BYOK, aucun revendeur sur le chemin
- Réutilisez un outil défini à travers les agents, boucles et équipes que vous construisez dans le même Studio
Cas d’usage
- Développeur : encapsule un endpoint REST interne en outil à entrées typées pour qu'un agent l'interroge pendant une tâche sans coder l'appel en dur
- Ingénieur ops : définit un outil dont le handler exécute un script de maintenance, puis laisse un agent planifié l'invoquer comme étape de routine
- Chef d'équipe : ajoute un seul outil de recherche sur mesure dans Studio et le réutilise dans tous les agents et workflows de l'espace au lieu de le refaire pour chacun
Questions fréquentes
Qu'est-ce exactement qu'une configuration d'outil dans osFoundry ?
C'est une définition en deux parties : les entrées que l'outil accepte (ses paramètres nommés et typés) et un handler qui s'exécute lorsque l'outil est invoqué. Une fois défini, l'outil est disponible pour que Maestro l'appelle pendant qu'un agent travaille.
Que peut faire le handler d'un outil ?
Le handler est l'action qui s'exécute à l'invocation. Le principe de base : un outil peut être tout ce que vous pouvez appeler depuis Maestro. Vous définissez les entrées que l'agent transmet, et le handler réalise le travail en utilisant votre espace et vos propres identifiants.
En quoi est-ce différent des plugins d'une plateforme hébergée ?
osFoundry est bring-your-own-key et local-first : les outils s'exécutent donc depuis votre espace avec vos clés, et non via un revendeur, et aucun frais par siège ne limite le nombre que vous définissez. Vous ajoutez la capacité dont vous avez besoin au lieu d'attendre qu'une fonction intégrée la couvre.