Alibaba Cloud Linux 4 Agentic Edition (Agentic OS) provides multiple authentication methods, model switching and hierarchical configuration management, and supports flexible configuration management methods. - Alibaba Cloud Linux

Alibaba Cloud Linux 4 Agentic Edition (Agentic OS), kimlik doğrulama, model, araç ve diğer ayarları hiyerarşik bir yapılandırma sistemi aracılığıyla yönetir; proje düzeyi ve kullanıcı düzeyi yapılandırma dosyalarının çok katmanlı kapsamını destekler. Bu konu, çoklu kimlik doğrulama yöntemlerinin erişim yollarını, model değiştirme işlemlerini ve yapılandırma dosyalarının hiyerarşik önceliği ile temel yapılandırma öğelerinin açıklamalarını sunar.

1 Kimlik doğrulama yöntemi

Agentic OS'in ilk başlatılışında, büyük dil modeli hizmetine bağlanmak için kimlik doğrulama gerekir. Daha sonra /auth komutunu kullanarak kimlik doğrulama modunu değiştirebilirsiniz.

Şu anda aşağıdaki kimlik doğrulama yöntemleri desteklenmektedir.

Alibaba Cloud Kimlik Doğrulaması

Etkileşimli arayüzde "Aliyun Authentication" seçeneğini belirleyerek belirli miktarda ücretsiz kredi elde edebilirsiniz.

ECS ortamında, terminal yetkilendirme URL'sini ve QR kodunu görüntüler. Tarayıcıda URL'yi açın veya cep telefonunuzla QR kodunu tarayarak Alibaba Cloud hesabınızda oturum açıp yetkilendirmeyi tamamlayın.
ECS dışı ortamlarda Alibaba Cloud AK/SK kimlik doğrulamasını kullanın.
- AK/SK alma:
  1. Alibaba Cloud konsolunda oturum açın.
  2. AccessKey yönetim sayfasında anahtar oluşturun.

Alibaba Cloud üzerinden kimliği doğrulanmış kullanıcılar, bireysel geliştirme ve test senaryolarına uygun olan ücretsiz API çağrı kotasından yararlanabilir.

Not: Alibaba Cloud kimlik doğrulama yöntemi yalnızca Qianwen serisi metin modellerini destekler ve çok modlu modelleri desteklemez.

Bailian Kimlik Doğrulaması

Bailian Kimlik Doğrulaması önceden hazırlanmış Base Url sunar. Coding Plan, Token Plan ve özel model kimlik doğrulama yöntemini seçebilir, kimlik doğrulama için API Key sağlayabilirsiniz.

OpenAI Uyumlu Uç Nokta API Anahtarı Kimlik Doğrulaması

Etkileşimli arayüzde "OpenAI Compatible" seçeneğini belirleyin ve API Key'i hazırlayın. Desteklenen OpenAI uyumlu uç noktalar şunlardır:

Özel Base URL: Yerel olarak dağıtılan modeller (örneğin vLLM, Ollama), üçüncü taraf API proxy hizmetleri vb.

Kimlik doğrulama yönetimi

İşlem	Komut
Mevcut kimlik doğrulama durumunu görüntüleyin	`/auth`
Kimlik doğrulama yöntemini değiştirin	`/auth` (Etkileşimli menüden seçin)

SSS : Kimlik doğrulama başarısız olduğunda, API Key'in doğru olup olmadığını (öncesindeki ve sonrasındaki boşluklara dikkat edin) ve ağın ilgili API uç noktasına erişip erişemediğini kontrol edin. Agentic OS, aynı anda birden fazla kimlik doğrulama yapılandırmasını destekler. Önceliğe göre seçim yapılır. Ayrıca /auth aracılığıyla manuel geçiş yapabilirsiniz.

2 Model yapılandırması

Modeli değiştirin

/auth komutunu kullanarak mevcut oturumdaki modeli değiştirin, yapılandırılmış kimlik doğrulama ayarını seçin ve ardından "Set as active provider" seçeneğini belirleyin.

3 Yapılandırma dosyaları

Yapılandırma düzeyleri ve öncelikleri

Agentic OS'in sistem Shell giriş noktası olan cosh, ayarları yönetmek için JSON formatlı yapılandırma dosyalarını kullanır. Öncelik sırası yüksekten düşüğe şöyledir:

Command line parameters > Environment variables > Project configuration > User configuration > Default value

Yapılandırma dosyası konumu

