Simple Log Service：智能問答助手

1. 登入Log Service控制台。

2. 選擇日誌應用 > 智能問答助手，單擊數字員工。

3. 在數字員工列表頁，單擊右上方建立數字員工。

4. 在建立數字員工對話方塊，配置以下參數：

   參數	是否必填	說明
   ID	是	數字員工的唯一標識，建立後不可修改。建議使用英文和數字組合，如order-system-expert。
   顯示名稱	是	數字員工在介面上顯示的名稱。建議使用具有業務屬性的名稱，如"訂單系統監控專家"、"巨量資料叢集巡檢員"。
   RAM角色類型	是	指定數字員工所使用的RAM角色類型，可選擇： • 服務角色：使用系統預置的服務角色（免配置），數字員工將自動獲得Log Service和ARMS的讀取許可權。 • 自訂角色：如需訪問特定的百鍊知識庫或限制存取範圍，請選擇此選項並配置已授權的RAM角色ARN，詳情請參見建立RAM角色並授權。
   RAM角色ARN	是	服務角色預設使用ServiceRoleForCloudMonitor，該角色具備CloudMonitor2.0資料讀取許可權（包括Log ServiceSLS、應用即時監控服務ARMS）。
   內建SLS知識庫	否	開啟後，數字員工可以回答SLS相關的問題。預設已啟用。
   描述資訊	否	詳細闡述該員工的職責範圍與能力特長。例如：負責訂單中心核心應用的日常巡檢、異常警示分析及根因定位，具備MySQL慢查詢分析能力。
   預設規則	否	指導數字員工工作的預設規則，推薦使用Markdown文法。可以定義員工的角色、能力範圍和管理辦法。

5. 配置完成後，單擊確定。

SOP知識庫組織圖

SOP知識庫採用漸進式結構組織，核心入口檔案為SOP.md。整體思路是按照模組漸進式地組織檔案，讓Agent自主從結構中讀取所需的知識內容。

推薦的目錄結構如下：

知識庫根目錄/
├── SOP.md                  # 核心入口檔案，描述各領域知識總覽
├── accesslog/              # 訪問日誌領域
│   ├── overview.md         # 領域概述
│   └── troubleshooting.md  # 故障排查指南
├── monitoring/             # 監控領域
│   ├── overview.md
│   └── alert-handling.md
└── ...

在SOP.md中描述各個領域知識的總覽，然後在對應目錄下的檔案中詳細說明具體知識內容。

關聯內建SLS知識庫

內建SLS知識庫包含Log Service的標準操作流程和最佳實務，可以協助回答SLS相關問題。

方式一：建立時啟用

在建立數字員工時，保持內建SLS知識庫開關為啟用狀態即可。

方式二：建立後添加

1. 在數字員工列表中，單擊目標數字員工進入詳情頁。

2. 選擇知識庫頁簽。

3. 單擊添加知識庫，選擇內建知識庫類型。

4. 在知識庫ID中填寫sls，單擊確定。

關聯OSS知識庫

如果您的SOP文檔儲存在OSS中，可以通過以下步驟關聯OSS知識庫。

前提條件

• 已建立OSS Bucket並上傳SOP文檔。

• 已建立並配置自訂RAM角色，詳情請參見建立RAM角色並授權。

操作步驟

1. 將數字員工的RAM角色類型修改為自訂角色，並配置已授權的RAM角色ARN。

2. 在數字員工詳情頁，選擇知識庫頁簽。

3. 單擊添加知識庫，選擇OSS知識庫類型。

4. 配置以下參數：

   參數	說明
   OSS Region	SOP文檔所在OSS的地區
   OSS Bucket	OSS Bucket名稱
   文件庫根路徑	SOP.md檔案所在的目錄路徑。如果SOP.md在Bucket根目錄，則填寫/；如果在子目錄中，則填寫完整路徑，如/docs/sop/

5. 單擊確定。

關聯雲效知識庫

如果您使用雲效（Codeup）管理SOP文檔，可以通過以下步驟關聯雲效知識庫。

前提條件

• 已在雲效控制台建立代碼倉庫並上傳SOP文檔。

• 已建立個人存取權杖（Personal Access Token）。

擷取配置資訊

1. 組織ID：在雲效控制台，單擊代碼倉庫後，從URL中擷取組織ID。URL格式為https://codeup.aliyun.com/組織ID/倉庫名稱\。

2. 倉庫ID：在代碼倉庫頁面的設定 > 基本資料中查看。

3. 個人存取權杖：

   • 在雲效控制台，單擊右上方頭像，選擇個人設定。

   • 選擇個人存取權杖，單擊建立存取權杖。

   • 設定令牌名稱、到期時間和許可權範圍，單擊建立。

   • 複製並妥善儲存產生的令牌（僅顯示一次）。

操作步驟

1. 在數字員工詳情頁，選擇知識庫頁簽。

2. 單擊添加知識庫，選擇雲效知識庫類型。

3. 配置以下參數：

   參數	說明
   組織ID	雲效組織ID
   倉庫ID	代碼倉庫ID
   分支名稱	要關聯的分支，如master或main
   個人存取權杖	雲效個人存取權杖
   文件庫根路徑	SOP.md檔案所在的目錄路徑

4. 單擊確定。

為RAM使用者授權

如果您使用RAM使用者操作智能問答助手，需要由管理員為其授予相應許可權。

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "ram:PassRole",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "acs:Service": "cloudmonitor.aliyuncs.com"
        }
      }
    }
  ]
}

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cms:CreateChat",
        "cms:CreateThread",
        "cms:GetThread",
        "cms:GetThreadData",
        "cms:ListThreads"
      ],
      "Resource": "acs:cms:*:*:digitalEmployee/*"
    }
  ]
}

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cms:CreateChat",
        "cms:GetDigitalEmployee",
        "cms:ListDigitalEmployees",
        "cms:GetThread",
        "cms:GetThreadData",
        "cms:ListThreads",
        "cms:CreateDigitalEmployee",
        "cms:UpdateDigitalEmployee",
        "cms:DeleteDigitalEmployee",
        "cms:CreateThread",
        "cms:UpdateThread",
        "cms:DeleteThread"
      ],
      "Resource": [
        "acs:cms:*:*:digitalemployee/*",
        "acs:cms:*:*:digitalemployee/*/thread/*"
      ]
    }
  ]
}

建立RAM角色並授權

如果需要使用自訂角色（如訪問OSS知識庫），請按以下步驟建立並授權RAM角色。

步驟一：建立RAM角色

1. 登入RAM控制台。

2. 在左側導覽列，選擇身份管理 > 角色。

3. 單擊建立角色，選擇阿里雲服務作為可信實體類型。

4. 配置以下資訊：

   • 角色名稱：自訂角色名稱

   • 受信服務：選擇CloudMonitor/Cms

5. 單擊完成。

步驟二：為RAM角色授權

1. 建立自訂權限原則。以下策略授予OSS和Log Service的讀取許可權：

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "oss:GetObject",
        "oss:GetObjectAcl",
        "oss:ListObjects",
        "oss:ListObjectVersions"
      ],
      "Resource": [
        "acs:oss:*:*:<OSS_BUCKET_NAME>",
        "acs:oss:*:*:<OSS_BUCKET_NAME>/*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "log:Get*",
        "log:List*"
      ],
      "Resource": "*"
    }
  ]
}

說明：請將<OSS_BUCKET_NAME>替換為實際的OSS Bucket名稱。

2. 將建立的權限原則授予RAM角色。