智能问答助手

1. 登录日志服务控制台。

2. 选择日志应用 > 智能问答助手，单击数字员工。

3. 在数字员工列表页，单击右上角创建数字员工。

4. 在创建数字员工对话框，配置以下参数：

   参数	是否必填	说明
   ID	是	数字员工的唯一标识，创建后不可修改。建议使用英文和数字组合，如order-system-expert。
   显示名称	是	数字员工在界面上显示的名称。建议使用具有业务属性的名称，如"订单系统监控专家"、"大数据集群巡检员"。
   RAM角色类型	是	指定数字员工所使用的RAM角色类型，可选择： • 服务角色：使用系统预置的服务角色（免配置），数字员工将自动获得日志服务和ARMS的读取权限。 • 自定义角色：如需访问特定的百炼知识库或限制访问范围，请选择此选项并配置已授权的RAM角色ARN，详情请参见创建RAM角色并授权。
   RAM角色ARN	是	服务角色默认使用ServiceRoleForCloudMonitor，该角色具备云监控2.0数据读取权限（包括日志服务SLS、应用实时监控服务ARMS）。
   内置SLS知识库	否	开启后，数字员工可以回答SLS相关的问题。默认已启用。
   描述信息	否	详细阐述该员工的职责范围与能力特长。例如：负责订单中心核心应用的日常巡检、异常告警分析及根因定位，具备MySQL慢查询分析能力。
   默认规则	否	指导数字员工工作的默认规则，推荐使用Markdown语法。可以定义员工的角色、能力范围和行为准则。

5. 配置完成后，单击确定。

SOP知识库组织结构

SOP知识库采用渐进式结构组织，核心入口文件为SOP.md。整体思路是按照模块渐进式地组织文件，让Agent自主从结构中读取所需的知识内容。

推荐的目录结构如下：accesslog_sop .zip

知识库根目录/
├── SOP.md                  # 核心入口文件，描述各领域知识总览
├── accesslog/              # 访问日志领域
│   ├── overview.md         # 领域概述
│   └── troubleshooting.md  # 故障排查指南
├── monitoring/             # 监控领域
│   ├── overview.md
│   └── alert-handling.md
└── ...

在SOP.md中描述各个领域知识的总览，然后在对应目录下的文件中详细说明具体知识内容。

关联内置SLS知识库

内置SLS知识库包含日志服务的标准操作流程和最佳实践，可以帮助回答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. 配置以下信息：

   • 角色名称：自定义角色名称

   • 受信服务：选择云监控/Cms

5. 单击完成。

步骤二：为RAM角色授权

1. 创建自定义权限策略。以下策略授予OSS和日志服务的读取权限：

{
  "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角色。