Alibaba Cloud Linux 4 Agentic Edition (Agentic OS) は、複数の認証方式、モデルの切り替え、階層的な構成管理を提供し、柔軟な構成管理方法をサポートします。 - Alibaba Cloud Linux

Alibaba Cloud Linux 4 Agentic エディション (Agentic OS) は、階層的な設定システムを通じて証明書、モデル、ツール、その他の設定を管理し、プロジェクトレベルとユーザーレベルの設定ファイルによる複数階層での上書きをサポートします。本記事では、複数の認証方式によるアクセス方法、モデルの切り替え操作、および設定ファイルの階層的な優先度とコア設定項目について説明します。

1 認証方法

Agentic OS の初回起動では、大規模言語モデルサービスに接続するために認証が必要です。以降は /auth コマンドで認証モードを切り替えることができます。

現在、次の認証方法をサポートしています。

Alibaba Cloud 認証

インタラクティブインターフェイスで [Aliyun Authentication] を選択すると、一定量の無料クレジットを取得できます。

Elastic Compute Service (ECS) 環境では、ターミナルに権限付与 URL と QR コードが表示されます。ブラウザで URL を開くか、携帯電話で QR コードをスキャンして、Alibaba Cloud アカウントのログインと権限付与を完了します。
ECS 以外の環境では、Alibaba Cloud AK/SK 認証を使用します。
- AK/SK の取得：
  1. Alibaba Cloud コンソールにログインします。
  2. [AccessKey] の管理ページでキーを作成します。

Alibaba Cloud で認証したユーザーは、無料の API 呼び出しクォータを利用できます。個人での開発およびテストに適しています。

注：Alibaba Cloud 認証方法では Qianwen シリーズのテキストモデルのみ使用でき、マルチモーダルモデルはサポートしていません。

Bailian 認証

Bailian 認証には事前作成済みのベース URL が用意されています。Coding Plan、Token Plan、カスタムモデルの認証方法を選択でき、認証には API キーを使用します。

OpenAI 互換エンドポイント API キー認証

インタラクティブインターフェイスで [OpenAI Compatible] を選択し、API キーを準備してください。サポートされている OpenAI 互換エンドポイントは次のとおりです：

カスタムのベース URL：ローカルにデプロイされたモデル (vLLM、Ollama など)、サードパーティ API プロキシサービスなど。

認証管理

操作	コマンド
現在の認証ステータスの確認	`/auth`
認証方法の切り替え	`/auth` (インタラクティブメニューで選択)

よくある質問：認証に失敗する場合は、API キーが正しいか (前後のスペースにご注意ください)、またネットワークから該当する API エンドポイントにアクセスできるかを確認してください。Agentic OS は複数の認証を同時に設定できます。認証方法は優先度に基づいて選択されます。また、/auth による手動切り替えも可能です。

2 モデルの設定

モデルの切り替え

/auth コマンドを使用して、現在のセッションで使用されるモデルを切り替え、設定済みの認証設定を選択し、次に「アクティブなプロバイダーとして設定」を選択します。

3 つの設定ファイル

設定レベルと優先度

Agentic OS のシステムシェルエントランス cosh は、JSON フォーマットの設定ファイルを使用して設定を管理します。優先度は高いものから順に次のとおりです。

コマンドラインパラメータ > 環境変数 > プロジェクト設定 > ユーザー設定 > デフォルト値

設定ファイルの場所

タイプ	パス	説明
システム設定	`/etc/copilot-shell/config.toml`	管理者のデフォルト
ユーザー設定	`~/.copilot-shell/config.toml`	個人用グローバル設定
プロジェクト設定	`.copilot-shell/config.toml` (プロジェクトのルートディレクトリ)	プロジェクトレベルの設定 (チームで共有可能)

設定ファイルの場所

タイプ	パス	説明
システム設定	`/etc/copilot-shell/config.toml`	管理者のデフォルト
ユーザー設定	`~/.copilot-shell/config.toml`	個人用のグローバル設定
プロジェクト設定	`.copilot-shell/config.toml` (プロジェクトのルートディレクトリ)	プロジェクトレベルの設定はチームで共有できます。

cosh-core は、システム → ユーザー → プロジェクトの順で設定をマージします。プロジェクト設定では、エージェント、フック、スキル、セッション、active_model、および回答の言語設定を設定できますが、active_provider、プロバイダー定義、MCP サーバー、およびプロジェクト監査設定は無視されます。cosh-shell は、システムファイルやプロジェクトファイルではなく、ユーザーファイルのみを読み取ります。

コア設定項目

ai --- AI とモデルの設定

設定項目	タイプ	デフォルト値	説明
`active_provider`	文字列	---	現在アクティブなプロバイダー
`active_model`	文字列	---	現在使用中のモデル名
`output_language`	文字列	---	回答の言語設定
`thinking`	文字列	---	思考モードの設定

ai.providers. --- プロバイダー定義

設定項目	タイプ	デフォルト値	説明
`type`	文字列	---	プロバイダーのタイプ。例： `dashscope`、`openai_compat`、`aliyun`
`base_url`	文字列	---	API のベース URL
`api_key`	文字列	---	API キー。`${VAR_NAME}` による環境変数展開を推奨します。
`model`	文字列	---	プロバイダーのデフォルトモデル
`auth_source`	文字列	---	`ecs_ram_role` などの認証ソース
`access_key_id`	文字列	---	Alibaba Cloud アクセスキー ID
`access_key_secret`	文字列	---	Alibaba Cloud シークレットアクセスキー
`security_token`	文字列	---	Alibaba Cloud セキュリティトークン
`explicit_cache`	ブール値	false	明示的なキャッシュを有効にするかどうか

