Simple Log Service:AI Chat Assistant

1. Masuk ke Konsol Simple Log Service.

2. Pilih Log Applications > AI Chat Assistant, lalu klik Digital Employees.

3. Pada halaman daftar digital employee, klik Create Digital Employee di pojok kanan atas.

4. Pada kotak dialog Create Digital Employee, konfigurasikan parameter berikut:

   Parameter	Wajib	Deskripsi
   ID	Ya	Identifier unik untuk digital employee. Anda tidak dapat mengubahnya setelah pembuatan. Gunakan hanya huruf dan angka. Contoh: order-system-expert.
   Display name	Ya	Nama yang ditampilkan untuk digital employee di konsol. Gunakan nama yang spesifik untuk bisnis Anda. Contohnya: Order System Monitoring Expert atau Big Data Cluster Inspector.
   RAM role type	Ya	Pilih tipe peran RAM untuk digital employee: • Service role: Menggunakan peran layanan yang disediakan sistem (tidak perlu pengaturan tambahan). Digital employee otomatis mendapatkan akses read-only ke Simple Log Service dan ARMS. • Custom role: Pilih opsi ini jika Anda memerlukan akses ke basis pengetahuan Model Studio tertentu atau ingin membatasi cakupan akses. Masukkan ARN dari peran RAM yang telah diberi otorisasi. Untuk detailnya, lihat Create a RAM role and grant permissions.
   RAM role ARN	Ya	Peran layanan menggunakan ServiceRoleForCloudMonitor secara default. Peran ini memiliki akses read-only ke data Cloud Monitor 2.0, termasuk Simple Log Service dan ARMS.
   Built-in SLS knowledge base	Tidak	Aktifkan opsi ini agar digital employee dapat menjawab pertanyaan terkait SLS. Diaktifkan secara default.
   Description	Tidak	Jelaskan tanggung jawab dan keunggulan digital employee tersebut. Contohnya: Melakukan inspeksi harian aplikasi inti di Order Hub, menganalisis peringatan anomali, mengidentifikasi akar masalah, serta mendukung analisis slow-query MySQL.
   Default rule	Tidak	Aturan default yang mengarahkan pekerjaan digital employee. Gunakan sintaks Markdown. Definisikan peran, cakupan kemampuan, dan kode etik digital employee tersebut.

5. Setelah dikonfigurasi, klik OK.

Struktur basis pengetahuan SOP

Basis pengetahuan SOP menggunakan struktur folder progresif. File entri utamanya adalah SOP.md. Kelompokkan file berdasarkan modul agar agen dapat mengambil pengetahuan yang diperlukan dari struktur tersebut.

Kami merekomendasikan struktur folder berikut:

Root directory of the knowledge base/
├── SOP.md                  # Core entry file. Summarizes knowledge across domains.
├── accesslog/              # Access log domain
│   ├── overview.md         # Domain overview
│   └── troubleshooting.md  # Troubleshooting guide
├── monitoring/             # Monitoring domain
│   ├── overview.md
│   └── alert-handling.md
└── ...

Anda dapat menjelaskan ringkasan pengetahuan untuk setiap domain dalam file SOP.md. Kemudian tambahkan konten detail di file yang sesuai di bawah masing-masing subfolder.

Hubungkan basis pengetahuan SLS bawaan

Basis pengetahuan SLS bawaan mencakup prosedur operasional standar dan praktik terbaik untuk Simple Log Service. Basis pengetahuan ini membantu menjawab pertanyaan terkait SLS.

Metode 1: Aktifkan saat pembuatan

Pastikan toggle Built-in SLS knowledge base tetap aktif saat membuat digital employee.

Metode 2: Tambahkan setelah pembuatan

1. Pada daftar digital employee, klik digital employee target untuk membuka halaman detailnya.

2. Klik tab Knowledge Bases.

3. Klik Add Knowledge Base dan pilih Built-in Knowledge Base.

4. Pada Knowledge Base ID, masukkan sls, lalu klik OK.

Hubungkan basis pengetahuan OSS

Jika dokumen SOP Anda disimpan di OSS, ikuti langkah-langkah berikut untuk menghubungkan basis pengetahuan OSS.

