Simple Log Service:SLS DataAgent (sebelumnya Intelligent Q&A Assistant)

1. Masuk ke Konsol Log Service.

2. Pilih Log Apps > SLS DataAgent, lalu klik Digital Employee.

3. Pada halaman 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. ID ini tidak dapat diubah setelah dibuat. Disarankan menggunakan kombinasi huruf dan angka, seperti order-system-expert.
   Display name	Ya	Nama yang ditampilkan untuk digital employee di UI. Disarankan menggunakan nama yang mencerminkan tujuan bisnisnya, misalnya "Order System Monitoring Expert" atau "Big Data Cluster Inspector".
   RAM role type	Ya	Menentukan jenis RAM role untuk digital employee. Anda dapat memilih salah satu opsi berikut: • service role: Gunakan service role yang disediakan sistem (tidak perlu konfigurasi). Digital employee secara otomatis memperoleh izin baca untuk Log Service dan ARMS. • custom role: Pilih opsi ini jika Anda perlu mengakses basis pengetahuan Model Studio tertentu atau membatasi cakupan akses. Anda harus mengonfigurasi ARN RAM role yang telah diberi otorisasi. Untuk informasi selengkapnya, lihat Create and authorize a RAM role.
   RAM role ARN	Ya	Parameter ini hanya diperlukan jika Anda memilih custom role. Service role default menggunakan role ServiceRoleForCloudMonitor, yang memiliki izin baca untuk CloudMonitor, Log Service (SLS), dan ARMS.
   Built-in SLS knowledge base	Tidak	Jika diaktifkan, digital employee akan menjawab pertanyaan terkait SLS. Opsi ini diaktifkan secara default.
   Description	Tidak	Jelaskan tanggung jawab dan kemampuan digital employee. Contoh: "Bertanggung jawab atas inspeksi harian, analisis anomali, dan analisis akar masalah untuk aplikasi inti di pusat pesanan. Mampu menganalisis kueri MySQL yang lambat."
   Default rules	Tidak	Aturan default untuk mengarahkan perilaku digital employee. Disarankan menggunakan sintaks Markdown. Anda dapat menentukan peran, cakupan kemampuan, dan panduan perilaku digital employee.

5. Setelah mengonfigurasi parameter, klik OK.

Struktur basis pengetahuan SOP

Basis pengetahuan SOP menggunakan struktur modular berbasis direktori dengan SOP.md sebagai file entri inti. Struktur ini memungkinkan agent menemukan informasi yang dibutuhkan secara mandiri.

Berikut adalah struktur direktori yang direkomendasikan: accesslog_sop .zip

knowledge_base_root/
├── SOP.md                  # File entri inti, menjelaskan ikhtisar setiap domain pengetahuan
├── accesslog/              # Domain log akses
│   ├── overview.md         # Ikhtisar domain
│   └── troubleshooting.md  # Panduan troubleshooting
├── monitoring/             # Domain pemantauan
│   ├── overview.md
│   └── alert-handling.md
└── ...

Dalam SOP.md, berikan ikhtisar setiap domain pengetahuan, lalu sertakan informasi detail dalam file yang sesuai di masing-masing direktori.

Asosiasikan basis pengetahuan SLS bawaan

Basis pengetahuan SLS bawaan berisi prosedur operasi standar dan praktik terbaik untuk Log Service, yang membantu menjawab pertanyaan terkait SLS.

Metode 1: Aktifkan saat pembuatan

Saat membuat digital employee, biarkan sakelar Built-in SLS knowledge base tetap aktif.

Metode 2: Tambahkan setelah pembuatan

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

2. Pilih tab Knowledge base.

3. Klik Add Knowledge Base dan pilih tipe Built-in knowledge base.

4. Pada bidang Knowledge base ID, masukkan sls lalu klik OK.

Asosiasikan basis pengetahuan OSS

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

Prasyarat

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

• Anda telah membuat dan mengonfigurasi RAM role kustom. Untuk detailnya, lihat Create and authorize a RAM role.

Prosedur

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

2. Pada halaman detail digital employee, pilih tab Knowledge base.

3. Klik Add Knowledge Base dan pilih tipe OSS knowledge base.

4. Konfigurasikan parameter berikut:

   Parameter	Deskripsi
   OSS region	Wilayah tempat bucket OSS yang menyimpan dokumen SOP berada.
   OSS bucket	Nama bucket OSS.
   Document library root path	Jalur direktori tempat file SOP.md berada. Jika SOP.md berada di direktori root bucket, masukkan /. Jika berada di subdirektori, masukkan jalur lengkapnya, seperti /docs/sop/.

5. Klik OK.

Asosiasikan basis pengetahuan Alibaba Cloud DevOps

Jika Anda menggunakan Alibaba Cloud DevOps (Codeup) untuk mengelola dokumen SOP Anda, ikuti langkah-langkah berikut untuk mengasosiasikan basis pengetahuan Alibaba Cloud DevOps.

Prasyarat

• Anda telah membuat repositori kode di Konsol Alibaba Cloud DevOps dan mengunggah dokumen SOP Anda.

• Anda telah membuat personal access token.

Peroleh informasi konfigurasi

1. Organization ID: Anda dapat menemukan ID organisasi di URL halaman. Format URL-nya adalah https://codeup.aliyun.com/<Organization_ID>/<Repository_Name>\.

2. Repository ID: Di halaman repositori kode, pilih Settings > Basic Information untuk melihat ID-nya.

3. Personal access token:

   • Di Konsol Alibaba Cloud DevOps, klik gambar profil Anda di pojok kanan atas dan pilih Personal settings.

   • Pilih Personal access tokens lalu klik Create Access Token.

   • Tetapkan nama, tanggal kedaluwarsa, dan cakupan izin untuk token tersebut, lalu klik Create.

   • Salin dan simpan token yang dihasilkan secara aman. Token hanya ditampilkan sekali.

Prosedur

1. Pada halaman detail digital employee, pilih tab Knowledge base.

2. Klik Add Knowledge Base dan pilih tipe Alibaba Cloud DevOps knowledge base.

3. Konfigurasikan parameter berikut:

   Parameter	Deskripsi
   Organization ID	ID organisasi Alibaba Cloud DevOps Anda.
   Repository ID	ID repositori kode Anda.
   Branch name	Branch yang akan diasosiasikan, seperti master atau main.
   Personal access token	Personal access token Alibaba Cloud DevOps Anda.
   Document library root path	Jalur direktori tempat file SOP.md berada.

4. Klik OK.

Grant permissions to a RAM user

Untuk menggunakan SLS DataAgent sebagai RAM user, administrator harus terlebih dahulu memberikan izin yang diperlukan kepada Anda.

{
  "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 and authorize a RAM role

Jika Anda perlu menggunakan custom role, misalnya untuk mengakses basis pengetahuan OSS, ikuti langkah-langkah berikut untuk membuat dan memberi otorisasi RAM role.

Langkah 1: Buat RAM role

1. Masuk ke Konsol RAM.

2. Di panel navigasi sebelah kiri, pilih Identities > Roles.

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

4. Konfigurasikan informasi berikut:

   • Role name: Masukkan nama kustom untuk role tersebut.

   • Select trusted service: Pilih CloudMonitor/Cms.

5. Klik Complete.

Langkah 2: Beri otorisasi RAM role

1. Buat kebijakan izin kustom. Kebijakan berikut memberikan izin baca untuk OSS dan 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 aktual bucket OSS Anda.

2. Lampirkan kebijakan izin kustom yang telah Anda buat ke RAM role tersebut.