Alibaba Cloud CLI menulis informasi bantuan dan pesan error-nya untuk pembaca manusia. Agen AI harus mengurai konten ini, yang meningkatkan biaya penguraian dan jumlah percobaan ulang. Saat Anda mengaktifkan AI Mode, CLI mengidentifikasi pemanggil sebagai agen AI dalam User-Agent setiap permintaan. Informasi bantuan, informasi error, dan panduan langkah berikutnya kemudian disajikan dalam bentuk yang lebih mudah diurai oleh program. - Alibaba Cloud CLI

Alibaba Cloud CLI menulis informasi bantuan dan pesan error untuk pembaca manusia. Agen AI harus mengurai konten tersebut, yang meningkatkan biaya penguraian dan jumlah percobaan ulang. Saat Anda mengaktifkan AI Mode, CLI mengidentifikasi pemanggil sebagai agen AI dalam User-Agent setiap permintaan, dan output lokal CLI berubah menjadi format yang lebih mudah diurai oleh program.

Ikhtisar

AI Mode membawa perubahan berikut:

Layanan Alibaba Cloud menggunakan pengenal ini untuk membedakan panggilan agen dari operasi manual guna keperluan troubleshooting dan statistik panggilan.
Agen dapat mengurai output CLI secara langsung, sehingga mengurangi jumlah percobaan ulang.

Catatan

AI Mode tidak mengubah izin panggilan API atau parameter permintaan.
AI Mode tidak menjamin kompatibilitas maju (forward compatibility). Jika alur kerja otomatisasi Anda menggunakan AI Mode, jangan bergantung pada struktur output yang tetap.

Perubahan perilaku saat AI Mode diaktifkan

Fitur AI Mode memerlukan Alibaba Cloud CLI versi 3.5.0 atau lebih baru. Saat AI Mode diaktifkan, output lokal CLI berubah dalam cara-cara berikut, termasuk namun tidak terbatas pada:

CLI mengembalikan informasi bantuan dalam bentuk yang lebih ringkas.
CLI mengembalikan informasi error dalam format terstruktur, mencakup penyebab kegagalan dan langkah berikutnya.
CLI melakukan validasi nilai parameter secara lokal.
Output tidak mengandung karakter kontrol warna.

Saat konten disajikan dalam bentuk ringkasan, output akan memberi tahu cara mengambil konten lengkapnya.

Manage AI Mode

Kelola AI Mode dengan grup perintah aliyun configure ai-mode.

View the current configuration

Jalankan perintah berikut untuk melihat konfigurasi AI Mode 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"
}

Deskripsi bidang:

Field	Description
`enabled`	Menunjukkan apakah AI Mode diaktifkan.
`user_agent`	Segmen pengenal keterampilan (skills identifier segment) User-Agent kustom. Nilai kosong berarti menggunakan nilai default.
`effective_user_agent`	Segmen pengenal keterampilan yang berlaku: nilai kustom atau nilai default `AlibabaCloud-Agent-Skills`.
`request_user_agent_suffix`	Akhiran lengkap yang ditambahkan ke User-Agent permintaan.
`config_file`	Jalur menuju file konfigurasi.

Enable and disable AI Mode

By command

Jalankan perintah berikut untuk mengaktifkan atau menonaktifkan AI Mode:

# Enable AI Mode
aliyun configure ai-mode enable

# Disable AI Mode
aliyun configure ai-mode disable

By environment variable

Status AI Mode diteruskan melalui variabel lingkungan berikut. Anda dapat mengatur variabel ini untuk mengontrol AI Mode:

Environment variable	Description
`ALIBABA_CLOUD_CLI_AI_MODE`	Nilai `1` atau `true` mengaktifkan AI Mode. Nilai `0` atau `false` menonaktifkannya.
`ALIBABA_CLOUD_CLI_AI_USER_AGENT`	Akhiran User-Agent lengkap yang ditambahkan saat AI Mode aktif. Contoh: `AlibabaCloud-AIMode/enabled AlibabaCloud-Agent-Skills`.

