設定
設定はProfileに属します。各Profileに専用のモデル経路、チャンネル、ツール、予定、認証情報、Workspace、状態があります。
推奨する変更方法
| 変更 | 推奨する操作方法 |
|---|---|
| 初期設定 | anyy setup |
| モデルと認証情報 | Dashboard → Modelsかanyy setup model |
| チャンネル | Dashboard → Channelsかanyy setup channel |
| 画像、動画、音声経路 | Dashboard → Modelsか該当Toolsページ |
| Web検索 | Dashboard → Tools → Web Search |
| Role、Skill、MCP、cron | 各Dashboard項目 |
| 解決済み設定の確認 | anyy config |
anyy configは読み取り専用で、解決Profile、パス、モデル選択、認証参照の健全性を値なしで報告します。
Dashboardと設定コマンドは変更を検証し、認証情報を保護し、対応するライブランタイムを再読み込みします。直接YAML編集は高度な復旧に役立ちますが、案内付き検査を通りません。
Profileの構成
アクティブHomeに正式なユーザーデータがあります。主なパスは次です。
| パス | 用途 |
|---|---|
config.yaml | 設定と認証参照。MCP値フィールドは入力文字列を保持 |
secrets/ | 管理シークレット |
state.db | セッション、メッセージ、ジョブ、監査などの永続状態 |
memory/USER.md | 持続的なユーザー事実と好み |
memory/MEMORY.md | 永続アシスタントメモリ |
objects/ | 正規状態が参照する内容アドレス方式の永続ペイロード |
workspace/ | コンテキストと作業ファイル |
skills/ | Profile内導入Skill |
roles/ | Profile内Role定義 |
workspace/はセキュリティ境界ではありません。ツールはOS権限と実行制限に従います。
アクティブProfileの確認
anyy status
anyy config
別の名前付きProfileは次です。
anyy --profile work config
--home PATH対応コマンドではディレクトリを明示できます。パス解決の診断を意図しない限り、--profile、--profile-root、その場の--homeを混ぜないでください。
Thinking設定と移行
全体のthinking好みはmain_model.inference、任意の完全一致対象上書きはルートのmodel_thinking_levelsマップにあります。
main_model:
provider_id: your-provider
model: your-model
inference:
enabled: true
# Leave level omitted to keep the global level unset.
model_thinking_levels:
"your-provider/your-model": high
設定済みプロバイダー/モデルIDを使います。キーは最初の/で分け、両側を空でないものにします。検証はキーを正規化せず、検索は完全一致です。未登録モデルのキーも将来用に保存できます。値はPiの名前付きレベルoff、minimal、low、medium、high、xhigh、maxで、ランタイムスナップショットは値の前後空白を除きます。空のマップ値は不正です。
全体のenabledは既定trueです。trueまたは省略でlevel省略なら未設定、enabled: falseはlevelなしでもoffを明示します。名前offも有効です。モデルが要求を範囲内へ収めます。inference.effective_levelは読み取り専用でYAML設定ではありません。優先順を参照してください。
旧設定からv0.1.107へ更新する場合:
- 廃止した
prompt_program.inference_levelは空でも削除します。nullなど他型も拒否します。全体の好みはmain_model.inference、個別はmodel_thinking_levelsへ移します。 prompt_program.render_profileはnull/空でも存在すれば削除します。代替セレクターやhigh必須条件はありません。- 製品の
provider_defaultは名前付きPiレベルへ置換します。全体はlevel削除で未設定、マップは名前付き値を選ぶか項目を削除します。
JSON/YAMLと製品モデルAPIは廃止入力を明示拒否し、別名やmediumへの暗黙変換はありません。自動書き換えをしないため明示移行します。公開prompt_programにはresource_classだけが残ります。低レベルのネイティブ推論省略は有効です。
再試行とモデルインターフェース
Session再試行、SDK再試行、フォールバック、仮想モデルコールバックには別設定があります。retry.enabledはすべての再試行のスイッチではありません。型付きproviders[].models[]、サンプリング、正確なretry/httpIdleTimeoutMsはプロバイダープロトコルとモデルインターフェースを参照してください。
MCP設定
Profile全体の定義はmcp.client.serversとしてconfig.yamlに置きます。正規Workspaceに.anyy/mcp.json(現在<ProfileHome>/workspace/.anyy/mcp.json)も置けます。完全定義は同名Profile定義を置換し、部分項目は有効状態、公開方式、順序付き公開規則全体だけを上書きします。形式と値の式はProfileとプロジェクトの設定を参照してください。
有効/公開設定は選択定義か既存プロジェクト上書きへ保存し、そのサーバーだけに作用します。Profileコマンドの説明、ツール上書き、トランスポート、認証編集は生Profile編集です。CLI設定とProfileオプションは別々に送信します。enable/disable --projectは上書きのないProfileサーバーに有効状態だけの上書きを作ります。add/remove --localはネイティブプロジェクト定義だけを変え、Profile定義と独立認証を保ち、次回起動/待機Session再読み込みで反映します。
anyy mcp reloadは読み込み済み値で再接続し、ファイルを読み直しません。起動と既存の待機session.reload RPCが再読します。式、公開規則、OAuthはMCPガイドを参照してください。
認証情報
管理認証は設定内に値ではなく参照を使います。Dashboardとsetupの明示対応操作が、制限権限でProfileのsecrets/へ書きます。通常MCP値は入力文字列と式を保ち、管理シークレットを自動作成しません。MCP値を参照してください。
作成元の同じ機能画面で置換、消去、接続、切断します。プロンプト、スクリーンショット、履歴、サポート資料に貼らないでください。
変更を適用する
多くの操作は成功後に対象ランタイムを再読み込みします。Channelは明示的にも適用できます。
anyy channel reload
保存しても動作が変わらなければ次を確認します。
anyy status
anyy doctor
anyy gateway status
対処で求めるかライブ再読み込みが完了できない場合だけGatewayを再起動します。
v0.1.107は次の旧MCP設定を拒否します。手動管理設定では削除/移行します。
mcp.client.enabled:サーバー別enabledを使用。mcp.client.session_idle_ttl_ms:廃止。通知と明示操作で更新。- サーバーの
connect_timeout_ms:初期化、検出、ツール要求別の既存call_timeout_msを使用。 tools.include、tools.exclude、tools.trusted:exposureとtoolExposureを使用。tools.resourcesとtools.promptsも廃止。
新しいrequest_timeout_msキーはありません。全形式と移行はMCPサーバーを参照してください。
手動編集前にバックアップする
anyy backup create
既定は管理secrets/と対応mcp/oauth/を除外し、--include-secretsで追加します。設定とWorkspaceは保持内容で収録するため、直接認証情報は既定アーカイブにも入り得ます。完全な秘匿は保証しません。全アーカイブを非公開として保護し、管理ストアを含めるなら認証情報ストア同様に守ります。バックアップと復元を参照してください。
トラブルシューティング
| 症状 | 確認する項目 |
|---|---|
| 設定が変わらない | アクティブProfileとanyy config |
| Gatewayが古い値を使う | 対応reload後anyy status |
| 検証失敗 | Dashboard/ウィザードで不正フィールドを確認 |
| 設定済みだが認証未解決 | 所有するModels、Tools、Channelsから置換 |
| 手動YAMLで起動不能 | 最後の正常ファイルか、新Profileへの復元 |