:Data Agent Ayarları

Kural oluşturma ve yönetme

Data Agent ayar merkezinde Rules sekmesine geçin. Kural yönetimi sayfasında aşağıdaki işlemleri yapabilirsiniz:

• Her bir Kural türünü ayrı ayrı yönetmek için Personal Rules ve Enterprise-class Rules sekmeleri arasında geçiş yapın.

• Adı, etkinleştirme mekanizması ve kapsamı gibi mevcut Kurallar hakkındaki bilgileri görüntüleyin.

• Mevcut Kuralları görüntüleyin, düzenleyin veya silin.

• Yeni bir Kural oluşturmak için New Rule seçeneğine tıklayın.

Kurallar otomatik olarak güncellenmez. Agent'ın bir konuşma sırasında oluşturduğu adlar Rule listesine eklenmez. New Rule seçeneğine tıklayarak bunları manuel olarak oluşturmanız ve sürdürmeniz gerekir.

Dinamik bir sözlüğe ihtiyacınız varsa Kurallar ile bir MCP Sunucusunu birleştirin: Sözlüğü veritabanı veya Excel dosyası gibi harici bir veri kaynağında tutun ve Agent'ın en güncel adlandırma standartlarını MCP üzerinden gerçek zamanlı olarak sorgulamasını sağlayın. Bu şekilde Kuralları manuel olarak güncellemeniz gerekmez. Daha fazla bilgi için bu konudaki MCP Servers bölümüne bakın.

Bir Kural oluştururken veya düzenlerken aşağıdaki temel nitelikleri yapılandırın:

Aşağıdaki içerik bir Kural örneğidir:

• Kural adı: Tablo ve düğüm adlandırma kuralları

• Kural içeriği:

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

• Kural adı: Alan adı tutarlılığı kuralları

• Kural içeriği:

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

Kurallar özelliğini kullanarak alan adı tutarlılığını sağlamak için aşağıdaki adımları uygulayın:

1. Data Agent oturum sayfasında Settings > Rules seçeneğine tıklayın.

2. New Rule seçeneğine tıklayın ve kural adı ile adlandırma kurallarını girin. Örneğin:

   • Tüm alanlar için snake_case kullanın; örneğin user_id ve order_date.

   • Aynı kavram için tek bir birleşik İngilizce ad kullanın. Farklı adları karıştırmayın.

   • Zaman alanlarının sonuna _date veya _time ekini getirin; örneğin create_date.

   • Boolean alanlarının başına is_ önekini getirin; örneğin is_active.

   • Yabancı anahtar alanlarının sonuna _id ekini getirin; örneğin product_id.

3. Kuralın etkinleştirme mekanizmasını Always applied. olarak ayarlayın. Data Agent, kod oluştururken bu adlandırma kurallarını otomatik olarak takip eder.

4. Veri Standartları modülünün standart kod özelliğini kullanarak alanları standart kodlarla ilişkilendirebilirsiniz. Bu işlem, adlandırma tutarlılığı kısıtlamalarını daha da güçlendirir.

Konuşmalarda kuralları kullanma

Yapılandırılan Kurallar, Data Agent ile günlük etkileşimleriniz sırasında etkili olur.

• Always applied. olarak ayarlanan Kurallar için ek bir işlem gerekmez. Data Agent kod veya yanıt oluştururken bu Kuralları varsayılan olarak arka plan bilgisi ve kısıtlamalar olarak kullanır.

• Manual application olarak ayarlanan Kurallar için, bir konuşma sırasında bunları manuel olarak etkinleştirebilirsiniz:

  1. Giriş kutusunun altındaki düğmesine tıklayın.

  2. Açılan bağlam menüsünde Rule seçeneğini belirleyin ve ardından mevcut konuşmaya uygulamak istediğiniz belirli Kuralı seçin.