As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Adicionar instruções personalizadas a um tópico
<a name="topics-custom-instructions"></a>


|  | 
| --- |
|  Aplica-se a: Enterprise Edition  | 


|  | 
| --- |
|    Público-alvo: administradores e autores do  Amazon Quick  | 

As instruções personalizadas são regras persistentes de linguagem natural que orientam o mecanismo de IA na interpretação da terminologia específica do domínio e da lógica entre conjuntos de dados. Sem eles, o mecanismo interpreta os termos literalmente. Por exemplo, “este ano” usa como padrão o ano civil. No entanto, se sua organização funcionar em um ano fiscal a partir de 1º de abril, você precisará de uma instrução para substituir esse padrão.

As instruções personalizadas são especialmente úteis para:
+ **Regras de desambiguação. ** Quando o mesmo termo comercial puder ser mapeado para vários conjuntos de dados ou campos, diga à IA qual deles preferir. Por exemplo: “Quando o usuário perguntar sobre 'vendas', use SALES\_FACT. Quando o usuário perguntar sobre 'devoluções' ou 'reembolsos', use RETURNS\_FACT.”
+ **Cross-dataset definições. ** Defina métricas que abrangem vários conjuntos de dados. Por exemplo: “Receita líquida = SUM (SALES\_ FACT.total \_amount) - SUM (FACT.refundRETURNS\_ \_amount).”
+ **Comportamento padrão de junção. ** Especifique a direção da junção que preserva a semântica pretendida. Por exemplo: “Prefira LEFT JOIN de tabelas de fatos a tabelas de dimensões para que fatos sem registros de dimensão correspondentes não sejam eliminados silenciosamente”.
+ **Lógica de data personalizada. ** Por exemplo: “O ano fiscal começa em 1º de abril. Interprete 'este ano' usando os limites do ano fiscal.”

**Para adicionar instruções personalizadas**

1. Abra o tópico que você deseja configurar.

1. Navegue até a ** guia Instruções ** personalizadas.

1. Escolha **Editar**.

1. Insira suas instruções como regras de linguagem natural. Use o estilo de marcadores para maior clareza.

1. Escolha **Salvar alterações**.

## Exemplo de instruções personalizadas
<a name="topics-custom-instructions-example"></a>

O exemplo a seguir mostra um conjunto pronto para produção de instruções em nível de tópico para um tópico de análise de varejo:

```
Disambiguation:
- "sales", "revenue", "orders" -> use SALES_FACT
- "returns", "refunds" -> use RETURNS_FACT
- "net sales", "net revenue" -> join SALES_FACT LEFT JOIN RETURNS_FACT on order_line_id

Cross-dataset metrics:
- Net Revenue = SUM(SALES_FACT.total_amount) - SUM(RETURNS_FACT.refund_amount)
- Return Rate = COUNT(RETURNS_FACT.return_id) / COUNT(SALES_FACT.order_line_id)

Default joins:
- SALES_FACT LEFT JOIN CUSTOMER_DIM on customer_id
- SALES_FACT LEFT JOIN PRODUCT_DIM on product_id

Date handling:
- Fiscal year starts April 1. Interpret "this year" using fiscal year boundaries.
- YTD: current fiscal year up to and including today.
```

## Práticas recomendadas para instruções personalizadas
<a name="topics-custom-instructions-best-practices"></a>
+ Mantenha as instruções concisas. Prefira listas de regras com marcadores em vez de parágrafos em prosa.
+ Use instruções em nível de tópico somente para lógica entre conjuntos de dados. Single-dataseta semântica (granulação, chaves, regras de agregação) pertence aos metadados de enriquecimento do próprio conjunto de dados.
+ Evite contradições entre as instruções no nível do conjunto de dados e no nível do tópico.
+ Teste suas instruções fazendo perguntas no chat e revisando o SQL gerado no painel Explicação.