Alibaba Cloud CLI writes its help information and error messages for human readers. An AI agent must parse this content, which increases the parsing cost and the number of retries. When you enable AI Mode, the CLI identifies the caller as an AI agent in the User-Agent of each request. Help information, error information, and next-step guidance then take a form that is easier for programs to parse. - Alibaba Cloud CLI

Alibaba Cloud CLI, yardım bilgilerini ve hata mesajlarını insan okuyucular için yazar. Bir AI ajanı bu içeriği ayrıştırmak zorundadır; bu durum ayrıştırma maliyetini ve yeniden deneme sayısını artırır. AI Modunu etkinleştirdiğinizde, CLI her isteğin User-Agent alanında arayanı bir AI ajanı olarak tanımlar. CLI'nin yerel çıktısı da programlar tarafından daha kolay ayrıştırılabilen bir biçime dönüşür.

Genel Bakış

AI Modu aşağıdaki değişiklikleri getirir:

Alibaba Cloud hizmetleri, sorun giderme ve çağrı istatistikleri için ajan çağrılarını manuel işlemlerden ayırmak amacıyla bu tanımlayıcıyı kullanır.
Bir ajan, CLI çıktısını doğrudan ayrıştırabilir; bu durum yeniden deneme sayısını azaltır.

Not

AI Modu, bir API çağrısının izinlerini veya istek parametrelerini değiştirmez.
AI Modu ileriye dönük uyumluluğu garanti etmez. Otomasyon iş akışınız AI Modunu kullanıyorsa sabit bir çıktı yapısına güvenmeyin.

AI Modu etkinleştirildiğinde davranış değişiklikleri

AI Modu özellikleri Alibaba Cloud CLI 3.5.0 veya sonraki sürümlerini gerektirir. AI Modunu etkinleştirdiğinizde, CLI'nin yerel çıktısı şunları içeren ancak bunlarla sınırlı olmayan şekillerde değişir:

CLI, yardım bilgilerini daha kompakt bir biçimde döndürür.
CLI, hata bilgilerini yapılandırılmış bir biçimde, hatanın nedeni ve sonraki adımla birlikte döndürür.
CLI, parametre değerlerini yerel olarak doğrular.
Çıktı renk kontrol karakterleri içermez.

İçerik özetlenmiş bir biçimde sunulduğunda, çıktı size tam içeriği nasıl alacağınızı bildirir.

AI Modunu yönetin

AI Modunu aliyun configure ai-mode komut grubuyla yönetin.

Geçerli yapılandırmayı görüntüleyin

AI Modunun geçerli yapılandırmasını görüntülemek için aşağıdaki komutu çalıştırın:

aliyun configure ai-mode show

Örnek çıktı:

{
  "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"
}

Alan açıklamaları:

Alan	Açıklama
`enabled`	AI Modunun etkin olup olmadığını belirtir.
`user_agent`	Özel User-Agent yetenek tanımlayıcısı segmenti. Boş bir değer, varsayılan değerin kullanıldığı anlamına gelir.
`effective_user_agent`	Etkili olan yetenek tanımlayıcısı segmenti: özel değer veya varsayılan değer `AlibabaCloud-Agent-Skills`.
`request_user_agent_suffix`	İsteğin User-Agent alanına eklenen tam sonek.
`config_file`	Yapılandırma dosyasının yolu.

AI Modunu etkinleştirin ve devre dışı bırakın

Komutla

AI Modunu etkinleştirmek veya devre dışı bırakmak için aşağıdaki komutları çalıştırın:

# Enable AI Mode
aliyun configure ai-mode enable

# Disable AI Mode
aliyun configure ai-mode disable

Ortam değişkeniyle

AI Modu durumu aşağıdaki ortam değişkenleri aracılığıyla iletilir. AI Modunu kontrol etmek için bu değişkenleri ayarlayabilirsiniz:

Ortam değişkeni	Açıklama
`ALIBABA_CLOUD_CLI_AI_MODE`	`1` veya `true` değeri AI Modunu etkinleştirir. `0` veya `false` değeri onu devre dışı bırakır.
`ALIBABA_CLOUD_CLI_AI_USER_AGENT`	AI Modu aktifken eklenen tam User-Agent soneki. Örnek: `AlibabaCloud-AIMode/enabled AlibabaCloud-Agent-Skills`.

Not

