osFoundry / Platform
Configurações de ferramentas
Defina novas ferramentas como entradas + handler. Qualquer coisa que você pode chamar do Maestro.
O que é
As configurações de ferramentas são o modo de ensinar aos agentes do osFoundry a fazer coisas que nenhum recurso integrado oferece. Uma configuração de ferramenta é uma definição pequena com duas partes: as entradas que ela aceita (os parâmetros nomeados e seus tipos) e um handler (o que de fato roda quando a ferramenta é chamada). Uma vez definida, a ferramenta passa a integrar o conjunto de recursos que o Maestro, o runtime de agentes do osFoundry, pode invocar enquanto trabalha, do mesmo jeito que usa chat, busca ou operações de arquivo. Se você consegue descrever uma ação como "estes são os argumentos e isto é o que roda", você pode transformá-la em uma ferramenta que seus agentes chamam pelo nome.
Dentro do osFoundry isso fica no Studio, ao lado do restante da configuração de agentes e fluxos de trabalho, então uma ferramenta que você define fica disponível para os agentes, loops e times que você monta no mesmo workspace. Como o osFoundry é bring-your-own-key e local-first, o handler roda a partir do seu workspace com suas próprias credenciais e chaves: não há um revendedor entre o seu agente e o serviço que ele chama, nem limite por usuário sobre quantas ferramentas você define ou com que frequência elas rodam. O esquema de entradas é o que o modelo lê para decidir quando e como chamar a ferramenta, então um conjunto claro de entradas nomeadas é o que faz o agente usá-la corretamente; o handler é a parte que você controla de ponta a ponta.
Por que isso importa: a maior parte do trabalho real de um agente depende de ações específicas da sua stack, como acessar uma API interna, rodar um script ou puxar dados de um sistema a que só você tem acesso. Em vez de esperar que um recurso cubra cada caso, as configurações de ferramentas permitem adicionar exatamente a capacidade de que você precisa e fazer o Maestro usá-la na hora. A ferramenta vira um bloco reutilizável: defina uma vez e qualquer agente ou fluxo do workspace pode chamá-la.
Principais recursos
- Defina uma ferramenta a partir de duas peças: as entradas que ela recebe e o handler que roda quando é chamada
- Entradas nomeadas e tipadas dão ao modelo um contrato claro de quando e como invocar a ferramenta
- Qualquer ferramenta que você definir passa a ser invocável pelo Maestro, o runtime de agentes do osFoundry, pelo nome
- Os handlers rodam a partir do seu próprio workspace com suas chaves: BYOK, sem revendedor no caminho
- Reutilize uma ferramenta definida nos agentes, loops e times que você monta no mesmo Studio
Casos de uso
- Desenvolvedor: encapsula um endpoint REST interno como ferramenta com entradas tipadas para que um agente o consulte durante uma tarefa sem fixar a chamada no código
- Engenheiro de operações: define uma ferramenta cujo handler roda um script de manutenção e deixa um agente agendado invocá-la como passo de rotina
- Líder de time: adiciona uma ferramenta de consulta sob medida no Studio e a reutiliza em todos os agentes e fluxos do workspace em vez de refazê-la em cada agente
Perguntas frequentes
O que é exatamente uma configuração de ferramenta no osFoundry?
É uma definição com duas partes: as entradas que a ferramenta aceita (seus parâmetros nomeados e tipados) e um handler que roda quando a ferramenta é invocada. Depois de definida, a ferramenta fica disponível para o Maestro chamar enquanto um agente trabalha.
O que o handler de uma ferramenta pode fazer?
O handler é a ação que roda na invocação. O princípio de base é que uma ferramenta pode ser qualquer coisa que você consiga chamar a partir do Maestro. Você define as entradas que o agente passa, e o handler executa o trabalho usando seu workspace e suas próprias credenciais.
Como isso difere dos plugins de uma plataforma hospedada?
O osFoundry é bring-your-own-key e local-first, então as ferramentas rodam a partir do seu workspace com suas chaves, e não por meio de um revendedor, e não há taxa por usuário limitando quantas você define. Você adiciona a capacidade de que precisa em vez de esperar por um recurso integrado que a cubra.