Prasyarat

• Anda telah membuat bucket OSS dan mengunggah dokumen SOP Anda.

• Anda telah membuat dan mengonfigurasi peran RAM kustom. Untuk informasi lebih lanjut, lihat Create a RAM role and grant permissions.

Prosedur

1. Ubah tipe peran RAM digital employee menjadi Custom role dan masukkan ARN dari peran RAM yang telah diberi otorisasi.

2. Pada halaman detail digital employee, klik tab Knowledge Bases.

3. Klik Add Knowledge Base dan pilih OSS Knowledge Base.

4. Konfigurasikan parameter berikut:

   Parameter	Deskripsi
   OSS Region	Wilayah tempat bucket OSS Anda berada.
   OSS Bucket	Nama bucket OSS Anda.
   Root path of the knowledge base	Jalur direktori yang berisi file SOP.md. Jika SOP.md berada di root bucket, masukkan /. Jika berada di subdirektori, masukkan jalur lengkapnya. Contohnya: /docs/sop/.

5. Klik OK.

Hubungkan basis pengetahuan Apsara Devops

Jika Anda mengelola dokumen SOP di Apsara Devops (Codeup), ikuti langkah-langkah berikut untuk menghubungkan basis pengetahuan Apsara Devops.

Prasyarat

• Anda telah membuat repositori kode dan mengunggah dokumen SOP di Konsol Apsara Devops.

• Personal Access Token (PAT) Anda telah dibuat.

Dapatkan informasi konfigurasi

1. Organization ID: Di Konsol Apsara Devops, klik repositori kode Anda. Anda dapat menyalin Organization ID dari URL. Format URL-nya adalah https://codeup.aliyun.com/organization-ID/repository-name.

2. Repository ID: Di halaman repositori, buka Settings > Basic Information.

3. Personal access token:

   • Di Konsol Apsara Devops, klik foto profil Anda di pojok kanan atas dan pilih Personal Settings.

   • Pilih Personal Access Tokens, lalu klik Create Access Token.

   • Masukkan nama token, atur masa berlaku dan izin, lalu klik Create.

   • Salin dan simpan token yang dihasilkan. Anda hanya dapat melihatnya sekali.

Prosedur

1. Pada halaman detail digital employee, klik tab Knowledge Bases.

2. Klik Add Knowledge Base dan pilih Apsara Devops Knowledge Base.

3. Konfigurasikan parameter berikut:

   Parameter	Deskripsi
   Organization ID	ID organisasi Apsara DevOps
   Repository ID	ID repositori kode Anda.
   Branch name	Branch yang akan dihubungkan. Contohnya: master atau main.
   Personal access token	Personal access token Apsara Devops Anda.
   Root path of the knowledge base	Jalur direktori yang berisi file SOP.md.

4. Klik OK.

Grant permissions to RAM users

Jika Anda menggunakan RAM user untuk mengoperasikan AI Chat Assistant, administrator Anda harus memberikan izin yang diperlukan.

{
  "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/*"
      ]
    }
  ]
}

Create a RAM role and grant permissions

Jika Anda memerlukan peran kustom—misalnya, untuk mengakses basis pengetahuan OSS—ikuti langkah-langkah berikut untuk membuat dan memberi otorisasi peran RAM.

Langkah 1: Buat peran RAM

1. Masuk ke Konsol Resource Access Management (RAM).

2. Di panel navigasi sebelah kiri, pilih Identity Management > Roles.

3. Klik Create Role dan pilih Alibaba Cloud Service sebagai tipe entitas tepercaya.

4. Konfigurasikan hal berikut:

   • Role name: Masukkan nama peran kustom.

   • Trusted service: Pilih Cloud Monitor/Cms.

5. Klik Complete.

Langkah 2: Berikan izin kepada peran RAM

1. Buat kebijakan kustom. Kebijakan berikut memberikan akses read-only ke OSS dan Simple 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": "*"
    }
  ]
}

Catatan: Ganti <OSS_BUCKET_NAME> dengan nama bucket OSS Anda yang sebenarnya.

2. Hubungkan kebijakan kustom tersebut ke peran RAM.