Simple Log Service:AI チャットアシスタント

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

2. [ログアプリケーション] > [AI チャットアシスタント] を選択し、[デジタル従業員] をクリックします。

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

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

   パラメーター	必須	説明
   ID	はい	デジタル従業員の一意の識別子です。作成後に変更することはできません。英数字のみを使用してください。例：order-system-expert。
   表示名	はい	コンソールに表示されるデジタル従業員の名前です。ビジネス固有の名前を使用してください。例：注文システム監視エキスパート、ビッグデータクラスターインスペクター。
   RAM ロールタイプ	はい	デジタル従業員の RAM ロールタイプを選択します。 • サービスロール：システム提供のサービスロールを使用します (設定不要)。デジタル従業員は、SLS および ARMS への読み取り専用アクセスを自動的に取得します。 • カスタムロール：特定の Model Studio ナレッジベースへのアクセスが必要な場合、またはアクセス範囲を制限したい場合は、このオプションを選択します。承認された RAM ロールの ARN を入力します。詳細については、「RAM ロールの作成と権限付与」をご参照ください。
   RAM ロール ARN	はい	サービスロールは、デフォルトで ServiceRoleForCloudMonitor を使用します。このロールは、Simple Log Service および ARMS を含む Cloud Monitor 2.0 データへの読み取り専用アクセス権を持っています。
   組み込み SLS ナレッジベース	いいえ	デジタル従業員が SLS 関連の質問に回答できるように、このオプションを有効にします。デフォルトで有効になっています。
   説明	いいえ	従業員の責任と強みを記述します。例：Order Hub のコアアプリケーションの日常的な検査を実行し、異常アラートを分析し、根本原因を特定し、MySQL スロークエリ分析をサポートします。
   デフォルトルール	いいえ	デジタル従業員の作業をガイドするデフォルトルールです。Markdown 構文を使用します。従業員のロール、機能範囲、および行動規範を定義します。

5. 構成後、[OK] をクリックします。

SOP ナレッジベースの構造

SOP ナレッジベースは、段階的なフォルダー構造を使用します。コアエントリファイルは SOP.md です。エージェントが構造から必要なナレッジを取得できるように、ファイルをモジュールごとに整理します。

推奨されるフォルダー構造：

Root directory of the knowledge base/
├── SOP.md                  # コアエントリファイル。ドメイン全体のナレッジを要約します。
├── accesslog/              # アクセスログドメイン
│   ├── overview.md         # ドメイン概要
│   └── troubleshooting.md  # トラブルシューティングガイド
├── monitoring/             # モニタリングドメイン
│   ├── overview.md
│   └── alert-handling.md
└── ...

SOP.md で各ドメインのナレッジの要約を記述できます。その後、各サブフォルダーの下にある対応するファイルに詳細なコンテンツを追加します。

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

組み込み SLS ナレッジベースには、Simple Log Service (SLS) の標準操作手順とベストプラクティスが含まれています。これは、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 Region	ご利用の OSS バケットが存在するリージョン。
   OSS Bucket	ご利用の OSS バケット名。
   ナレッジベースのルートパス	SOP.md ファイルを含むディレクトリパス。SOP.md がバケットルートにある場合は / と入力します。サブディレクトリにある場合は、完全なパスを入力します。例：/docs/sop/。

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

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

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

前提条件

• コードリポジトリを作成し、Apsara Devops コンソールに SOP ドキュメントをアップロードしました。

• Personal Access Token (PAT) が作成済みであること。

構成情報の取得

1. 組織 ID：Apsara Devops コンソールで、コードリポジトリをクリックします。URL から組織 ID をコピーできます。URL 形式は https://codeup.aliyun.com/organization-ID/repository-name です。

2. リポジトリ ID：リポジトリページで、[設定項目] > [基本情報] に移動します。

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

   • Apsara Devops コンソールで、右上隅にあるプロフィール画像をクリックし、[個人設定] を選択します。

   • [パーソナルアクセストークン] を選択し、[アクセストークンの作成] をクリックします。

   • トークン名を入力し、有効期限と権限を設定して、[作成] をクリックします。

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

手順

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

2. [ナレッジベースの追加] をクリックし、[Apsara Devops ナレッジベース] を選択します。

3. 以下のパラメーターを構成します。

   パラメーター	説明
   組織 ID	Apsara DevOps 組織 ID
   リポジトリ ID	ご利用のコードリポジトリ ID。
   ブランチ名	関連付けるブランチ。例：master または main。
   パーソナルアクセストークン	ご利用の Apsara Devops パーソナルアクセストークン。
   ナレッジベースのルートパス	SOP.md ファイルを含むディレクトリパス。

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

RAM ユーザーへの権限付与

RAM ユーザーを使用して AI チャットアシスタントを操作する場合、管理者は必要な権限を付与する必要があります。

{
  "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. Resource Access Management (RAM) コンソールにログインします。Resource Access Management (RAM) コンソール。

2. 左側のナビゲーションウィンドウで、[ID 管理] > [ロール] を選択します。

3. [ロールの作成] をクリックし、信頼できるエンティティタイプとして Alibaba Cloud サービスを選択します。

4. 以下を構成します。

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

   • 信頼できるサービス：Cloud Monitor/Cms を選択します。

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

ステップ 2: RAM ロールへの権限付与

1. カスタムポリシーを作成できます。以下のポリシーは、OSS および Simple Log Service (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 ロールにアタッチできます。