Como é que a conceção do esquema de ferramentas limita as ações de um agente de IA doméstico?

Eva Wong é a Redatora Técnica e e entusiasta residente na ZimaSpace. Uma geek de longa data com paixão por homelabs e software de código aberto, ela é especialista em traduzir conceitos técnicos complexos em guias acessíveis e práticos . Eva acredita que o auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ela capacita a comunidade adesmistificar configurações de hardware , desde a construção do seu primeiro NAS até dominar os contêineres Docker., from building their first NAS to mastering Docker containers.

A conceção do esquema de uma ferramenta limita um agente de IA doméstico ao restringir os parâmetros e os formatos de ação que podem tornar-se chamadas de ferramentas válidas antes da execução.

Um modelo pode continuar a raciocinar incorretamente, mas os campos tipados, os destinos obrigatórios, as enumerações e a validação reduzem aquilo que esse erro pode expressar antes de as camadas de permissão e aprovação decidirem se a ação pode ser executada.

Um esquema de ferramenta define a estrutura de um pedido permitido

Uma ferramenta de agente não é apenas um nome e uma descrição. O respetivo esquema define quais os campos que podem ser fornecidos, que tipos utilizam e que combinações são estruturalmente aceitáveis.

A especificação MCP atual exige um inputSchema definido com JSON Schema. Isto fornece ao ambiente de execução um contrato legível por máquinas, em vez de depender apenas de linguagem natural. O Model Context Protocol define ferramentas com um esquema de entrada, tornando explícita a estrutura dos argumentos aceites antes de uma chamada de ferramenta ser executada; consulte os esquemas de entrada de ferramentas MCP.

Num servidor doméstico, isto pode distinguir uma ferramenta limitada de reinício de uma shell administrativa vaga.

Uma chamada que não consegue expressar comandos arbitrários já tem uma superfície de ação menor.

Os campos obrigatórios impedem ações incompletas

As propriedades obrigatórias obrigam o modelo a fornecer as informações necessárias para uma operação. Uma ferramenta de movimentação de ficheiros pode exigir a origem e o destino; uma ferramenta de contentores pode exigir um destino e uma ação.

O MCP segue a semântica de validação do JSON Schema, que permite propriedades obrigatórias e restrições de tipo. A validação JSON Schema define propriedades obrigatórias e outras asserções estruturais capazes de rejeitar pedidos incompletos, apoiando a camada de restrições do vocabulário de validação JSON Schema.

Isto impede o código da aplicação de adivinhar destinos em falta ou de herdar predefinições perigosas. A ausência torna-se uma falha de validação, em vez de uma ação implícita.

As enumerações e os intervalos eliminam ações que o modelo não consegue expressar

Um esquema pode restringir um campo a um conjunto enumerado ou a um intervalo limitado. Se a ação apenas permitir reiniciar, parar e iniciar, eliminar não pode passar por esse campo.

O MCP exige que os argumentos das ferramentas estejam em conformidade com o esquema de entrada da ferramenta. As restrições estruturais são mais fortes do que uma descrição que apenas indica o que deve acontecer normalmente. Os esquemas OpenAPI podem expressar valores enumerados, limites numéricos e propriedades tipadas, ilustrando como uma ferramenta pode tornar as ações inválidas irrepresentáveis através das definições de esquemas OpenAPI.

Em casa, o mesmo mecanismo pode limitar valores do termóstato, dias de retenção, nomes de serviços ou destinos de cópia de segurança, mantendo explícito o vocabulário de ações.

As descrições orientam a seleção, mas a validação impõe a estrutura

As descrições em linguagem natural ajudam o modelo a escolher uma ferramenta e a interpretar os campos, mas não impõem o mesmo limite que um validador que rejeita chamadas fora do contrato.

O MCP descreve as descrições de ferramentas como uma indicação legível por humanos para ajudar o modelo a compreender, enquanto o inputSchema fornece o contrato formal dos parâmetros. A utilização de ferramentas da Anthropic baseia-se em parâmetros de ferramentas declarados para orientar as chamadas geradas pelo modelo, mas essa orientação continua a ser diferente da validação em tempo de execução, conforme explicado nos esquemas de utilização de ferramentas da Anthropic.

Isto distingue o tema do artigo da ZimaSpace sobre a perda de fiabilidade da seleção de ferramentas quando existem demasiadas ferramentas disponíveis. A ambiguidade da seleção ocorre antes de uma ferramenta ser escolhida; as restrições do esquema aplicam-se à própria chamada candidata.

A validação do esquema não concede permissões

Um pedido estruturalmente válido pode continuar a não ser autorizado. O esquema pode permitir restart(container=postgres), enquanto o autor da chamada apenas tem permissão para reiniciar um contentor de multimédia.

O MCP trata a utilização de ferramentas como uma interação com sistemas externos e recomenda controlos de segurança e aprovação humana em torno da invocação. A correção do esquema é uma camada, não um sistema de permissões completo. A chamada de funções do Google Gemini também utiliza declarações de funções estruturadas, enquanto a autorização permanece fora do próprio esquema; essa separação é sustentada pelos esquemas de chamada de funções do Gemini.

Esse limite relaciona-se com os limites do âmbito das ferramentas de um agente de IA doméstico: o esquema restringe os parâmetros representáveis, enquanto o âmbito e as capacidades determinam quais as operações válidas que são realmente autorizadas.

Os esquemas mais pequenos são mais fáceis de testar e auditar

Uma ferramenta abrangente, com muitos campos opcionais, cria inúmeras combinações válidas.

Limitar as ferramentas reduz o número de comportamentos que a avaliação tem de abranger.

O JSON Schema suporta propriedades de objetos, membros obrigatórios e o controlo de propriedades adicionais, podendo rejeitar campos inesperados em vez de os aceitar silenciosamente. O Pydantic pode gerar esquemas legíveis por máquinas a partir de modelos tipados, ilustrando por que motivo os esquemas mais pequenos e explícitos são mais fáceis de validar e testar na geração de JSON Schema do Pydantic.

Os testes podem então enumerar ações permitidas, combinações inválidas, valores-limite e comportamentos de rejeição antes de o modelo ser ligado a ficheiros, contentores, dispositivos ou sistemas de cópia de segurança.

Centro de Tecnologia e IA

Mais para Ler

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.