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

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

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

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

4. [Create Digital Employee] ダイアログボックスで、次のパラメーターを設定します：

   パラメーター	必須	説明
   ID	はい	デジタル従業員の一意の識別子です。この ID は、作成後に変更できません。 order-system-expert のように、英字と数字の組み合わせを推奨します。
   表示名	はい	UI で表示されるデジタル従業員の名前です。「Order System Monitoring Expert」や「Big Data Cluster Inspector」のように、業務目的を反映した名前を推奨します。
   RAM ロールタイプ	はい	デジタル従業員に使用する RAM ロールのタイプを指定します。次のいずれかを選択できます： • サービスロール： システム提供のサービスロールを使用します (設定は不要)。デジタル従業員は CloudMonitor、Log Service (SLS)、および 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 ナレッジベースには、SLS の標準操作手順とベストプラクティスが含まれており、SLS 関連の質問への回答に役立ちます。

方法 1： 作成時に有効化

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

方法 2： 作成後に追加

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

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

3. [Add Knowledge Base] をクリックし、[Built-in knowledge base] タイプを選択します。

4. [Knowledge base ID] フィールドに sls を入力し、[OK] をクリックします。

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

SOP ドキュメントを OSS に保存している場合は、次の手順で OSS ナレッジベースを関連付けます。

前提条件

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

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

手順

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

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

3. [Add Knowledge Base] をクリックし、[OSS knowledge base] タイプを選択します。

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. Organization ID： Organization ID は、ページ URL で確認できます。URL の形式は https://codeup.aliyun.com/<Organization_ID>/<Repository_Name>\ です。

2. Repository ID： コードリポジトリのページで [設定] > [Basic Information] を選択し、ID を確認します。

3. パーソナルアクセストークン：

   • Alibaba Cloud DevOps コンソールで右上のプロフィール画像をクリックし、[Personal settings] を選択します。

   • [Personal access tokens] を選択し、[Create Access Token] をクリックします。

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

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

手順

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

2. [Add Knowledge Base] をクリックし、[Alibaba Cloud DevOps knowledge base] タイプを選択します。

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

   パラメーター	説明
   Organization ID	Alibaba Cloud DevOps 組織の ID です。
   Repository ID	コードリポジトリの ID です。
   Branch name	master や main など、関連付けるブランチです。
   Personal access token	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. 左側メニューで、[Identities] > [Roles] を選択します。

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

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

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

   • Select trusted service：[CloudMonitor/Cms] を選択します。

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

手順 2： RAM ロールの認可

1. カスタム許可ポリシーを作成します。次のポリシーは、OSS と SLS の読み取り権限を付与します：

{
  "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 ロールにアタッチします。