View a markdown version of this page

Adicionar instruções personalizadas a um tópico - Amazon Quick
Exemplo de instruções personalizadasPráticas recomendadas para instruções personalizadas

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

 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.

  2. Navegue até a guia Instruções personalizadas.

  3. Escolha Editar.

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

  5. Escolha Salvar alterações.

Exemplo de instruções personalizadas

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

  • 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.