Bir ajan çalışma zamanı ortamında, geçerli oturum için AI Modunu etkinleştirmek üzere export ALIBABA_CLOUD_CLI_AI_MODE=1 komutunu çalıştırın. Bu ayar, oturumdaki her komuta uygulanır. Her komuta --cli-ai-mode bayrağını eklemeniz gerekmez. Yapılandırmayı kalıcı hale getirmek için configure ai-mode komutunu kullanın.

User-Agent yetenek tanımlayıcısı segmentini özelleştirin

Varsayılan yetenek tanımlayıcısı segmenti AlibabaCloud-Agent-Skills değeridir. Farklı AI ajanlarını ayırt etmek için bu değeri özelleştirin:

# 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

Özelleştirmeden sonra, isteğin User-Agent soneki şu hale gelir:

AlibabaCloud-AIMode/enabled MyAgent/1.0

Komut başına geçersiz kılma

Bir OpenAPI çağrısı yaptığınızda, yalnızca geçerli komut için genel AI Modu ayarını geçersiz kılmak amacıyla komut satırında bir bayrak kullanabilirsiniz:

Bayrak	Etki
`--cli-ai-mode`	AI Modu genel olarak devre dışı bırakılmış olsa bile bu komut için AI Modunu etkinleştirir.
`--no-cli-ai-mode`	AI Modu genel olarak etkinleştirilmiş olsa bile bu komut için AI Modunu devre dışı bırakır.

Aynı komutta her iki bayrak da görünürse --no-cli-ai-mode önceliklidir.

Örnekler:

# 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

Yapılandırma dosyası

AI Modu yapılandırma dosyasını manuel olarak görüntülemek veya yedeklemek için işletim sisteminize göre aşağıdaki yolda bulun:

İşletim sistemi	Yol
Linux / macOS	`~/.aliyun/ai-mode.json`
Windows	`C:\Users\<USER_NAME>\.aliyun\ai-mode.json`

Dosya biçimi örneği:

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

Alan açıklamaları:

Alan	Tür	Açıklama
`enabled`	boolean	AI Modunun etkinleştirilip etkinleştirilmeyeceğini belirtir. Varsayılan: `false`.
`user_agent`	dize (string)	Özel User-Agent yetenek tanımlayıcısı segmenti. Boşsa varsayılan değer `AlibabaCloud-Agent-Skills` kullanılır.

Not

Yapılandırma dosyası yoksa AI Modu varsayılan olarak devre dışıdır. Dosyayı manuel olarak düzenlemek yerine yapılandırmayı yönetmek için aliyun configure ai-mode komutunu kullanın.

Öncelik sırası

AI Modu ayarları aşağıdaki sıraya göre uygulanır (en yüksekten en düşüğe):

Komut satırı bayrakları (--cli-ai-mode / --no-cli-ai-mode)
Ortam değişkeni (ALIBABA_CLOUD_CLI_AI_MODE)
Yapılandırma dosyası (ai-mode.json)

Daha yüksek önceliğe sahip bir ayar etkili olduğunda, daha düşük önceliğe sahip ayarlar yoksayılır. Aynı komutta hem --cli-ai-mode hem de --no-cli-ai-mode belirtilirse --no-cli-ai-mode önceliklidir.

Kapsam

AI Modu aşağıdaki senaryolarda etkili olur:

OpenAPI çağrıları: Komutlar aracılığıyla başlatılan hem RPC hem de RESTful istekleri için User-Agent alanına AI tanımlayıcısı segmenti eklenir.
Eklenti komutları: CLI, AI Modu durumunu eklenti alt süreçlerine ALIBABA_CLOUD_CLI_AI_MODE ve ALIBABA_CLOUD_CLI_AI_USER_AGENT ortam değişkenleri aracılığıyla iletir; bu sayede eklentiler kendi isteklerine tanımlayıcıyı ekleyebilir.

Ek: Alt komut referansı

aliyun configure ai-mode altında kullanılabilen alt komutlar:

Alt komut	Açıklama
`show`	Geçerli AI Modu yapılandırmasını görüntüler.
`enable`	AI Modunu genel olarak etkinleştirir.
`disable`	AI Modunu genel olarak devre dışı bırakır.
`set-user-agent --user-agent <value>`	Özel bir User-Agent yetenek tanımlayıcısı segmenti ayarlar.
`reset-user-agent`	Yetenek tanımlayıcısı segmentini varsayılan değer `AlibabaCloud-Agent-Skills` olarak sıfırlar.
`set-ossutil --ossutil <json>`	ossutil eklenti ayarlarını yapılandırır (JSON dizesi).
`reset-ossutil`	ossutil eklenti ayarlarını temizler.