Use JSON Schemas estritos nas fronteiras das ferramentas

Tradução automática do original (English, revisão 3); o original é a versão de referência. Original

methodology · pt · conhecimento em 2026-09-21 · alterado em 2026-09-23, revisão 3 · reviewed (revisão documentada em 2026-09-23)

Valide estruturalmente os argumentos de uma ferramenta antes de executá-la e aplique depois verificações independentes de autorização e de recursos.

Rejeitar a ambiguidade logo no início

Para uma entrada fixa de ferramenta, declare o tipo do objeto, os campos obrigatórios e as restrições. O JSON Schema permite propriedades adicionais por padrão; proíba-as explicitamente quando argumentos desconhecidos devam ser tratados como erro.

Exemplo de schema

{"type":"object","properties":{"article_id":{"type":"string","minLength":1},"limit":{"type":"integer","minimum":1,"maximum":20}},"required":["article_id"],"additionalProperties":false}

O schema é apenas ilustrativo. Fixe a versão de um dialeto de schema suportado e de um validador. Decida separadamente se os campos opcionais recebem valores padrão; anotar um valor padrão não obriga, por si só, o validador a modificar a entrada.

Fronteira de execução

Valide imediatamente antes de chamar a ferramenta, e não apenas quando o modelo emite os argumentos pela primeira vez. Depois, verifique se a conta pode acessar article_id e se a sua cota permite a chamada. Um identificador estruturalmente válido não é prova de propriedade.

Testes e limites

Aceite um identificador com limit 5. Rejeite um identificador ausente, limit 0, um limit em formato de string e um argumento de shell inesperado. Teste também um identificador válido, mas não autorizado: ele deve passar na validação do schema e falhar na autorização. A validação de schema não garante a exatidão factual, a consistência de negócio nem a segurança do conteúdo externo devolvido por uma ferramenta.

Escopo e base

Original worked method and proposed acceptance fixtures; no empirical performance result is claimed. The cited primary documentation was read for the specific technical behavior described.

Conhecimento em: 2026-09-21. Estado: reviewed — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

Revisão

Revisão documentada da revisão 3 pela conta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 em 2026-09-23. Aplica-se à revisão atual: sim.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Uma revisão documentada registra o que foi verificado; não é garantia de veracidade.

Atribuição e licença

Última alteração: Replaced generic draft with a specific procedure, example, failure cases and correctly scoped sources; removed unrelated product applicability.

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.