:Configuración de Data Agent

Crear y gestionar reglas

En el centro de configuración de Data Agent, cambie a la pestaña Rules. En la página de gestión de reglas puede realizar las siguientes acciones:

• Alternar entre las pestañas Personal Rules y Enterprise-class Rules para gestionar cada tipo de regla por separado.

• Consultar información sobre las reglas existentes, como su nombre, mecanismo de activación y alcance.

• Consultar, editar o eliminar reglas existentes.

• Hacer clic en New Rule para crear una nueva regla.

Las reglas no se actualizan automáticamente. Los nombres que el agente genera durante una conversación no se añaden a la lista de Rule. Debe crearlos y mantenerlos manualmente haciendo clic en New Rule.

Si necesita un vocabulario dinámico, combine Rules con un MCP Server: mantenga el vocabulario en una fuente de datos externa, como una base de datos o un archivo de Excel, y permita que el agente consulte los estándares de nomenclatura más recientes en tiempo real mediante MCP. De este modo, no tendrá que actualizar las reglas manualmente. Para obtener más información, consulte la sección MCP Servers de este tema.

Cuando cree o edite una regla, configure los siguientes atributos principales:

A continuación se muestra un ejemplo de una regla:

• Nombre de la regla: Convenciones de nomenclatura de tablas y nodos

• Contenido de la regla:

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

• Nombre de la regla: Convenciones de consistencia en la nomenclatura de campos

• Contenido de la regla:

  # 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 garantizar la consistencia en la nomenclatura de campos mediante la función Rules, siga estos pasos:

1. En la página de sesión de Data Agent, haga clic en Settings > Rules.

2. Haga clic en New Rule e introduzca el nombre de la regla y las convenciones de nomenclatura. Por ejemplo:

   • Use snake_case para todos los campos, como user_id y order_date.

   • Utilice un único nombre unificado en inglés para el mismo concepto. No mezcle nombres distintos.

   • Agregue el sufijo _date o _time a los campos de fecha y hora, como create_date.

   • Agregue el prefijo is_ a los campos booleanos, como is_active.

   • Agregue el sufijo _id a los campos de clave externa, como product_id.

3. Establezca el mecanismo de activación de la regla en Always applied.. Data Agent seguirá automáticamente estas convenciones de nomenclatura al generar código.

4. También puede usar la función de código estándar del módulo Data Standards para asociar campos con códigos estándar. Esto refuerza aún más las restricciones de consistencia en la nomenclatura.

Usar reglas en las conversaciones

Las reglas configuradas surten efecto durante sus interacciones diarias con Data Agent.

• Para las reglas configuradas como Always applied., no se requiere ninguna acción adicional. Cuando Data Agent genera código o respuestas, utiliza estas reglas como conocimiento de fondo y restricciones de forma predeterminada.

• Para las reglas configuradas como Manual application, puede habilitarlas manualmente durante una conversación:

  1. Haga clic en el botón situado debajo del cuadro de entrada.

  2. En el menú contextual que aparece, seleccione Rule y luego elija la regla específica que desea aplicar a la conversación actual.