Catatan

Dalam lingkungan runtime agen, jalankan export ALIBABA_CLOUD_CLI_AI_MODE=1 untuk mengaktifkan AI Mode pada sesi saat ini. Pengaturan ini berlaku untuk setiap perintah dalam sesi tersebut. Anda tidak perlu menambahkan flag --cli-ai-mode pada setiap perintah. Untuk menyimpan konfigurasi secara permanen, gunakan perintah configure ai-mode.

Customize the User-Agent skills identifier segment

Segmen pengenal keterampilan default adalah AlibabaCloud-Agent-Skills. Untuk membedakan antar agen AI yang berbeda, sesuaikan nilai ini:

# Set a custom skills identifier segment
aliyun configure ai-mode set-user-agent --user-agent "MyAgent/1.0"

# Reset to the default value
aliyun configure ai-mode reset-user-agent

Setelah penyesuaian, akhiran User-Agent permintaan menjadi:

AlibabaCloud-AIMode/enabled MyAgent/1.0

Per-command override

Saat membuat panggilan OpenAPI, Anda dapat menggunakan flag di baris perintah untuk mengganti pengaturan global AI Mode hanya untuk perintah saat ini:

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

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

Contoh:

# AI Mode is disabled globally, but this command appends the AI identifier
aliyun ecs DescribeInstances --cli-ai-mode

# AI Mode is enabled globally, but this command does not append the identifier
aliyun ecs DescribeInstances --no-cli-ai-mode

Configuration file

Untuk melihat atau mencadangkan file konfigurasi AI Mode secara manual, temukan di jalur berikut sesuai sistem operasi Anda:

Operating system	Path
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"
}

Deskripsi bidang:

Field	Type	Description
`enabled`	boolean	Menentukan apakah AI Mode diaktifkan. Default: `false`.
`user_agent`	string	Segmen pengenal keterampilan User-Agent kustom. Jika kosong, nilai default `AlibabaCloud-Agent-Skills` digunakan.

Catatan

Jika file konfigurasi tidak ada, AI Mode dinonaktifkan secara default. Gunakan perintah aliyun configure ai-mode untuk mengelola konfigurasi, bukan mengedit file secara manual.

Precedence

Pengaturan AI Mode diterapkan dalam urutan berikut (dari prioritas tertinggi ke terendah):

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

Saat pengaturan dengan prioritas lebih tinggi berlaku, pengaturan dengan prioritas lebih rendah diabaikan. Jika kedua flag --cli-ai-mode dan --no-cli-ai-mode ditentukan dalam perintah yang sama, --no-cli-ai-mode memiliki prioritas lebih tinggi.

Scope

AI Mode berlaku dalam skenario berikut:

OpenAPI calls: Segmen pengenal AI ditambahkan ke User-Agent untuk permintaan RPC dan RESTful yang dimulai melalui perintah.
Plugin commands: CLI meneruskan status AI Mode ke proses anak plugin melalui variabel lingkungan ALIBABA_CLOUD_CLI_AI_MODE dan ALIBABA_CLOUD_CLI_AI_USER_AGENT, memungkinkan plugin menambahkan pengenal tersebut ke permintaan mereka sendiri.

Appendix: Subcommand reference

Subperintah yang tersedia di bawah aliyun configure ai-mode:

Subcommand	Description
`show`	Menampilkan konfigurasi AI Mode saat ini.
`enable`	Mengaktifkan AI Mode secara global.
`disable`	Menonaktifkan AI Mode secara global.
`set-user-agent --user-agent <value>`	Menetapkan segmen pengenal keterampilan User-Agent kustom.
`reset-user-agent`	Mengatur ulang segmen pengenal keterampilan ke nilai default `AlibabaCloud-Agent-Skills`.
`set-ossutil --ossutil <json>`	Mengonfigurasi pengaturan plugin ossutil (string JSON).
`reset-ossutil`	Menghapus pengaturan plugin ossutil.