Data Agent for Analytics - Data Management

Data Agent for Analytics是阿里雲Business Foundation System資料庫團隊推出的面向企業使用者的資料分析智能體，可以根據自然語言描述進行需求分析，自動完成資料理解，並基於資料理解提出分析需求，擴充分析思路，最終通過調用工具交付分析結果。

應用情境

業務人員：負責定義資料需求，以快速產生銷售趨勢、使用者行為分析等報告。
資料分析師：進行探索性分析，代理完成自動化特徵工程和資料清洗等耗時任務，並複用Python代碼。
管理者：迅速擷取關鍵業務指標的深度洞察與分析，以資料化手段支援業務決策。

功能特性

自動化探索資料洞察：通過自然語言描述需求，Agent自主完成對需求的理解、資料的理解、資料分析的洞察及報告的產生。
縮短資料價值路徑：無需關注複雜的資料處理流程，重點關注資料結果與業務決策之間的關係。
無縫串連企業資料：支援阿里雲Business Foundation System資料庫及DMS託管的資料來源，能夠即刻實現資料分析。

擴充整合

核心組件：Data Agent Skill
一鍵整合：支援從Git 倉庫直接拉取安裝或通過複製以下命令快速部署，一鍵裝載智能體。
```
npx skills add https://github.com/aliyun/data-agent-skill
```
功能簡介：該技能包支援靈活下載並無縫整合至您的智能體服務中。旨在構建與企業資料來源之間的安全橋樑，通過標準化的連線協定，顯著增強智能體的資料訪問能力與分析洞察深度，助力企業快速構建定製化資料智能應用。

功能限制

Data Agent for Analytics當前支援以下地區：

中國：華北2（北京）、華北3（張家口）、華北6（烏蘭察布）、華東1（杭州）、華東2（上海）、華南1（深圳）、西南1（成都）、中國香港

亞太地區：新加坡、馬來西亞（吉隆坡）、印尼（雅加達）、菲律賓（馬尼拉）、日本（東京）

其他：美國（矽谷）、美國（維吉尼亞）。

DMS Data+AI 模組不支援 token 消耗的查看和統計。如需查看 token 消耗情況，可通過以下途徑：

百鍊平台：登入百鍊控制台，選擇用量統計，查看模型調用次數和 Tokens 總量。
費用中心：登入費用與成本控制台，選擇賬單 > 賬單詳情，查看 API 呼叫費用明細。

DMS Data Agent 的認證體系（OpenAPI 使用 RAM AK/SK、Agent 資料閘道使用 AccessToken）與 dashscope/百鍊的 OpenAI 相容 API Key 不互連，不支援在 qwenpaw 等需要 OpenAI 相容 API Key 的工具中使用。如需在 qwenpaw 中調用模型，請使用 dashscope/百鍊 API Key。

布局介紹

初始介面：
- 資料中心：分析資料新增和上傳。
- 任務管理：分析任務的記錄。
- 使用者資訊：當前登入帳號資訊。
- 互動地區：新的分析任務中與Agent首次進行溝通以及分析任務執行的展示地區。
工作介面：
- 互動地區：分析任務開始後的互動地區。
- 任務執列區域：可查看Agent為分析任務編寫的每個步驟代碼以及執行結果。

帳號準備

第一步：建立使用帳號

在阿里雲建立用於使用 Data Agent 的帳號。根據業務需要，建立對應的 RAM 使用者。

第二步：為帳號授權

為帳號授予 Data Agent 功能的使用許可權。權限原則名稱：AliyunDMSDataAgentFullAccess。

說明

該許可權僅對應 Data Agent 功能的使用許可權，不涉及資料許可權。資料許可權需要在使用過程中按需申請和審批。

授權方式：