Tür	Yol	Açıklama
Sistem ayarları	`/etc/copilot-shell/config.toml`	Yönetici varsayılanları
Kullanıcı ayarları	`~/.copilot-shell/config.toml`	Kişisel genel yapılandırma
Proje ayarları	`.copilot-shell/config.toml` (proje kök dizini)	Proje düzeyi yapılandırma ekip tarafından paylaşılabilir

Yapılandırma dosyası konumu

Tür	Yol	Açıklama
Sistem ayarları	`/etc/copilot-shell/config.toml`	Yönetici varsayılanları
Kullanıcı ayarları	`~/.copilot-shell/config.toml`	Kişisel genel yapılandırma
Proje ayarları	`.copilot-shell/config.toml` (proje kök dizini)	Proje düzeyi yapılandırma ekip tarafından paylaşılabilir

cosh-core, yapılandırmaları sistem → kullanıcı → proje sırasıyla birleştirir. Proje yapılandırması Agent, Hook, Skill, oturum, active_model ve yanıt dili tercihini ayarlayabilir; ancak active_provider, Provider tanımı, MCP sunucusu ve proje denetim ayarlarını yok sayar. cosh-shell yalnızca kullanıcı dosyalarını okur; sistem veya proje dosyalarını okumaz.

Temel yapılandırma öğeleri

ai --- AI ve model ayarları

Yapılandırma öğesi	Tür	Varsayılan değer	Açıklama
`active_provider`	dize	---	Şu anda etkin olan Provider
`active_model`	dize	---	Şu anda kullanılan modelin adı
`output_language`	dize	---	Yanıt dili tercihi
`thinking`	dize	---	Düşünme modu tercihi

ai.providers. --- Provider tanımı

Yapılandırma öğesi	Tür	Varsayılan değer	Açıklama
`type`	dize	---	Provider türü, örneğin `dashscope`, `openai_compat`, `aliyun`
`base_url`	dize	---	API base URL
`api_key`	dize	---	API anahtarı; `${VAR_NAME}` ortam değişkeni genişletmesi önerilir
`model`	dize	---	Provider'ın varsayılan modeli
`auth_source`	dize	---	Kimlik doğrulama kaynağı, örneğin `ecs_ram_role`
`access_key_id`	dize	---	Alibaba Cloud Access Key ID
`access_key_secret`	dize	---	Alibaba Cloud Access Key Secret
`security_token`	dize	---	Alibaba Cloud Security Token
`explicit_cache`	boolean	false	Açık önbellekleme etkinleştirilsin mi

agent --- Agent davranış ayarları

Yapılandırma öğesi	Tür	Varsayılan değer	Açıklama
`approval_mode`	dize	"recommend"	Çekirdek onay modu: `recommend`, `auto`, `trust`
`max_turns`	sayı	50	Tek bir Agent isteği için maksimum tur sayısı
`max_tool_calls_per_turn`	sayı	10	Tur başına maksimum araç çağrısı sayısı
`session_token_limit`	sayı	128000	Oturum belirteç sınırlaması
`allowed_tools`	dizi	[]	Onaydan muaf araçların listesi

session --- Oturum yönetimi

Yapılandırma öğesi	Tür	Varsayılan değer	Açıklama
`auto_persist`	boolean	true	Oturumlar otomatik olarak kalıcı hale getirilsin mi
`persist_dir`	dize	"~/.copilot-shell/cosh-core/sessions"	Oturum kalıcılık dizini

session.compaction --- Oturum sıkıştırma

Yapılandırma öğesi	Tür	Varsayılan değer	Açıklama
`enabled`	boolean	true	Sıkıştırmayı etkinleştir
`auto`	boolean	true	Otomatik sıkıştırma
`trigger_ratio`	sayı	0.70	Normal sıkıştırmayı tetikleyen bağlam oranı
`emergency_ratio`	sayı	0.90	Acil durumu korumayı tetikleyen bağlam oranı
`target_ratio`	sayı	0.30	Sıkıştırma hedef bağlam oranı
`preserve_recent_runs`	sayı	2	Korunan son tam Agent çalıştırma sayısı
`auto_compact_token_limit`	sayı	---	İsteğe bağlı mutlak tetikleme belirteç sınırı
`model_context_window`	sayı	---	Model bağlam penceresi geçersiz kılma değeri
`model_max_output_tokens`	sayı	---	Model maksimum çıktı belirteç kapsama değeri

target_ratio <= trigger_ratio <= emergency_ratio eşitsizliği korunmalıdır.

shell --- Shell etkileşim ayarları

