Como escrever um prompt que pede saída estruturada

Descreva a forma exata que você quer, não apenas o nome do formato

Dizer "retorne isso como JSON" é um começo, mas nomear os campos, sua ordem e seus tipos é o que realmente elimina a ambiguidade — "retorne um objeto JSON com um campo de string chamado title e um campo de array chamado steps, onde cada step é uma string" deixa muito menos para o modelo adivinhar do que "retorne JSON com o title e os steps." O mesmo se aplica a uma tabela: nomeie as colunas e o que pertence a cada uma, em vez de assumir que o modelo escolherá a mesma divisão que você tem em mente.

Mostre um exemplo da saída exata que você quer

Um único exemplo da forma finalizada — uma pequena amostra de objeto JSON, ou uma linha da tabela — muitas vezes elimina mais ambiguidade do que outro parágrafo de descrição, pelo mesmo motivo que um exemplo ajuda no few-shot prompting, linkado abaixo. Isso importa mais quando o formato tem uma particularidade fácil de descrever de forma imprecisa, como se um campo é opcional ou como um valor ausente deve ser representado.

O que um prompt bem escrito não garante aqui

Um prompt cuidadosamente escrito torna mais provável uma saída válida e bem formada, mas não garante isso — um modelo ainda pode retornar JSON malformado, um campo extra, ou texto envolvendo a estrutura que você pediu, especialmente numa resposta mais longa ou mais complexa. Veja o que são saídas de IA estruturadas, linkado abaixo, para os mecanismos técnicos — como a geração restrita por esquema — que existem especificamente porque o prompt sozinho não é uma garantia confiável, e para o que a ClawAI faz de diferente de apenas pedir educadamente num prompt.

Perguntas frequentes

Pedir educadamente num prompt é suficiente para garantir um JSON válido?

Não — um prompt bem escrito torna isso mais provável, não certo. Veja o que são saídas de IA estruturadas, linkado abaixo, para os mecanismos que existem porque o prompt sozinho não garante de forma confiável uma estrutura válida.

Devo descrever o formato ou mostrar um exemplo?

Ambos, quando o formato tiver qualquer ambiguidade — uma descrição precisa dos campos mais um exemplo da forma finalizada cobre mais casos do que qualquer um dos dois sozinho. Veja few-shot prompting, linkado abaixo, para saber como escolher um bom exemplo.

Qual é a diferença entre este guia e o que são saídas de IA estruturadas?

Aquela página explica o mecanismo técnico por trás de uma saída estruturada confiável; esta página é o complemento prático — como escrever o próprio prompt. Elas são feitas para serem lidas juntas, não como duplicatas uma da outra.