Simple Log Service:SLS DataAgent (旧称：インテリジェント Q&A アシスタント)

1. Log Service コンソールにログインします。

2. [Log Apps] > [SLS DataAgent] を選択し、[Digital Employee] をクリックします。

3. デジタル従業員のページで、右上隅の [デジタル従業員の作成] をクリックします。

4. [デジタル従業員の作成] ダイアログボックスで、以下のパラメーターを設定します：

   パラメーター	必須	説明
   ID	はい	デジタル従業員の一意の識別子です。この ID は作成後に変更できず、 order-system-expert のような文字と数字の組み合わせを推奨します。
   表示名	はい	UI に表示されるデジタル従業員の名前。ビジネス目的を反映した名前 (「注文システム監視エキスパート」や「ビッグデータクラスター検査官」など) を使用することを推奨します。
   RAM ロールタイプ	はい	デジタル従業員の RAM ロールのタイプを指定します。以下のいずれかのオプションを選択できます： • [サービスロール]：システム提供のサービスロールを使用します (設定不要)。デジタル従業員は、Log Service と ARMS の読み取り権限を自動的に取得します。 • [カスタムロール]：特定の Model Studio ナレッジベースへのアクセスやアクセス範囲の制限が必要な場合に、このオプションを選択します。認可された RAM ロールの ARN を設定する必要があります。詳細については、「RAM ロールの作成と認可」をご参照ください。
   RAM ロール ARN	いいえ	このパラメーターは、カスタムロールを選択した場合にのみ必須です。デフォルトのサービスロールは、CloudMonitor、Log Service (SLS)、および ARMS の読み取り権限を持つ ServiceRoleForCloudMonitor ロールを使用します。
   組み込み SLS ナレッジベース	いいえ	有効にすると、デジタル従業員は SLS に関連する質問に回答します。これはデフォルトで有効になっています。
   説明	いいえ	デジタル従業員の責任と能力を記述します。例：「注文センターのコアアプリケーションの日常点検、異常分析、根本原因分析を担当。低速な MySQL クエリの分析が可能。」
   デフォルトルール	いいえ	デジタル従業員の行動の指針となるデフォルトルール。Markdown 構文の使用を推奨します。従業員の役割、能力の範囲、行動指針を定義できます。

5. パラメーターを設定したら、[OK] をクリックします。

SOP ナレッジベースの構造

SOP ナレッジベースは、SOP.md をコアエントリファイルとする、モジュール式のディレクトリベース構造を採用しています。この構造により、エージェントは必要な情報を自律的に見つけることができます。

推奨されるディレクトリ構造は以下のとおりです：accesslog_sop.zip

knowledge_base_root/
├── SOP.md                  # コアエントリファイル、各ナレッジドメインの概要を記述
├── accesslog/              # アクセスログドメイン
│   ├── overview.md         # ドメインの概要
│   └── troubleshooting.md  # トラブルシューティングガイド
├── monitoring/             # 監視ドメイン
│   ├── overview.md
│   └── alert-handling.md
└── ...

SOP.md には、各ナレッジドメインの概要を記述し、各ディレクトリ内の対応するファイルで詳細情報を提供します。

組み込み SLS ナレッジベースの関連付け

組み込み SLS ナレッジベースには、Log Service の標準操作手順書とベストプラクティスが含まれており、SLS 関連の質問に回答するのに役立ちます。

方法 1：作成時に有効化

デジタル従業員を作成する際に、[組み込み SLS ナレッジベース] スイッチを有効のままにします。

方法 2：作成後に追加

1. デジタル従業員リストで、対象のデジタル従業員をクリックして詳細ページを開きます。

2. [ナレッジベース] タブを選択します。

3. [ナレッジベースの追加] をクリックし、[組み込みナレッジベース] タイプを選択します。

4. [ナレッジベース ID] フィールドに sls と入力し、[OK] をクリックします。

OSS ナレッジベースの関連付け