agent --- エージェントの動作設定

設定項目	タイプ	デフォルト値	説明
`approval_mode`	文字列	"recommend"	コア承認モード：`recommend`、`auto`、`trust`
`max_turns`	数値	50	単一のエージェントリクエストの最大ラウンド数
`max_tool_calls_per_turn`	数値	10	1 ラウンドあたりのツール呼び出し回数の上限
`session_token_limit`	数値	128000	セッショントークンの制限
`allowed_tools`	配列	[]	承認を不要とするツールのリスト

session --- セッション管理

設定項目	タイプ	デフォルト値	説明
`auto_persist`	ブール値	true	セッションを自動的に永続化するかどうか
`persist_dir`	文字列	"~/.copilot-shell/cosh-core/sessions"	セッションの永続化ディレクトリ

session.compaction --- セッション圧縮

設定項目	タイプ	デフォルト値	説明
`enabled`	ブール値	true	圧縮を有効にするかどうか
`auto`	ブール値	true	自動圧縮
`trigger_ratio`	数値	0.70	通常の圧縮をトリガーするコンテキスト比率
`emergency_ratio`	数値	0.90	緊急保護をトリガーするコンテキスト比率
`target_ratio`	数値	0.30	圧縮後のターゲットコンテキスト比率
`preserve_recent_runs`	数値	2	保持する直近の完全なエージェント実行数
`auto_compact_token_limit`	数値	---	省略可能な絶対トリガートークン制限
`model_context_window`	数値	---	モデルのコンテキストウィンドウの設定値
`model_max_output_tokens`	数値	---	モデルの最大出力トークンの設定値

target_ratio <= trigger_ratio <= emergency_ratio を維持する必要があります。

shell --- シェルのインタラクティブ設定

設定項目	タイプ	デフォルト値	説明
`default`	文字列	"auto"	デフォルトシェル
`adapter_default`	文字列	"cosh-core"	デフォルトアダプター
`analysis_mode`	文字列	"smart"	解析モード：`smart`、`auto`、`manual`
`approval_mode`	文字列	"auto"	シェル承認モード：`recommend`、`auto`、`trust`
`integration`	文字列	"enhanced"	シェルの統合モード：`enhanced` (デフォルト。AI ルーティングとコマンドイベントのためのマーカーフックを有効化し、`Shift+Tab` を押して Assisted モードと Shell-only モードを切り替えることができます) または `native` (フックなし。シェルがすべての入力を処理します)。
`input_wait_timeout_secs`	数値	120	待機タイムアウト (秒) を入力します。 `0` は無効を意味します。
`trusted_commands`	配列	[]	信頼済みコマンドのリスト
`trusted_project_roots`	配列	[]	信頼済みプロジェクトルートのリスト

shell.recommendations --- シェルのサジェスト設定

設定項目	タイプ	デフォルト値	説明
`enabled`	ブール値	true	シェルのサジェストを有効にするかどうか
`bash_history`	ブール値	false	Bash の履歴を使用してサジェストを生成するかどうか

ui --- インターフェイス設定

設定項目	タイプ	デフォルト値	説明
`language`	文字列	"auto"	UI の言語
`startup_banner`	ブール値	true	起動バナー
`startup_hooks`	ブール値	false	起動フック
`debug`	ブール値	false	デバッグモード
`log_level`	文字列	"warn"	UI のログレベル

skills --- スキル設定

設定項目	タイプ	デフォルト値	説明
`enabled`	ブール値	false	カスタムスキルを有効にするかどうか
`custom_paths`	配列	[]	カスタムスキルパスのリスト

logging --- ログ設定

設定項目	タイプ	デフォルト値	説明
`level`	文字列	"warn"	ログレベル

mcp.servers. --- MCP サーバー

MCP クライアントは、システム設定またはユーザー設定でのみ定義できます。各サーバーは、command (stdio) または url (Streamable HTTP) のいずれかを使用します。allowed_tools を省略した場合はすべてのツールを公開し、[ ] はツールを公開しないことを示します。

設定項目	タイプ	デフォルト値	説明
`command`	文字列	---	stdio サーバーの実行ファイルパス
`url`	文字列	---	Streamable HTTP エンドポイント
`args`	配列	[]	コマンドラインパラメータ
`env`	テーブル	{}	環境変数
`timeout_ms`	数値	10000	リクエストのタイムアウト (ミリ秒)
`startup_timeout_ms`	数値	30000	起動のタイムアウト (ミリ秒)
`allowed_tools`	配列	---	公開を許可するツールのリスト

health --- ヘルスチェック

設定項目	タイプ	デフォルト値	説明
`enabled`	ブール値	true	ヘルスチェックを有効にするかどうか
`role`	文字列	---	ロール ID
`memory_sensitive`	ブール値	false	メモリセンシティブモード
`critical_mounts`	配列	["/"]	重要なマウントポイントのリスト
`verbose`	ブール値	false	詳細出力モード

health.services は TOML の配列テーブル定義を使用します：

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

audit --- 監査設定

システムファイルに [audit] テーブルが含まれる場合はシステム設定が優先されます。それ以外の場合は、ユーザー設定が使用されます。プロジェクトの監査テーブルは無視されます。

設定項目	タイプ	デフォルト値	説明
`mode`	文字列	"best_effort"	監査モード：`best_effort` または `required`
`retention_days`	数値	30	監査データの保持日数
`max_disk_bytes`	数値	1073741824	監査データの最大ディスク使用量 (バイト)