方式一：為單個帳號授權
1. 使用具有 RAM 管理員權限的阿里雲帳號訪問 RAM 使用者列表。
2. 搜尋需要授權的 RAM 使用者，單擊其操作列的新增授權。
3. 在彈出頁面中，搜尋並選中 AliyunDMSDataAgentFullAccess 權限原則，單擊確認新增授權。
方式二：使用者組統一授權
1. 使用具有 RAM 管理員權限的阿里雲帳號訪問 RAM 使用者組列表。
2. 選擇目標使用者組，在使用者組詳情頁的許可權管理頁簽中單擊新增授權。
3. 搜尋並選中 AliyunDMSDataAgentFullAccess 權限原則，單擊確認新增授權。
4. 將想要授權的使用者加入該使用者組。
方式三：通過身份對接免登入使用
如果您希望將 Data Agent 整合到企業內部系統中，免登入阿里雲直接使用，可以通過帳號體系對接實現。

操作步驟

登入Agent控制台。
請根據業務需求選擇合適的版本，各版本之間的差異詳見Data Agent版本介紹。
- 免費版：
  在免費版卡片中，單擊免費試用。
- 個人版：
  - 在個人版卡片中，單擊升級至個人版。
  - 根據實際需求，選擇地區、使用席位和使用時間長度。
    說明
    在使用時間長度中單擊月度時間長度，可以選擇對應時間長度。
  - 單擊立即購買，並完成後續購買操作。
- 企業版：
  - 在企業版卡片中，單擊升級至企業版。
  - 根據實際需求，選擇地區、大模型資源套件數量和使用時間長度。
    說明
    在使用時間長度中單擊月度時間長度，可以選擇1~11個月。
  - 單擊立即購買，並完成後續購買操作。
上傳資料樣本，支援通過本地上傳和已有資料上傳。
- 單擊，進行本地上傳，支援上傳不大於200M的csv、xlsx、xls格式檔案。
- 單擊，選擇已有資料上傳，已有資料可通過資料中心添加。
進行需求描述，按斷行符號鍵或單擊，開始分析。
等待Agent產生執行計畫，確認執行計畫是否滿足需求。
- 若滿足需求，單擊開始任務。
- 若不滿足，單擊修改任務，進一步補充需求描述，直到分析計劃滿足需求為止。
等待計劃執行，執行過程中可以查看每個步驟Agent為分析認為編寫的代碼及執行結果。
可以讓Agent根據資料情況自行繪製可視化的網頁報告，進行更豐富的資料洞察呈現。

資料中心

在左側導覽列中，單擊資料中心，然後在頁面中單擊添加資料按鈕，根據所選資料來源類型，選擇相應的資料接入方式。

本地上傳：
將需要分析的檔案拖至上傳地區或單擊上傳地區進行檔案上傳，上傳完成後單擊確認。
雲資料庫：免費版和個人版支援RDS數據庫，PolarDB數據庫，AnalyticDB數據庫，企業版支援40種+資料來源，具體列表詳見DMS支援的資料庫。
1. 選擇地區、執行個體。
2. 輸入資料庫使用者名稱、資料庫密碼。
3. 單擊測試鏈接已繼續。
4. 選擇表所屬庫、添加表。
5. 單擊確認。
DMS受管理的執行個體：
您可以將已錄入至DMS中的MaxCompute和Hologres執行個體作為資料來源接入，對其資料進行分析。具體的錄入流程，請參見錄入執行個體。

添加資料常見問題

添加 MaxCompute 執行個體後不顯示庫和表

2024 年後新購的 MaxCompute 執行個體需要使用租戶級 Information_schema 處理，且需要升級架構到 Schema 層級。操作步驟如下：

在 MaxCompute 控制台的專案管理頁面，執行升級到支援Schema層級操作。
為 DMS 錄入執行個體時使用的 AccessKey 對應的使用者身份授予租戶管理的 admin 許可權。
在 DMS 執行個體管理中，單擊目標執行個體右側的編輯，然後單擊儲存以觸發執行個體識別 Schema 層級變更。

添加 Hologres 執行個體報錯無法連通

DMS 訪問 Hologres 執行個體需要確保對應的 Hologres 執行個體有指定 VPC 地址。

關於 VPC 地址配置，請參見 Hologres 執行個體配置。

下拉式清單中搜不到庫或表

單擊重新整理按鈕，如果表數量不大，通常 30 秒內重新搜尋即可找到。