SOP ドキュメントが OSS に保存されている場合は、以下の手順に従って OSS ナレッジベースを関連付けます。

前提条件

• OSS バケットを作成し、SOP ドキュメントをアップロード済みであること。

• カスタム RAM ロールを作成し、設定済みであること。詳細については、「RAM ロールの作成と認可」をご参照ください。

操作手順

1. デジタル従業員の RAM ロールタイプを [カスタムロール] に変更し、認可された RAM ロールの ARN を設定します。

2. デジタル従業員の詳細ページで、[ナレッジベース] タブを選択します。

3. [ナレッジベースの追加] をクリックし、[OSS ナレッジベース] タイプを選択します。

4. 以下のパラメーターを設定します：

   パラメーター	説明
   OSS リージョン	SOP ドキュメントを保存する OSS バケットが配置されているリージョン。
   OSS バケット	OSS バケットの名前。
   ドキュメントライブラリのルートパス	SOP.md ファイルが配置されているディレクトリパス。SOP.md がバケットのルートディレクトリにある場合は / と入力します。サブディレクトリにある場合は、/docs/sop/ のようにフルパスを入力します。

5. [OK] をクリックします。

Alibaba Cloud DevOps ナレッジベースの関連付け

Alibaba Cloud DevOps (Codeup) を使用して SOP ドキュメントを管理している場合は、以下の手順に従って Alibaba Cloud DevOps ナレッジベースを関連付けます。

前提条件

• Alibaba Cloud DevOps コンソールでコードリポジトリを作成し、SOP ドキュメントをアップロード済みであること。

• 個人アクセストークンを作成済みであること。

設定情報の取得

1. 組織 ID：ページ URL で組織 ID を確認できます。URL の形式は https://codeup.aliyun.com/<Organization_ID>/<Repository_Name>\ です。

2. リポジトリ ID：コードリポジトリのページで、[設定] > [基本情報] を選択して ID を確認します。

3. 個人アクセストークン：

   • Alibaba Cloud DevOps コンソールで、右上隅のプロフィール写真をクリックし、[個人設定] を選択します。

   • [個人アクセストークン] を選択し、[アクセストークンの作成] をクリックします。

   • トークンの名前、有効期限、権限スコープを設定し、[作成] をクリックします。

   • 生成されたトークンをコピーして安全に保存します。トークンは一度しか表示されません。

操作手順

1. デジタル従業員の詳細ページで、[ナレッジベース] タブを選択します。

2. [ナレッジベースの追加] をクリックし、[Alibaba Cloud DevOps ナレッジベース] タイプを選択します。

3. 以下のパラメーターを設定します：

   パラメーター	説明
   組織 ID	Alibaba Cloud DevOps 組織の ID。
   リポジトリ ID	コードリポジトリの ID。
   ブランチ名	関連付けるブランチ (master や main など)。
   個人アクセストークン	Alibaba Cloud DevOps の個人アクセストークン。
   ドキュメントライブラリのルートパス	SOP.md ファイルが配置されているディレクトリパス。

4. [OK] をクリックします。

RAM ユーザーへの権限付与

RAM ユーザーとして SLS DataAgent を使用するには、まず管理者に必要な権限を付与してもらう必要があります。

{
  "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 ロールを作成し、認可します。

ステップ 1：RAM ロールの作成

1. RAM コンソールにログインします。

2. ナビゲーションペインで、[ID] > [ロール] を選択します。

3. [ロールの作成] をクリックし、信頼されたエンティティタイプとして [Alibaba Cloud Service] を選択します。

4. 以下の情報を設定します：

   • ロール名：ロールのカスタム名を入力します。

   • 信頼できるサービスの選択：[CloudMonitor/Cms] を選択します。

5. [完了] をクリックします。

ステップ 2：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 バケット名に置き換えてください。

2. 作成したカスタム権限ポリシーを RAM ロールにアタッチします。