Saída estruturada e chamada de ferramenta
Os dados estruturados ajudam o software a ler uma resposta, mas tanto a estrutura quanto o significado requerem validação.
O que você aprenderá
- Explique: o modelo propõe, a ferramenta executa
- Aplique a ideia em um exemplo: Saída estruturada e chamada de ferramenta
- Reconheça as limitações e verifique o resultado do exercício
Os dados estruturados ajudam o software a ler uma resposta, mas tanto a estrutura quanto o significado requerem validação.
Você pode seguir este curso sem conta ou programação. Os exemplos usam dados sintéticos e os resultados da IA precisam ser verificados.
Como funciona, passo a passo
O modelo propõe, a ferramenta executa
A chamada da ferramenta produz uma solicitação de chamada com nome e argumentos. A aplicação valida o esquema, as permissões e os limites antes da execução. O resultado retorna ao contexto para a próxima etapa. Por exemplo, get_product_stock pega um SKU e retorna uma quantidade; sua descrição deverá explicar que não reserva produtos. Distinguir resultados vazios, erros de validação, falta de acesso e tempos limite. JSON válido não prova que os argumentos estão corretos ou que a ação está autorizada. Para efeitos externos, considere também a execução duplicada.
Uma instrução é um contrato
Um bom prompt especifica a tarefa, os dados disponíveis, o formato de saída e os critérios de sucesso. Separe a função dos dados e inclua um exemplo para casos ambíguos. “Seja preciso” é mais fraco do que “indique apenas o prazo na apólice fornecida; se faltar, peça esclarecimentos”. Poucas fotos significam alguns exemplos resolvidos, não uma lista interminável. O conteúdo do documento permanece como dados mesmo quando contém comandos. Os delimitadores ajudam, mas o software deve impor permissões e validação em vez de depender do prompt.
Verifique o acesso antes de usar
As permissões devem ser aplicadas pelos servidores e pela camada de dados. Não deixe o modelo decidir se um usuário pode ver um documento. Filtre as fontes antes que elas entrem no contexto, não depois de gerar a resposta. Use credenciais de acesso mínimo, mantenha-as fora de prompts, capturas de tela e códigos do navegador e alterne as chaves expostas. Uma lista de permissões de domínio de widget não substitui a autenticação de API. A autenticação identifica você; a autorização determina as operações e os dados que você pode usar. Teste o acesso negado também.
O esquema explicativo
Siga as setas sólidas para o fluxo principal. As setas azuis tracejadas fornecem dados ou contexto; setas rosa tracejadas mostram feedback ou retorno de resultados. Cores e formas distinguem modelos, lojas, decisões e resultados. Em telas pequenas, role na horizontal para acompanhar o esquema completo.
Um exemplo completo
Um classificador retorna categoria e needs_review. JSON com categoria="refund_now" é sintaticamente válido, mas viola categorias permitidas e não autoriza reembolso.
{"category":"returns","needs_review":false}
Experimente você mesmo
- Defina um esquema e teste uma categoria desconhecida e um campo ausente.
- Registre a entrada, a fonte e o resultado esperado antes de executar o experimento. Use apenas os dados fictícios do exemplo.
- Siga as etapas do diagrama. A cada passo registre quais informações são recebidas e produzidas; não confunda o resultado intermediário com o resultado final.
- Repita após remover as informações necessárias ou tornar a entrada ambígua. Verifique se o sistema esclarece, interrompe ou inventa uma resposta.
- Compare com a solução explicada. Guarde a configuração, data, resultado e explicação das diferenças. Mude uma coisa e teste novamente.
Uma solução explicada
O validador aceita apenas entrega, devolução ou produto e um booleano; as ações permanecem separadas. Um exercício bem-sucedido permite mostrar a conexão entre entradas, etapas e resultados. Quando falta informação, uma resposta cautelosa é mais útil do que detalhes inventados. Compare mais do que estilo: verifique também as condições, fontes e operações.
Quando esta abordagem ajuda e quais são seus limites
JSON sintaticamente correto não é semanticamente correto. Escolha esta abordagem quando ela melhorar uma necessidade medida. Mantenha uma linha de base simples e compare os resultados usando dados idênticos. Um exemplo de sucesso não estabelece confiabilidade em todas as situações.
Verifique o que aprendeu
Quem executa uma chamada proposta pelo modelo?
O aplicativo ou serviço de host após a validação. O modelo não obtém automaticamente acesso irrestrito.
Um prompt pode substituir o controle de acesso?
Não. Uma instrução não é um limite de autorização.
Que resultado este exercício deve produzir?
O validador aceita apenas entrega, devolução ou produto e um booleano; as ações permanecem separadas.
Termos para lembrar
- Chamada de ferramenta: uma solicitação estruturada para usar um recurso externo.
- Poucos tiros: Exemplos resolvidos fornecidos no contexto.
- Autorizar / Autorização: Verificando o direito de acesso a uma operação ou recurso.
Fontes e sua próxima etapa
Para preparar: P04 — Como escolher um modelo de IA adequado