Uma tool call é uma solicitação para realizar uma operação por uma interface de ferramenta, identificando a ferramenta ou operação e fornecendo as entradas exigidas pela interface.
Essa definição operacional descreve a solicitação. Para interpretar um evento ou diagrama, identifique também seu estágio: uma chamada proposta pode ainda não ter sido enviada, uma invocação pode aguardar resposta, e uma resposta concluída pode deixar o efeito externo sem confirmação. A expressão “tool call”, sozinha, não distingue esses estados.
O que a solicitação contém
A interface determina o identificador da operação e as entradas obrigatórias, frequentemente chamadas de argumentos. Elas podem selecionar um recurso, fornecer material para processamento ou especificar uma alteração. O mesmo nome de ferramenta, com entradas diferentes, pode descrever operações com exigências de autorização diferentes.
A especificação de Tools do MCP representa uma chamada por meio de um nome de ferramenta e argumentos, e distingue erros de protocolo de erros reportados pela ferramenta. Essa é a representação de um protocolo específico. Uma tool call não exige MCP, uma solicitação de rede ou o mesmo formato de entrada em todas as implementações de agentes.
Uma chamada proposta não comprova um efeito
Um agente de IA pode selecionar uma operação como parte de uma tarefa. Se a solicitação proposta está retida para avaliação de política, sua presença no fluxo não comprova que a operação protegida ocorreu. Mesmo quando o serviço de uma ferramenta recebe a solicitação, uma ação posterior no destino ainda pode estar pendente.
Exemplo hipotético: um agente propõe consultar os metadados de um documento. Um registro da proposta não comprova seu envio. Uma resposta da ferramenta que informa uma falha de acesso não comprova que os metadados solicitados foram retornados. O significado de cada observação depende de onde ela foi produzida e do que registra.
Invocação, resultado e ação têm escopos diferentes
Uma ferramenta pode realizar trabalho localmente ou delegá-lo a outro componente. Uma invocação pode levar a várias operações, e uma tarefa pode exigir várias chamadas. Não presuma uma correspondência de um para um entre uma chamada e um efeito externo.
A tentativa de uma ação e seu resultado precisam de evidências apropriadas ao executor e ao destino. Um timeout pode deixar o resultado sem resolução; uma decisão de permissão autoriza uma tentativa sem garantir sua conclusão. Da mesma forma, nem toda ação de agente precisa ser expressa como uma tool call.
O guia de arquitetura de governança de agentes de IA explica como conectar chamadas propostas, decisões de política, execução e evidências sem tratar a proposta como uma ação concluída.