Voltar às perguntas frequentes sobre Agente
CENTRAL DE AJUDA · FAQAgente2 min de leitura

Posso exigir uma resposta estruturada?

Um esquema é útil quando um programa vai consumir a resposta, em vez de apenas exibi-la como texto. Defina os campos e tipos esperados e valide os dados retornados antes de usá-los.

Agente

Defina o contrato de saída

Liste os campos necessários à próxima etapa e escolha um tipo adequado para cada um. Mantenha o esquema focado no resultado necessário. Um contrato conciso é mais fácil de cumprir e validar do que uma lista de detalhes opcionais.

Marque como obrigatórios os campos sem os quais sua aplicação não pode continuar. Se um valor puder estar ausente, decida como representar essa ausência em vez de deixar o formato implícito. O esquema descreve a forma; a instrução ainda precisa explicar a tarefa e o significado dos campos.

Valide antes de agir

Trate a saída estruturada como dados que ainda precisam ser validados. Confira os campos obrigatórios, os tipos e a coerência com o caso de uso. Uma resposta que pode ser analisada ainda pode estar incompleta ou semanticamente incorreta.

Se a validação falhar, indique qual campo precisa ser corrigido e solicite uma nova resposta com esse contexto. Não envie dados malformados silenciosamente para um banco, workflow ou serviço externo. Separar geração e validação torna a automação mais confiável.

Voltar às perguntas frequentes sobre Agente