Docs
PlataformaAgentes

Tools

As tools que o agente pode chamar, por server, a expiração de cada uma e o painel da ligação agente · server · tool.

A segunda pergunta é se o agente pode chamar aquela tool daquele server. A coluna Servers and tools responde. Cada tool é uma relação própria: poder chamar uma tool do GitHub não dá acesso a nenhuma outra, nem às tools que o server publicar depois.

O painel da tool

Clicar numa tool, ou na ligação do agente até ela, abre o painel mais importante do agente, porque é nele que ficam as regras:

Tool selecionada no grafo

Painel de uma tool com as regras

O título é o caminho da ligação: o agente e o server na primeira linha, a tool na segunda ("refunds-assistant → Acme Billing", depois refund_order). Abaixo, o painel tem três partes:

ParteO que mostra
ExpiresNever ou On a date. Escolher uma data abre o calendário na hora. Uma nota diz o efeito: "refunds-assistant can call refund_order until you remove it", ou que depois do dia o agente não chama mais a tool e as chamadas são negadas
RulesAs regras desta ligação, cada uma com nome e Reads as com a frase dela (uma regra em CEL avançado aparece em CEL). Uma regra ainda não publicada mostra New in draft. Abaixo das regras, os Trusted attributes que elas podem ler das suas context sources, e o link Add trusted attributes in Context sources →
RodapéRemove access, que pede confirmação

Uma regra nesta ligação não afeta outra tool nem outro agente. Add rule abre o editor de regras (Regras).

O link para Context sources leva o agente e a tool. A página mostra um aviso, "Adding trusted attributes for refunds-assistant · refund_order", e Back to refunds-assistant · refund_order reabre este painel.

Remove access tira a tool só deste agente: ele não chama mais a tool, e as regras desta ligação saem junto. A tool continua no server para outros agentes. A mudança vai para o rascunho.

Manage tools

Manage tools, na barra de seção, lista as tools revisadas, por server:

Painel Manage tools

Tools já concedidas aparecem marcadas e desabilitadas, com "Already granted". Embaixo, Expires vale para todas as tools marcadas de uma vez, e Add N to draft inclui. Para tirar uma tool, abra a tool e use Remove access.

Uma tool que não passou pela revisão não aparece aqui. Isso impede que uma tool nova de um server entre num agente sem ninguém olhar o schema dela.

Expiração de uma tool

A expiração serve para acessos com prazo: um agente que pode emitir reembolsos até o fim de uma campanha, uma tool liberada durante uma migração. Depois da data, o OpenFGA ignora a relação, e a próxima chamada é negada com no_grant. A marca de relógio no grafo mostra essas ligações.