Mode AI di Alibaba Cloud CLI menambahkan identifikasi khusus ke User-Agent pada permintaan API. Hal ini membantu sisi server mengidentifikasi, mengaudit, dan menganalisis permintaan dari agen AI. Kelola fitur ini menggunakan perintah atau file konfigurasinya. - Alibaba Cloud CLI

Mode AI adalah fitur yang diperkenalkan di Alibaba Cloud CLI versi 3.3.3. Saat diaktifkan, CLI menambahkan segmen identifikasi AI ke User-Agent setiap permintaan API, memungkinkan sisi server mengenali permintaan yang berasal dari agen AI.

Ikhtisar

Saat Mode AI diaktifkan, CLI menambahkan segmen identifikasi AI dalam format berikut ke User-Agent setiap permintaan API:

AlibabaCloud-AIMode/enabled AlibabaCloud-Agent-Skills

Di mana:

AlibabaCloud-AIMode/enabled adalah awalan tetap yang menunjukkan Mode AI aktif.
AlibabaCloud-Agent-Skills adalah segmen identifikasi keterampilan default yang dapat Anda sesuaikan.

Tujuan utama segmen identifikasi AI adalah:

Membedakan antara permintaan API dari agen AI dan permintaan dari operasi manual.
Memungkinkan server melakukan audit, pembatasan laju, dan analisis statistik berdasarkan identitas agen.

Catatan

Mode AI hanya memengaruhi identifikasi User-Agent dan tidak mengubah perilaku atau izin panggilan API.

Kelola Mode AI

Gunakan grup perintah aliyun configure ai-mode untuk mengelola Mode AI.

Lihat konfigurasi saat ini

Jalankan perintah berikut untuk melihat konfigurasi Mode AI saat ini:

aliyun configure ai-mode show

Contoh output:

{
  "enabled": true,
  "user_agent": "",
  "effective_user_agent": "AlibabaCloud-Agent-Skills",
  "request_user_agent_suffix": "AlibabaCloud-AIMode/enabled AlibabaCloud-Agent-Skills",
  "config_file": "/home/user/.aliyun/ai-mode.json"
}

Penjelasan bidang:

Parameter	Deskripsi
`enabled`	Apakah Mode AI diaktifkan.
`user_agent`	Segmen identifikasi keterampilan kustom. Nilai kosong berarti menggunakan nilai default.
`effective_user_agent`	Segmen identifikasi keterampilan efektif. Ini merupakan nilai kustom atau nilai default `AlibabaCloud-Agent-Skills`.
`request_user_agent_suffix`	Akhiran lengkap yang ditambahkan ke User-Agent.
`config_file`	Jalur ke file konfigurasi.

Aktifkan dan nonaktifkan Mode AI

Jalankan perintah berikut untuk mengaktifkan atau menonaktifkan Mode AI:

# Aktifkan Mode AI
aliyun configure ai-mode enable

# Nonaktifkan Mode AI
aliyun configure ai-mode disable

Menyesuaikan segmen identifikasi keterampilan

Segmen identifikasi keterampilan default adalah AlibabaCloud-Agent-Skills. Jika Anda perlu membedakan berbagai agen AI, Anda dapat menyesuaikan nilai ini:

# Tetapkan segmen identifikasi keterampilan kustom
aliyun configure ai-mode set-user-agent --user-agent "MyAgent/1.0"

# Kembalikan ke nilai default
aliyun configure ai-mode reset-user-agent

Setelah disesuaikan, akhiran User-Agent dalam permintaan berubah menjadi:

AlibabaCloud-AIMode/enabled MyAgent/1.0

Penggantian per perintah

Anda dapat menggunakan flag baris perintah untuk mengganti pengaturan global Mode AI pada perintah tertentu.

Flag	Efek
`--cli-ai-mode`	Mengaktifkan Mode AI hanya untuk perintah ini, meskipun dinonaktifkan secara global.
`--no-cli-ai-mode`	Menonaktifkan Mode AI hanya untuk perintah ini, meskipun diaktifkan secara global.

Jika kedua flag digunakan dalam satu perintah yang sama, --no-cli-ai-mode memiliki prioritas lebih tinggi.