重新整理庫表提示 permission denied

操作使用者需要具備對應雲資料庫資源的 RAM 許可權，或在 DMS 中擁有管理員或 DBA 角色許可權。

方式一：RAM 權限原則授權

為使用者授予對應雲產品的 RAM 權限原則。常用的系統策略如下：

引擎類型	Action	Resource ARN	系統策略
RDS	`dms:LoginDatabase`	`acs:rds:{region}:{accountId}:dbinstance/{instanceId}`	AliyunRDSFullAccess
PolarDB	`dms:LoginDatabase`	`acs:polardb:{region}:{accountId}:*/{instanceId}`	AliyunPolardbFullAccess
AnalyticDB MySQL	`adb:*`	`acs:adb:{region}:{accountId}:dbcluster/{instanceId}`	AliyunADBFullAccess
AnalyticDB PostgreSQL	`gpdb:*`	`acs:gpdb:{region}:{accountId}:dbinstance/{instanceId}`	AliyunGPDBFullAccess

方式二：為使用者授予DMS 管理員或 DBA 角色
在 DMS 中為使用者授予管理員或 DBA 角色。具體操作，請參見系統管理使用者。

長期記憶

長期記憶是Agent的一項核心能力。當您與Agent進行對話分析時，系統會自動貼齊並提煉對話中對未來資料分析有價值的關鍵資訊，並將其沉澱為Agent的長期記憶。這些記憶將在您後續的互動中被智能召回和應用，從而顯著提升Agent對您業務需求的理解準確性，最佳化分析效果，並改善整體使用體驗。

功能配置

該功能預設開啟，以確保持續最佳化您的分析體驗。如果您不希望系統自動沉澱任何記憶，可以通過以下路徑關閉：

登入記憶管理頁。
找到生成記憶的開關，並將其關閉。

列表說明

在記憶管理頁面，您可以查看並管理所有已沉澱的記憶。列表包含以下關鍵資訊：

清單項目	說明
來源	標記了該條記憶產生的具體對話。您可以點擊快捷連結，直接跳轉到原始對話上下文，方便追溯記憶的來源。
內容	展示了系統從對話中提取並理解的關鍵資訊。
熱度	系統會根據每條記憶被召回和使用的頻次，通過演算法計算出一個“熱度值”。熱度值越高，代表該條記憶在您的分析工作中越常用、越重要。
狀態	記憶存在兩種狀態： • `已記住`：此狀態下的記憶是啟用的，會在後續的分析過程中被召回使用。 • `已遺忘`：此狀態下的記憶是失效的，不會再被召回。
操作	在操作列您可以對記憶進行編輯和刪除操作：編輯：當您發現系統沉澱的記憶內容不夠準確、完整，或業務定義發生變更時，點擊對應記憶條目後的編輯表徵圖。在彈出的編輯框中，手動修正或完善記憶內容，然後儲存。這能確保Agent學習到最正確的資訊。刪除：當您認為某條記憶已淘汰、無效，或不應再被用於分析時，點擊對應記憶條目後的刪除表徵圖。此操作是雙重狀態的：對於`已記住`的記憶：點擊後，該記憶的狀態將變為`已遺忘`，但記錄本身依然保留在列表中，您可以選擇將其重新記住。對於`已遺忘`的記憶：點擊後，該記憶記錄將從列表中被永久移除，無法恢複。

資料隱私權聲明

Agent不會使用您的個人資料，包括上傳的檔案、查詢內容、分析結果以及產生的報告，進行模型訓練或模型迭代。
您的資料將在個人帳號下按需啟動的獨佔計算執行個體中進行處理，執行個體釋放後將被銷毀；其他帳號無法通過任何途徑擷取您帳號下使用的資料、過程及記錄。
基於本地上傳的資料，上傳的原始檔案儲存在獨立環境中，與其他帳號實現隔離，互不可見。
基於資料庫的分析，本次資料存放區於個人採購的資料庫中。在計算過程中，不會進行資料的遷移。資料計算完成後，所有中間結果將被銷毀，不會進行儲存。