osFoundry / Platform
Config strumenti
Definisci nuovi strumenti come input + handler. Qualsiasi cosa tu possa richiamare da Maestro.
Che cos’è
Le configurazioni degli strumenti sono il modo per insegnare agli agenti di osFoundry a fare cose che nessuna funzione integrata ti offre. Una configurazione di strumento è una piccola definizione con due parti: gli input che accetta (i parametri con nome e i loro tipi) e un handler (ciò che viene realmente eseguito quando lo strumento viene chiamato). Una volta definito, lo strumento entra nell'insieme delle risorse che Maestro, il runtime degli agenti di osFoundry, può invocare mentre lavora, esattamente come usa chat, ricerca o operazioni sui file. Se puoi descrivere un'azione come "questi sono gli argomenti, questo è ciò che viene eseguito", puoi trasformarla in uno strumento che i tuoi agenti chiamano per nome.
Dentro osFoundry questo vive in Studio, accanto al resto della configurazione di agenti e workflow, così uno strumento che definisci è disponibile per gli agenti, i loop e i team che costruisci nello stesso workspace. Poiché osFoundry è bring-your-own-key e local-first, l'handler viene eseguito dal tuo workspace con le tue credenziali e chiavi: nessun rivenditore si frappone tra il tuo agente e il servizio che chiama, e nessun limite per postazione vincola quanti strumenti definisci o con quale frequenza girano. Lo schema degli input è ciò che il modello legge per decidere quando e come chiamare lo strumento, quindi un insieme chiaro di input con nome è ciò che fa sì che l'agente lo usi correttamente; l'handler è la parte che controlli dall'inizio alla fine.
Perché conta: gran parte del lavoro reale di un agente dipende da azioni specifiche del tuo stack, come interrogare un'API interna, eseguire uno script o estrarre dati da un sistema a cui solo tu hai accesso. Invece di aspettare che una funzione copra ogni caso, le configurazioni di strumenti ti permettono di aggiungere esattamente la capacità che ti serve e far sì che Maestro la usi subito. Lo strumento diventa un blocco riutilizzabile: definiscilo una volta e ogni agente o workflow del workspace può chiamarlo.
Funzionalità principali
- Definisci uno strumento da due pezzi: gli input che riceve e l'handler che gira quando viene chiamato
- Input con nome e tipizzati danno al modello un contratto chiaro su quando e come invocare lo strumento
- Qualsiasi strumento che definisci diventa invocabile per nome da Maestro, il runtime degli agenti di osFoundry
- Gli handler girano dal tuo workspace con le tue chiavi: BYOK, nessun rivenditore lungo il percorso
- Riutilizza uno strumento definito tra gli agenti, i loop e i team che costruisci nello stesso Studio
Casi d’uso
- Sviluppatore: incapsula un endpoint REST interno come strumento con input tipizzati, così un agente lo interroga durante un task senza cablare la chiamata nel codice
- Ingegnere ops: definisce uno strumento il cui handler esegue uno script di manutenzione, poi lascia che un agente pianificato lo invochi come passo di routine
- Team lead: aggiunge in Studio un unico strumento di lookup su misura e lo riutilizza in ogni agente e workflow del workspace invece di ricostruirlo per ciascun agente
Domande frequenti
Cos'è esattamente una configurazione di strumento in osFoundry?
È una definizione con due parti: gli input che lo strumento accetta (i suoi parametri con nome e tipizzati) e un handler che gira quando lo strumento viene invocato. Dopo la definizione, lo strumento è disponibile perché Maestro lo chiami mentre un agente lavora.
Cosa può fare l'handler di uno strumento?
L'handler è l'azione che gira all'invocazione. Il principio di base è che uno strumento può essere qualsiasi cosa tu possa chiamare da Maestro. Definisci gli input che l'agente passa, e l'handler svolge il lavoro usando il tuo workspace e le tue credenziali.
In cosa differisce dai plugin di una piattaforma hosted?
osFoundry è bring-your-own-key e local-first, quindi gli strumenti girano dal tuo workspace con le tue chiavi anziché tramite un rivenditore, e non ci sono costi per postazione che limitano quanti ne definisci. Aggiungi la capacità che ti serve invece di aspettare che una funzione integrata la copra.