Contoh:

# Mode AI dinonaktifkan secara global, tetapi perintah ini menambahkan identifikasi AI
aliyun ecs DescribeInstances --cli-ai-mode

# Mode AI diaktifkan secara global, tetapi perintah ini tidak menambahkan identifikasi
aliyun ecs DescribeInstances --no-cli-ai-mode

Variabel lingkungan

CLI menggunakan variabel lingkungan berikut untuk mengekspos status Mode AI ke proses anak plugin:

Variabel lingkungan	Deskripsi
`ALIBABA_CLOUD_CLI_AI_MODE`	Nilai `1` menunjukkan bahwa Mode AI aktif.
`ALIBABA_CLOUD_CLI_AI_USER_AGENT`	Akhiran User-Agent lengkap yang ditambahkan saat Mode AI aktif. Contohnya, `AlibabaCloud-AIMode/enabled AlibabaCloud-Agent-Skills`.

Catatan

Variabel lingkungan ini secara otomatis disisipkan oleh program CLI utama saat menjalankan proses anak plugin. Anda tidak perlu mengaturnya secara manual. Untuk mengontrol Mode AI, gunakan perintah configure ai-mode atau flag baris perintah --cli-ai-mode.

File konfigurasi

File konfigurasi Mode AI terletak di jalur berikut:

Sistem operasi	Jalur
Linux / macOS	`~/.aliyun/ai-mode.json`
Windows	`C:\Users\<USER_NAME>\.aliyun\ai-mode.json`

Contoh format file:

{
  "enabled": true,
  "user_agent": "MyAgent/1.0"
}

Penjelasan bidang:

Parameter	Tipe	Deskripsi
`enabled`	boolean	Apakah akan mengaktifkan Mode AI. Nilai default-nya adalah `false`.
`user_agent`	string	Segmen identifikasi keterampilan User-Agent kustom. Jika kosong, nilai default `AlibabaCloud-Agent-Skills` digunakan.

Catatan

Jika file konfigurasi tidak ada, Mode AI dinonaktifkan secara default. Kelola konfigurasi dengan perintah aliyun configure ai-mode alih-alih mengedit file secara manual.

Presedensi

CLI menerapkan pengaturan Mode AI dalam urutan prioritas berikut (dari tertinggi ke terendah):

Flag baris perintah (--cli-ai-mode / --no-cli-ai-mode)
File konfigurasi (ai-mode.json)

Saat flag baris perintah dan pengaturan file konfigurasi keduanya tersedia, flag baris perintah memiliki prioritas lebih tinggi. Jika kedua flag --cli-ai-mode dan --no-cli-ai-mode ditentukan dalam satu perintah yang sama, --no-cli-ai-mode memiliki prioritas lebih tinggi.

Cakupan

Identifikasi AI dalam User-Agent berlaku dalam skenario berikut:

Panggilan API: Segmen identifikasi AI ditambahkan ke User-Agent untuk permintaan RPC dan RESTful yang diprakarsai oleh perintah.
Perintah plugin: CLI meneruskan status Mode AI ke proses anak plugin melalui variabel lingkungan (ALIBABA_CLOUD_CLI_AI_MODE dan ALIBABA_CLOUD_CLI_AI_USER_AGENT), sehingga plugin dapat menambahkan identifikasi yang sesuai ke permintaannya sendiri.

Lampiran: Referensi subperintah

Subperintah berikut tersedia di bawah aliyun configure ai-mode:

Subperintah	Deskripsi
`show`	Lihat konfigurasi Mode AI saat ini.
`enable`	Aktifkan Mode AI secara global.
`disable`	Nonaktifkan Mode AI secara global.
`set-user-agent --user-agent <value>`	Menetapkan segmen identifikasi keterampilan kustom.
`reset-user-agent`	Mengembalikan segmen identifikasi keterampilan ke nilai default-nya, `AlibabaCloud-Agent-Skills`.
`set-ossutil --ossutil <json>`	Menetapkan pengaturan khusus plugin ossutil (sebuah string JSON).
`reset-ossutil`	Menghapus pengaturan khusus plugin ossutil.