:Configurações do Data Agent

Crie e gerencie Rules

No centro de configurações do Data Agent, alterne para a aba Rules. Na página de gerenciamento de Rules, você pode executar as seguintes ações:

• Alterne entre as abas Personal Rules e Enterprise-class Rules e gerencie cada tipo de Rule separadamente.

• Visualize informações sobre as Rules existentes, como nome, mecanismo de ativação e escopo.

• Visualize, edite ou exclua Rules existentes.

• Clique em New Rule para criar uma nova Rule.

As Rules não são atualizadas automaticamente. Os nomes gerados pelo Agent durante uma conversa não são adicionados à lista de Rules. Crie e mantenha-as manualmente clicando em New Rule.

Se você precisar de um vocabulário dinâmico, combine Rules com um MCP Server: mantenha o vocabulário em uma fonte de dados externa, como um banco de dados ou um arquivo Excel, e permita que o Agent consulte os padrões de nomenclatura mais recentes em tempo real via MCP. Assim, você não precisa atualizar as Rules manualmente. Para mais informações, consulte a seção MCP Servers neste tópico.

Ao criar ou editar uma Rule, configure os seguintes atributos principais:

O conteúdo a seguir é um exemplo de Rule:

• Nome da Rule: Convenções de nomenclatura de tabelas e nós

• Conteúdo da Rule:

  # DataWorks data warehouse (ODS/DWD/DWS/ADS) table and node naming conventions
  As a senior data warehouse architect, you must strictly follow these naming conventions when you create any table or node in DataWorks. These conventions are essential for ensuring that your data assets are clear, maintainable, and consistent.
  
  ### 1. Table Naming Convention
  All table names must follow a unified, structured paradigm.
  
  #### 1.1 Core naming formula
  LayerPrefix_[CustomDescription]_[UpdateStrategySuffix]
  
  #### 1.2 Layer Prefix - [Mandatory]
  -   DIM (Dimension layer): Must start with dim_. - DWD (Detail layer): Must start with dwd_. - DWS (Summary layer): Must start with dws_. - ADS (Application layer): Must start with ads_. #### 1.3 Update Strategy Suffix - [Mandatory] - DIM (Dimension layer): Use the _df suffix, which represents a Daily Full Snapshot. - DWD (Detail layer): Use the _di suffix, which represents Daily Incremental data. Use the _df suffix, which represents a Daily Full Snapshot. - DWS / ADS (Summary/Application layer): Use suffixes such as _1d, _7d, and _nd to represent the data aggregation period (for example, last 1 day, last 7 days, or last N days). #### 1.4 Delimiter All words in a table name must be in lowercase and separated by a single underscore (_). #### 1.5 Naming examples - DIM table example: dim_user_info_df (User information dimension table, daily full) - DWD table example (incremental): dwd_trade_order_detail_di (Trade order details, daily incremental) - DWD table example (full): dwd_product_base_info_df (Product basic information, daily full) - DWS table example: dws_user_active_uv_7d (User active UV summary for the last 7 days) - ADS table example: ads_screen_kpi_overview_1d (Dashboard core KPI overview, daily) ### 2. Node Naming Convention The node name should clearly reflect the core table it produces and its processing logic. - Naming principle: The node name should be highly consistent with the name of the main table it produces, in the format [Layer]_[BusinessLogic]. - Example: - An ODPS SQL node that produces the dwd_trade_order_detail_di table should be named dwd_trade_order_detail_di. - If a node handles complex logic, it can be named dws_build_user_active_uv_7d.

• Nome da Rule: Convenções de consistência de nomenclatura de campos

• Conteúdo da Rule:

  # Field naming consistency conventions
  You are a senior data developer. When you generate any SQL or data model code, you must strictly follow these field naming conventions to ensure naming consistency.
  
  1. Use snake_case for all fields, such as user_id and order_date. 2. Use a single unified English name for the same concept. Do not mix different names. 3. Suffix time fields with _date or _time, such as create_date. 4. Prefix Boolean fields with is_, such as is_active. 5. Suffix foreign key fields with _id, such as product_id.

Para garantir a consistência da nomenclatura de campos usando o recurso de Rules, execute as seguintes etapas:

1. Na página de sessão do Data Agent, clique em Settings > Rules.

2. Clique em New Rule e insira o nome da Rule e as convenções de nomenclatura. Por exemplo:

   • Use snake_case para todos os campos, como user_id e order_date.

   • Use um único nome em inglês unificado para o mesmo conceito. Não misture nomes diferentes.

   • Adicione o sufixo _date ou _time aos campos de tempo, como create_date.

   • Adicione o prefixo is_ aos campos booleanos, como is_active.

   • Adicione o sufixo _id aos campos de chave estrangeira, como product_id.

3. Defina o mecanismo de ativação da Rule como Always applied.. O Data Agent segue automaticamente essas convenções de nomenclatura ao gerar código.

4. Você também pode usar o recurso de código padrão do módulo Data Standards para associar campos a códigos padrão. Isso reforça ainda mais as restrições de consistência de nomenclatura.

Usar Rules nas conversas

As Rules configuradas entram em vigor durante suas interações diárias com o Data Agent.

• Para as Rules definidas como Always applied., nenhuma ação extra é necessária. Quando o Data Agent gera código ou respostas, ele usa essas Rules como conhecimento de base e restrições por padrão.

• Para as Rules definidas como Manual application, ative-as manualmente durante uma conversa:

  1. Clique em abaixo da caixa de entrada.

  2. No menu de contexto exibido, selecione Rule e, em seguida, selecione a Rule específica que deseja aplicar à conversa atual.