Subsídios para ferramentas
Which agent may call what, and on what terms. The same tool is a different risk in two agents' hands, which is why the limits live on the grant rather than on the tool.
Onde encontrar
- Módulo: IA Agética
- Grupo: Construir e orquestrar
- Seção: Construir
- Tela: Subsídios para ferramentas
Endereço no console: /agentic/agent-tools
Lista · 14 colunas · 8 campos em seu formulário · 2 deles exigido
O que a lista mostra
Estas são as colunas da lista, na ordem em que são exibidas. Qualquer uma delas pode ser usada para ordenar, filtrar, ocultar ou exportar.
| Coluna | Tipo | Nome do campo |
|---|---|---|
| Agente | Texto | agent_name |
| Ferramenta | Texto | tool_name |
| Tipo | Status | tool_kind |
| Dados de alterações | Sim ou não? | is_write |
| Movimenta dinheiro | Sim ou não? | moves_money |
| Dados pessoais | Sim ou não? | touches_pii |
| Estende a mão | Sim ou não? | is_external |
| Sempre pergunte a uma pessoa. | Sim ou não? | requires_approval |
| Chamadas (30d) | Número | calls_30d |
| Habilitado | Sim ou não? | is_enabled |
| Argumentos fixos | Texto | bound_args |
| Somente quando | Texto | precondition |
| Chamadas por execução | Número | max_calls_per_run |
| Since publish | Texto | since_publish |
O formulário
O que é solicitado aqui quando um registro é criado. Os campos obrigatórios estão marcados; uma opção selecionada de uma lista de configuração é uma que um administrador pode estender sem uma nova autorização.
| Campo | Tipo | Escolhas | Notas |
|---|---|---|---|
| Agente obrigatório | Escolha | Consultado em registros existentes | |
| Ferramenta obrigatório | Escolha | Consultado em registros existentes | |
| Argumentos fixos | Texto | Values this agent must always use with this tool, written as JSON: names and values in braces, like the example in the box. They replace anything the agent chooses for the same name, so {"business_unit_id": "BU-01"} keeps it working in that business unit only. Leave empty for none. | |
| Somente quando | Texto longo | A condition every call must meet, written on what the call sends: the name of one of the tool's inputs, a comparison (=, <>, <, <=, >, >=) and a value, joined with and / or -- for example amount <= 5000, or status = 'draft'. A call that does not meet it, or does not send what it names, is refused and the agent is told why. Checked when you save. Leave empty to allow every call. | |
| Chamadas por execução | Número | The most times the agent may use this tool in one run, as a whole number. Further calls are refused and counted as Refused calls on the run. Empty: no limit of its own (the agent's own tool-call limit still applies). 0: the tool cannot be called at all. | |
| Unidade organizacional | Escolha | Consultado em registros existentes | Which business unit or department this record belongs to. Defaults to the unit selected in the top bar. |
| Sempre pergunte a uma pessoa. | Sim ou não? | If ticked, every call to this tool waits until a person approves it. The request appears in Agentic AI › Agent Approvals, where anyone whose role may act on Agent Approvals approves or declines it; the agent's run waits until then. | |
| Habilitado | Sim ou não? | Untick to withdraw the grant without deleting it. It stops at once, without a Publish. |
As regras que se aplicam aqui
Tudo nesta tela obedece às regras da plataforma, e não a regras próprias. Algumas informações importantes que você precisa saber antes de usar:
- Reduzindo uma lista — Pesquisa, condições, ordenação, totais, exportação e visualizações salvas.
- O que pode ser alterado — Os cinco motivos pelos quais um registro não pode ser editado.
- Empresas e unidades de negócios — O que o seletor acima desta lista está fazendo com ele.
- Criar um registro — campos obrigatórios, de onde vêm as opções e como o número é alocado.
- Importar uma planilha — Esta tela aceita um, e funciona das mesmas regras que a digitação.