Yapılandırma öğesi	Tür	Varsayılan değer	Açıklama
`default`	dize	"auto"	Varsayılan shell
`adapter_default`	dize	"cosh-core"	Varsayılan adaptör
`analysis_mode`	dize	"smart"	Analiz modu: `smart`, `auto`, `manual`
`approval_mode`	dize	"auto"	Shell onay modu: `recommend`, `auto`, `trust`
`integration`	dize	"enhanced"	Shell entegrasyon modu: `enhanced` (varsayılan; işaretleyici kanca hook'larını AI yönlendirme ve komut olayları için etkinleştirir ve Asiste edilmiş ile Yalnızca Shell modları arasında geçiş yapmak için `Shift+Tab` tuşlarına basmanıza olanak tanır) veya `native` (kanca yok; shell tüm girişi işler).
`input_wait_timeout_secs`	sayı	120	Giriş bekleme zaman aşımı saniyesi, `0` devre dışı bırakıldığını gösterir
`trusted_commands`	dizi	[]	Güvenilen komut listesi
`trusted_project_roots`	dizi	[]	Güvenilen proje kök dizinleri listesi

shell.recommendations --- Shell önerileri

Yapılandırma öğesi	Tür	Varsayılan değer	Açıklama
`enabled`	boolean	true	Shell önerileri etkinleştirilsin mi
`bash_history`	boolean	false	Öneri oluşturmak için Bash geçmişi kullanılsın mı

ui --- Arayüz ayarları

Yapılandırma öğesi	Tür	Varsayılan değer	Açıklama
`language`	dize	"auto"	UI dili
`startup_banner`	boolean	true	Başlangıç afişi
`startup_hooks`	boolean	false	Başlangıç kancası
`debug`	boolean	false	Hata ayıklama modu
`log_level`	dize	"warn"	UI günlük düzeyi

skills --- Beceri ayarları

Yapılandırma öğesi	Tür	Varsayılan değer	Açıklama
`enabled`	boolean	false	Özel beceriler etkinleştirilsin mi
`custom_paths`	dizi	[]	Özel beceri yolu listesi

logging --- Günlük ayarları

Yapılandırma öğesi	Tür	Varsayılan değer	Açıklama
`level`	dize	"warn"	Günlük düzeyi

mcp.servers. --- MCP sunucuları

MCP istemcisi yalnızca sistem veya kullanıcı yapılandırmasında tanımlanabilir. Her sunucu command (stdio) veya url (Streamable HTTP) seçeneklerinden birini kullanır; allowed_tools alanının atlanması tüm araçların maruz bırakılması anlamına gelir, [ ] ise aracın maruz bırakılmadığını gösterir.

Yapılandırma öğesi	Tür	Varsayılan değer	Açıklama
`command`	dize	---	stdio sunucusu yürütülebilir dosya yolu
`url`	dize	---	Streamable HTTP uç noktası
`args`	dizi	[]	Komut satırı parametreleri
`env`	tablo	{}	Ortam değişkenleri
`timeout_ms`	sayı	10000	Milisaniye cinsinden istek zaman aşımı
`startup_timeout_ms`	sayı	30000	Milisaniye cinsinden başlatma zaman aşımı
`allowed_tools`	dizi	---	Maruz bırakılmasına izin verilen araçların listesi

health --- Sağlık kontrolü

Yapılandırma öğesi	Tür	Varsayılan değer	Açıklama
`enabled`	boolean	true	Sağlık kontrolleri etkinleştirilsin mi
`role`	dize	---	Rol ID'si
`memory_sensitive`	boolean	false	Belleğe duyarlı mod
`critical_mounts`	dizi	["/"]	Ana bağlama noktalarının listesi
`verbose`	boolean	false	Ayrıntılı çıkış modu

health.services TOML dizi tablosu tanımı kullanılır:

[[health.services]]
name = "nginx"
expected = "active"

audit --- Denetim ayarları

Sistem dosyaları [audit] tablosunu içerir; sistem ayarları esas alınır, aksi takdirde kullanıcı ayarları kullanılır. Proje denetim tablaları yok sayılır.

Yapılandırma öğesi	Tür	Varsayılan değer	Açıklama
`mode`	dize	"best_effort"	Denetim modu: `best_effort` veya `required`
`retention_days`	sayı	30	Denetim verilerinin saklanacağı gün sayısı
`max_disk_bytes`	sayı	1073741824	Denetim verilerinin bayt cinsinden maksimum disk kullanımı