Avançado: estrutura
Instruções, opções de Choice, níveis de Score e criteria de Noul aceitam todos estrutura JSON.
Os modelos System One são treinados para entender estrutura.
Onde a estrutura é permitida
Todos estes campos são um EntryType.
| Campo | Aplica-se a | Forma aceita |
|---|---|---|
instructions |
Choice, Score, Noul | string, object, array ou null |
valores de criteria (descrições de opções) |
Choice | string, object, array ou null |
entradas de criteria (descrições de níveis) |
Score | string, object, array ou null |
criteria.true e criteria.false |
Noul | string, object, array ou null |
Quando estruturar uma pergunta
- Quando ajuda na clareza. Quando uma pergunta tem várias partes, colocá-las em forma de JSON ajuda na clareza porque as chaves estão rotuladas.
- Quando a pergunta precisa de dados de apoio. Um schema, uma taxonomia ou uma linha de banco de dados já são JSON. Use o JSON inteiro ou passe os subcampos relevantes, em vez de serializá-los num template de string.
Instruções estruturadas
Um objeto field descreve o campo que está sendo verificado, e cada pergunta se refere a ele pela chave. A mesma forma orienta um Noul que verifica um valor, um Choice que escolhe um entre candidatos e dois Scores que situam um valor numa escala.
{
"state": {
"source_text": "Invoice #4471 issued March 3, 2026 to Beaver Dam Logistics for $12,840.00, net 30."
},
"questions": {
"invoice_number_is_correct": {
"type": "noul",
"instructions": {
"field": {
"name": "invoice_number",
"type": "string",
"description": "The identifier printed on the invoice."
},
"extracted_value": "4471",
"question": "Does `extracted_value` match the `field` as it appears in `source_text`?"
}
},
"customer_name": {
"type": "choice",
"instructions": {
"field": {
"name": "customer_name",
"type": "string",
"description": "The organization the invoice was issued to."
},
"question": "Which option is the value of `field` in `source_text`?"
},
"criteria": {
"Beaver Logistics": null,
"Dam Logistics": null,
"Beaver Dam Logistics": null,
"Beaver": null,
"Dam": null
}
},
"amount_due": {
"type": "score",
"instructions": {
"field": {
"name": "amount_due",
"type": "number",
"unit": "USD",
"description": "The total the invoice asks to be paid."
},
"question": "How large is the `field` value in `source_text`?"
},
"criteria": [
"Under $1,000",
"$1,000 to $10,000",
"$10,000 to $100,000",
"$100,000 to $1,000,000",
"Over $1,000,000"
]
},
"payment_terms": {
"type": "score",
"instructions": {
"field": {
"name": "payment_terms",
"type": "integer",
"unit": "days",
"description": "Days allowed for payment, from terms such as \"net 30\"."
},
"question": "How many days does the `field` in `source_text` allow for payment?"
},
"criteria": [
"Due on receipt",
"Net 10",
"Net 30",
"Net 60",
"Net 90"
]
}
}
}No código, você poderia percorrer em loop os registros potenciais e construir uma dessas perguntas por campo, todas enviadas numa única chamada. O cookbook de cascata SDE faz algo parecido com isso.
Arrays também funcionam. Use um quando a instrução for uma lista de coisas a verificar ou comparar:
"instructions": {
"question": "Does the claimed sender identity conflict with the sending domain?",
"compare": ["ticket.sender.display_name", "ticket.sender.email"],
"focus": "Compare the named organization with the email domain."
}Opções de Choice estruturadas
A descrição de uma opção de Choice também pode ser um objeto estruturado.
Rúbrica JSON para esclarecer limites
{
"state": "I ordered the standing desk two weeks ago and tracking still says label created. Was I even charged?",
"questions": {
"department": {
"type": "choice",
"instructions": {
"question": "Which team should handle this message?",
"focus": "Classify the customer's primary request, not every topic mentioned."
},
"criteria": {
"billing": {
"what": "Charges, invoices, refunds, or subscriptions",
"not_for": "Order tracking or account access",
"examples": [
"I was charged twice",
"Where is my refund?"
]
},
"orders": {
"what": "Order status, delivery, cancellation, or returns",
"not_for": "Charges or account access",
"examples": [
"Where is my package?",
"Cancel my order"
]
},
"account": {
"what": "Login, password, profile, or security",
"not_for": "Charges or delivery",
"examples": [
"I can't log in",
"Change my email"
]
}
}
}
}
}O exemplo mostra ao modelo o que cada opção cobre e o que não cobre. Ele afina o limite entre as opções.
Percorrer uma taxonomia
Para classificar numa taxonomia profunda, faça um Choice por nível e percorra a árvore no código. A cada passo, as opções são os filhos do nó atual, e o valor de cada opção é a árvore do filho. Fazer isso permite que o modelo veja o que existe sob um ramo antes de se comprometer com ele, o que importa quando o item pertence a uma folha cujo nome não é óbvio só pelo nome do ramo.
Aqui o estado é um anúncio de produto e a primeira pergunta escolhe um departamento de nível superior.
{
"state": "32oz plastic bottle with a flip straw lid. Fits most bike cages.",
"questions": {
"department": {
"type": "choice",
"instructions": "Which top-level department does this product belong to?",
"criteria": {
"Sporting Goods": {
"Cycling": [
"Bike Bottles & Cages",
"Bike Lights",
"Helmets"
],
"Fitness": [
"Yoga Mats",
"Resistance Bands"
],
"Outdoor": [
"Tents",
"Sleeping Bags",
"Hydration Packs"
]
},
"Home & Kitchen": {
"Drinkware": [
"Water Bottles",
"Travel Mugs",
"Tumblers"
],
"Cookware": [
"Pots & Pans",
"Bakeware"
]
},
"Baby & Toddler": [
"Sippy Cups",
"Bottle Warmers",
"Bibs"
]
}
}
}
}A garrafa se encaixa de forma plausível em dois departamentos. Mostrar as subárvores permite que o modelo veja que existem tanto Sporting Goods > Cycling > Bike Bottles & Cages quanto Home & Kitchen > Drinkware > Water Bottles, e pese a ênfase do anúncio nas gaiolas de bicicleta contra a louça de uso diário. As probabilities desta resposta dizem se a divisão está próxima o bastante para explorar os dois ramos.
Depois de escolher um departamento, faça o próximo Choice com os filhos desse departamento como opções e as subárvores deles como valores, e repita até chegar a uma folha. No código, isso poderia ser um loop sobre um dict aninhado, em que os criteria de cada pergunta são simplesmente o nó atual. O cookbook de classificação hierárquica mostra um exemplo de um percurso semelhante da árvore, incluindo uma busca em feixe que mantém vários caminhos candidatos vivos quando as probabilidades estão próximas.
Níveis de Score estruturados
Cada entrada de um array criteria de Score pode ser um objeto.
{
"state": "Fixed the null check in the payment handler. Also refactored the retry loop while I was in there, and bumped the SDK version since the old one had that timeout bug.",
"questions": {
"pr_scope": {
"type": "score",
"instructions": {
"question": "How focused is this pull request description on a single change?",
"note": "Judge the number of independent changes, not the size of any one change."
},
"criteria": [
{
"summary": "One change, clearly stated",
"signals": [
"A single fix or feature",
"Nothing described as \"also\" or \"while I was in there\""
]
},
{
"summary": "One main change plus a small related tweak",
"signals": [
"A primary change and one minor adjacent edit",
"The tweak supports the main change"
]
},
{
"summary": "Several independent changes bundled together",
"signals": [
"Two or more unrelated fixes or features",
"Changes that could each be their own PR"
]
}
]
}
}
}Criteria de Noul estruturados
Os criteria de Noul são opcionais, e quando o limite sim/não é sutil, descrições estruturadas de true e false permitem precisá-lo com uma definição e exemplos de cada lado.
{
"state": {
"sender": {
"display_name": "Beaver Dam Builders Ltd.",
"email": "donotreply@payroll.example"
},
"message": "Your Q3 bonus is ready. Reply with your login password so we can verify your identity and release the funds."
},
"questions": {
"requests_credentials": {
"type": "noul",
"instructions": {
"question": "Does the `message` ask the recipient to disclose a sensitive credential?",
"inspect": "message",
"focus": "Look for a request to send the credential itself, not a request to change or reset it."
},
"criteria": {
"true": {
"what": "Asks the recipient to reply with, type, or send a password, PIN, one-time code, or other security sensitive answer",
"examples": [
"Reply with your password",
"Send us the 6-digit code you just received"
]
},
"false": {
"what": "No sensitive credential is requested",
"examples": [
"Reset your password from the settings page",
"Your statement is ready"
]
}
}
}
}
}