Ferramentas · · 5 min. lendo

Para que serve o OpenAI Agents SDK: confirmações sobre argumentos verificados

Aprovar a ação exatamente na forma em que será executada, sem perder o motivo da recusa quando a sessão é retomada.

Resposta curta

O que dá a aprovação sobre argumentos verificados no OpenAI Agents SDK?

A versão 0.22.3, de 17 de setembro de 2026, alinha as confirmações condicionais com os argumentos verificados da chamada da ferramenta e transmite o resultado «ferramenta não encontrada» ao retomar uma sessão gerida pelo servidor. A confirmação refere-se a uma ação concreta, pelo que a decisão humana deve assentar nos dados que serão realmente utilizados.

Elena Artemova · Елена Артемова · Publicado · Atualizado · Objetivo da ferramenta · Com exemplo de aplicação.

A confirmação é um acordo sobre uma ação concreta

Quem confirma uma ação não concorda com uma intenção, mas com uma chamada concreta: o nome da operação e os seus argumentos. Se, depois da aprovação, os argumentos forem convertidos noutra forma, completados com valores por omissão ou reconstruídos, o consentimento dizia respeito a outra ação.

Por isso, verificar as confirmações condicionais já sobre os argumentos verificados não é uma correção cosmética. Restitui o sentido da aprovação: à decisão chega o mesmo objeto que depois segue para a ferramenta. É uma regra geral para qualquer sistema em que uma pessoa participa no ciclo.

O que mudou na versão 0.22.3

Além das aprovações, a versão de 17 de setembro de 2026 enumera: a transmissão do resultado «ferramenta não encontrada» ao retomar uma sessão gerida pelo servidor; a preservação dos caminhos de comando em formato POSIX num nó com Windows; o arranque simultâneo correto do armazenamento de sessões; a inclusão das chamadas de shell e das edições de ficheiros nos dados de utilização das ferramentas; e o termo dos processos filhos quando o fluxo é fechado prematuramente.

Cada ponto parece pequeno, mas todos dizem respeito ao mesmo: o ambiente de execução deve descrever o que aconteceu de forma idêntica antes e depois de uma interrupção.

A retoma não deve ser silenciosa

Depois de uma interrupção, o estado divide-se em duas partes: o que foi decidido antes e o que está disponível agora. Se, ao retomar, a ferramenta já não estiver acessível, essa diferença tem de ser nomeada. Uma continuação silenciosa produz um relatório em que a ação aparece como executada, embora não tenha sido.

É uma causa comum de erro em processos longos. Aqui, observabilidade não significa volume de registos, mas coincidência entre a descrição e o facto. O ponto sobre os processos filhos é da mesma família: uma sessão terminada não deve deixar processos a correr.

Pormenores que se transformam em falhas

A contabilização das chamadas de shell e das edições de ficheiros é importante para os limites: se essas ações não entram no relatório, o limite de consumo é calculado com dados incompletos. A diferença de caminhos entre sistemas afeta o isolamento: a mesma entrada pode conduzir a diretórios diferentes.

A conclusão prática é simples: não se podem fixar limites nem verificar o isolamento num ambiente onde a contabilização e o tempo de vida dos processos são aproximados. Primeiro, a descrição tem de se tornar exata; só depois se pode confiar nela.

Exemplo Ilustrativo

Confirmação de uma ação com argumentos alterados

Problema
Num processo hipotético, o agente propõe alterar um registo. A pessoa confirma a chamada, mas a aplicação completa depois os argumentos com valores por omissão.
O papel da ferramenta
A confirmação é verificada com o mesmo conjunto de argumentos que segue para a ferramenta. Se o conjunto mudar depois da verificação, a aprovação é pedida de novo.
Resultado esperado
O resultado esperado é que o consentimento da pessoa corresponda à ação efetivamente executada e que a divergência de argumentos não passe despercebida.
O que verificar
Se a confirmação for verificada antes da normalização dos argumentos, a verificação existe na forma, mas não há decisão quanto ao essencial. O exemplo é ilustrativo.

Uma confirmação só faz sentido quando se refere aos argumentos com que a ação será executada.

Fonte e razões

Data de lançamento:

A fonte primária descreve o instrumento e seu desenvolvimento. Conclusões sobre a escolha – análise editorial do laboratório. Um exemplo explica a finalidade da ferramenta; nenhuma medição foi realizada nele. Data de origem verificada em 8 de setembro de 2026.

Perguntas sobre o tema

Que risco há em confirmar antes de verificar os argumentos?

A pessoa concorda com uma chamada e executa-se outra. Formalmente há aprovação, mas não no essencial.

Porque é importante uma recusa explícita ao retomar?

Caso contrário, o relatório descreve a ação como executada, embora a ferramenta estivesse indisponível.

Para que serve contabilizar as chamadas de shell no relatório?

Caso contrário, o limite de consumo e a avaliação do trabalho assentam em dados incompletos.