Ir para o conteúdo

Glossário

Ação de Agente

Uma ação de agente é uma operação selecionada ou iniciada por um agente de IA para avançar uma tarefa, descrita com um estágio explícito, como proposta, tentada ou observada como concluída.

Essa definição operacional separa a descrição de uma ação da afirmação de que seu efeito ocorreu. A unidade útil depende da pergunta: uma atualização de recurso, uma solicitação ao destino ou uma etapa de uma tarefa maior. Declare essa unidade antes de comparar registros ou contagens de ações.

Escolha uma unidade de trabalho

Uma tool call pode solicitar várias operações, e várias chamadas podem contribuir para o resultado de uma tarefa. Repetir uma solicitação cria outra tentativa sem necessariamente mudar a operação pretendida. Portanto, chamada, tarefa, tentativa e efeito não são unidades intercambiáveis.

A documentação de traces do OpenTelemetry descreve spans como unidades de trabalho ou operações e permite spans filhos para suboperações. Um span é uma representação de telemetria; sua existência não o torna a ação de negócio nem estabelece uma correspondência de um para um com um efeito externo.

Torne explícito o estágio de execução

Proposta: o sistema selecionou ou descreveu uma operação. A proposta pode ser avaliada, alterada, negada ou permanecer pendente sem que a operação protegida seja tentada. Um registro da proposta não comprova seu envio.

Tentativa: um executor começou a operação ou enviou uma solicitação em um limite especificado. Identifique esse limite: enviar uma solicitação a um intermediário não é o mesmo evento que aplicar uma alteração no destino.

Resultado observado: uma fonte informa um resultado ou estado relevante para a tentativa. Preserve o que essa fonte comprova. Uma observação posterior do estado pode mostrar que um recurso mudou sem identificar qual tentativa causou a mudança. Um timeout pode deixar o resultado desconhecido.

O guia de trilha de auditoria de agentes de IA explica como preservar a identidade, a fonte e as evidências causais necessárias para relacionar esses estágios.

Permissão e conclusão respondem a perguntas diferentes

A autorização determina se uma operação pode prosseguir em condições especificadas. Ela não informa que a operação teve sucesso. Da mesma forma, um registro de negativa precisa de evidências do executor antes de sustentar a afirmação de que o efeito protegido foi impedido.

O guia de governança pré-execução identifica onde esse efeito ainda pode ser restringido. Se o trabalho passar a outro alvo ou operação, é necessário estabelecer o escopo relevante para a proposta alterada.

Uma ação não precisa ser expressa por uma tool call em toda implementação de agente. O pilar de governança de agentes de IA conecta os mecanismos reais de execução à autoridade delegada, aos controles e às evidências.