> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cowagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# v2.2.1
> CowAgent 2.2.1：成果物センターとカスタムメニューの追加、Agent チャット API の公開、モデルキャッシュとコンテキストコストの最適化、ツール・チャネル・セキュリティの改善
🌐 [English](https://docs.cowagent.ai/releases/v2.2.1) | [中文](https://docs.cowagent.ai/zh/releases/v2.2.1)
## 📁 成果物センター
会話の中で作成されたファイルをまとめて管理できる「成果物」ページを追加しました。Web コンソールとデスクトップクライアントの両方に対応しています：
* **自動収録**：Agent が作成したドキュメント、Web ページ、画像、動画は自動で成果物センターに表示され、複数の Agent の成果物がタイムラインに並びます。
* **プレビューと遡及**：種類や Agent での絞り込みと検索に対応し、その場でプレビューできるほか、ファイルを作成した会話へ戻れます（Thanks @rudycelekli #3732）。
* **ピン留めと管理**：ピン留め、名前の変更、削除ができます。会話内のファイルカードから成果物センターの該当ファイルへ直接移動できます。成果物ページは初期状態では非表示で、メニューエディタから表示できます。
関連ドキュメント：[Web コンソール - 成果物](https://docs.cowagent.ai/ja/channels/web#成果物)
## 🧭 カスタムメニューとコンソールの改善
* **カスタムメニュー**：Web コンソールとデスクトップクライアントで、メニューのグループ、順序、名前、アイコン、表示状態をカスタマイズでき、設定は両方で共有されます。成果物ファイルや Web リンクもメニュー項目として追加できます。詳しくは [カスタムメニュー](https://docs.cowagent.ai/ja/extensions/custom-menu) を参照してください。
* **トークン使用量**：各返信に、そのターンで実際に消費したトークンとキャッシュヒットの状況を表示します。Thanks @Harbor404 (#3440)
* **Mermaid 図**：Mermaid コードブロックを図のプレビューに切り替えられ、拡大縮小と全画面表示に対応します。Thanks @akushonkamen (#3620)
* **長いセッションの読み込み高速化**：ツール呼び出しの多い長いセッションを開く速度を改善しました。
* **不具合修正**：新しいセッションのタイトルが失われる問題と、デフォルト Agent のセッション操作でエラーになる問題を修正しました（Thanks @6vision #3625, #3617）。まとめて保存した設定がすべて反映され、ワークスペースのファイルが所属する Agent の下に保存されるようになりました（Thanks @aniruddhaadak80 #3454, #3488）。
* **サイドバーの折りたたみ**：Web コンソールのサイドバーをアイコンバーに折りたためるようになりました。
## 🔌 Agent チャット API の公開
標準的なチャット API を公開しました。サードパーティのクライアントから接続したり、業務システムから Agent を直接呼び出したりできます：
* **スイッチとキー**：「設定」ページでワンクリックで有効にして API キーを生成でき、無効にしてもキーは保持されます。設定ファイルや環境変数で有効にすることもできます（Thanks @AaronZ345 #3068、@Bdysj #3342）。
* **Agent とモデルの指定**：`agent_id` で Agent を、`model` でモデルを指定します。モデルを指定しない場合は Agent のデフォルトモデルを使用します。
* **マルチターン会話**：デフォルトでは呼び出し側が完全なメッセージ履歴を送信します。`conversation_id` を渡すとサーバー側で履歴を保存し、最新のメッセージだけを送ればよくなります。
* **完全な出力**：ストリーミングと非ストリーミングの両方に対応し、思考内容、トークン使用量、ツール呼び出しの過程を返します（Thanks @AaronZ345 #3068、@c020627 #3545, #3588）。
関連ドキュメント：[チャット API](https://docs.cowagent.ai/ja/extensions/chat-api)
## 📐 モデルキャッシュとコンテキストコストの最適化
* **Claude プロンプトキャッシュ**：システムプロンプト、ツール定義、会話のプレフィックスをキャッシュし、キャッシュヒット率を大幅に高めてトークンコストと応答遅延を削減しました。キャッシュの保持時間は `claude_cache_ttl` で設定できます。
* **トリミング後の余白確保**：コンテキストのトリミング後に余白を確保し、その後の数ターンはプレフィックスを変更しないため、長いセッションでもキャッシュにヒットし続けます。
* **予算変更の即時反映**：コンテキスト予算と最大ステップ数の変更が実行中の Agent にすぐ反映され、セッションがクリアされなくなりました。
* **圧縮時にツール記録を保持**：圧縮された履歴ターンにツール呼び出しの要約を残し、モデルが実行結果を捏造するのを防ぎます（Thanks @tsumon #3634）。
* **不具合修正**：圧縮中に届いたメッセージが失われなくなり、孤立したツール結果のクリーンアップがより正確になりました（Thanks @c020627 #3518、@rudycelekli #3652, #3653）。
## 🤖 モデル機能
* **Claude の長時間思考**：長時間の思考中も接続を維持し、出力が停滞した場合は思考の強度を下げて自動で再試行します。
* **カスタムヘッダー**：カスタムモデルプロバイダーで `headers` を設定できるようになり、OpenCode Go にも対応しました。
* **モデルの自動検出**：モデル一覧の編集時に、プロバイダーで利用可能なモデルを自動で取得できます。Thanks @Harbor404 (#3441)
* **思考内容**：`reasoning` と `thinking` フィールドの両方に対応し、閉じられていない `` タグで返信が途切れなくなりました（Thanks @a1094174619 #3601、@fly0sheep-1734 #3538）。
* **フォールバックモデル**：フォールバックモデルは各ターンの開始時にリセットされ、使われ続けることがなくなりました。
* **OpenAI**：Responses API とストリーミング応答の処理を改善しました（Thanks @rudycelekli #3659, #3660, #3661, #3663、@aniruddhaadak80 #3486）。
* **モデル一覧**：同時編集による上書き、カスタムのメインモデルが反映されない問題、機能タグの照合を修正しました（Thanks @rudycelekli #3577, #3662, #3666、@aniruddhaadak80 #3501）。
* **その他のプロバイダー**：MiniMax、ModelScope、Baidu ERNIE、Azure DALL·E の互換性の問題を修正しました（Thanks @aniruddhaadak80 #3464, #3476, #3479, #3507, #3512、@rudycelekli #3678）。
* **エラー処理**：拒否されたリクエストが再送されなくなり、エラーの識別がより正確になり、コンテキスト使用量に実際のトークン数が表示されるようになりました（Thanks @c020627 #3442, #3443, #3445、@aniruddhaadak80 #3505、@6vision #3624）。
* **画像**：画像生成で元の形式と元のプロンプトを保持し、macOS での画像認識で画像を拡大しなくなりました（Thanks @aniruddhaadak80 #3503, #3504、@rudycelekli #3568）。
## 🧠 メモリとナレッジベース
* **ナレッジの編集とスキルの作成**：コンソールでナレッジベースのページを直接編集でき、インデックスは自動で更新されます。スキルをゼロから作成したり、スキルディレクトリ内のファイルを編集したりすることもできます。Thanks @zkjqd (#3377)
* **ヒットに基づくランキング**：オプションの `memory.hit_boost` を追加しました。よく検索されるメモリがわずかに上位に表示されます。デフォルトは無効です。Thanks @foreverjix (#3621)
* **時間減衰**：日次メモリファイルにのみ適用され、日付付きのナレッジベースページの順位が下がらなくなりました（Thanks @fly0sheep-1734 #3376）。
* **インデックス**：非常に長い行の内容が失われる問題、チャンクが予算を超える問題、ノートを空にした後にインデックスが残る問題を修正しました（Thanks @fly0sheep-1734 #3585、@rudycelekli #3426, #3578, #3616）。
* **検索**：全文検索のフォールバック、Unicode キーワード、パラメータとベクトルの異常処理を改善しました（Thanks @aniruddhaadak80 #3480, #3481, #3482, #3483、@rudycelekli #3559, #3656, #3658）。
* **メモリの書き込み**：書き込みに失敗した場合に再試行でき、旧バージョンのセッションデータをインポートできます（Thanks @aniruddhaadak80 #3406、@c020627 #3590、@rudycelekli #3387）。
* **ナレッジベース**：Windows でのグラフのパスや、拡張子が大文字のドキュメントが表示されない問題を修正し、インポートパスの検証を強化しました（Thanks @Lesereingrape #3332、@rudycelekli #3612, #3649, #3651）。
## 🤝 マルチ Agent 協調
* **権限と委任**：委任と引き継ぎで依頼元の権限モードを引き継ぎ、受け取る側の Agent が委任の許可リスト、深さ、待機時間を再検証します（Thanks @c020627 #3541, #3546, #3547, #3548, #3552）。
* **デフォルト Agent のエイリアス**：常にデフォルト Agent の実際の ID に解決されます（Thanks @c020627 #3553, #3554）。
* **チームセッション**：チームセッションを削除すると、すべての参加者の記録も削除されます。モデル設定の表示と追加メッセージの配信の問題を修正しました（Thanks @c020627 #3519, #3537, #3549, #3550, #3613）。
* **サブ Agent**：タスクを停止するとサブ Agent も停止します。プロンプトの解析の問題を修正しました（Thanks @rudycelekli #3637, #3638, #3639）。
* **セッションとプロジェクト**：セッション設定とプロジェクトパスの異常処理を修正しました（Thanks @c020627 #3551、@rudycelekli #3640, #3654）。
## 🧩 ツールとスキル
* **ファイルの読み書き**：書き込みに失敗した場合は元のファイルを保持します。改行コードの判定、同時編集による上書き、引数の解析の問題を修正しました（Thanks @aniruddhaadak80 #3365, #3404, #3413、@rudycelekli #3525, #3531, #3563, #3566, #3567, #3667）。
* **ドキュメントの解析**：Word の表、Excel の数式、PowerPoint の表を完全に保持します（Thanks @rudycelekli #3393, #3394, #3560, #3629, #3631）。
* **ファイル検索**：外部の検索コマンドが失敗した場合は自動でフォールバックします。フィルタールール、大文字小文字、特殊ファイルの処理を修正しました（Thanks @aniruddhaadak80 #3400、@rudycelekli #3391, #3533, #3534, #3558, #3570, #3571, #3630, #3675, #3679）。
* **Web 取得**：文字コードとドキュメントの種類を正しく判定し、転送時間とサイズを制限しました（Thanks @aniruddhaadak80 #3401, #3478、@rudycelekli #3392, #3569, #3574, #3632, #3669, #3670, #3671）。
* **ブラウザ**：ページがウィンドウサイズに合わせて表示されます（Thanks @zkjqd #3623）。Docker で同梱の Chromium を正しく認識し、インストールに `sudo` が不要になりました（Thanks @handoing #3743, #3744）。起動失敗時の後処理、スクロール、要素操作の問題を修正しました（Thanks @c020627 #3524、@aniruddhaadak80 #3490、@rudycelekli #3562, #3573）。
* **ターミナル**：マルチバイト文字の切り捨て、終了コードの誤報告、`.env` の解析の問題を修正しました（Thanks @rudycelekli #3530, #3564, #3668）。
* **MCP**：Windows で `npx`、`uvx` などのコマンドを正しく起動できます（Thanks @6vision #3408）。ツールのページング取得、構造化された結果とエラーの受け渡しに対応しました（Thanks @rudycelekli #3672, #3673, #3674、@aniruddhaadak80 #3425）。接続タイムアウトと設定の保存がより確実になりました（Thanks @aniruddhaadak80 #3414, #3452, #3466, #3469、@c020627 #3438, #3523, #3542, #3610, #3615）。
* **スキル**：より多くの GitHub ディレクトリ構成に対応し、インストールパス、ディレクトリのループ、YAML の解析の問題を修正しました（Thanks @aniruddhaadak80 #3379、@rudycelekli #3389, #3594, #3597, #3598、@c020627 #3516, #3682）。
* **スケジュールタスク**：期限切れの単発タスクの作成を拒否します。夏時間、タスク種別の検証、タスクファイルの復元、配信先の問題を修正し、Python 3.9 未満のバージョンにも対応しました（Thanks @aniruddhaadak80 #3359, #3374, #3375, #3429、@c020627 #3540, #3604, #3683、@rudycelekli #3390, #3526, #3532, #3575, #3576, #3593, #3636）。
## 📡 チャネル機能
* **WeChat**：ログイン状態がより安定し、インスタンス削除時に認証情報を削除します。同名の添付ファイルの上書きと一時ファイルの残留を修正しました（Thanks @c020627 #3277, #3544, #3581, #3589, #3622、@6vision #3609、@aniruddhaadak80 #3498、@rudycelekli #3635）。
* **WeCom**：トークンの更新に失敗した後も自動で復旧します。WeCom Bot の返信ストリーム、画像変換、重複コールバックの問題を修正し、一時ファイルを速やかに削除するようにしました（Thanks @c020627 #3345, #3435, #3529, #3611, #3614、@aniruddhaadak80 #3397, #3497、@rudycelekli #3645）。
* **WeChat カスタマーサービス**：メッセージカーソルの保存に失敗した場合に自動で再試行します（Thanks @rudycelekli #3677）。
* **WeChat 公式アカウント**：動画の返信が失われる問題と、受動返信後にユーザーへ応答しなくなる問題を修正しました（Thanks @aniruddhaadak80 #3360, #3411、@c020627 #3536, #3543, #3606）。
* **Feishu**：コード内の Markdown 画像構文をそのまま保持します（Thanks @huiq777 #3434）。トークン取得のタイムアウトとアプリの再登録の問題を修正しました（Thanks @aniruddhaadak80 #3358、@c020627 #3539）。
* **DingTalk**：カード返信内のコードブロックをそのまま保持します（Thanks @huiq777 #3420）。送信結果の判定と画像キャプションの二重送信を修正しました（Thanks @aniruddhaadak80 #3396, #3496、@c020627 #3432, #3517, #3586）。
* **QQ**：5MB を超えるファイルを送信できます（Thanks @HnBigVolibear #3647）。画像での返信に対応し、切断後の再接続の問題を修正しました（Thanks @c020627 #3341、@aniruddhaadak80 #3405）。
* **Telegram**：書式付きメッセージの処理が途中で止まる問題とリンクの表示を修正しました（Thanks @fly0sheep-1734 #3522、@rudycelekli #3665、@aniruddhaadak80 #3416）。
* **Slack / Discord**：送信に失敗した場合に自動で再試行します（Thanks @aniruddhaadak80 #3415）。
* **共通**：
* 期限切れの添付ファイルが次のメッセージと一緒に送信されなくなりました（Thanks @SEVEN-us #3407）。添付ファイルの並行処理、キャッシュのクリーンアップ、拡張子の問題を修正しました（Thanks @c020627 #3437、@rudycelekli #3561, #3644）。
* 重複排除キャッシュを定期的にクリーンアップし、長時間稼働してもメモリ使用量が増え続けなくなりました（Thanks @Bdysj #3340）。
* メッセージ処理の中断、キャンセル時のデッドロック、チャネルの停止、認証情報の上書きの問題を修正しました（Thanks @c020627 #3348, #3515、@aniruddhaadak80 #3373, #3395, #3410、@rudycelekli #3384, #3648, #3655）。
## 🛡 セキュリティ強化
* **権限制御**：読み取り専用モードで、見落としていた git の書き込み操作をブロックします（Thanks @aniruddhaadak80 #3352、@drakeo338 #3357）。コマンド置換、引数経由の書き込み、ルートディレクトリの削除などの危険な操作を検出します（Thanks @c020627 #3579, #3602、@aniruddhaadak80 #3506）。フルアクセス以外のモードでは MCP 設定とセッション権限を変更できません。
* **パスアクセス**：アップロード、静的リソース、スキルのアンインストール、バックアップの復元などでパスの検証を強化し、認証情報ファイルへのアクセスをブロックします（Thanks @aniruddhaadak80 #3409, #3460, #3461, #3463、@c020627 #3446、@rudycelekli #3527, #3528、@Harbor404 #3436）。
* **外部リソース**：ダウンロードサイズの上限を統一し、メディアのアドレスと証明書を検証します（Thanks @c020627 #3327, #3328, #3329, #3336, #3555, #3556, #3557、@rudycelekli #3428、@aniruddhaadak80 #3457, #3477）。
* **ログのマスキング**：アクセストークンとシークレットがログに平文で書き込まれなくなりました（Thanks @c020627 #3356, #3444、@aniruddhaadak80 #3369, #3399, #3511）。
* **設定の堅牢性**：`.env` で改行を含む値を拒否します（Thanks @Lesereingrape #3344）。BOM 付きの設定ファイルに対応し、設定の型チェックとアトミックな書き込みを強化しました（Thanks @c020627 #3412, #3433, #3447, #3448、@aniruddhaadak80 #3431, #3499、@rudycelekli #3641）。
## 🛠 その他の最適化と修正
* **成果物センター**：旧バージョンのデータベースのアップグレード、Windows のパス、過去のメッセージへの移動の問題を修正しました（Thanks @Lesereingrape #3450, #3514、@aniruddhaadak80 #3402）。
* **Agent の実行**：ツールの例外、ステップ上限による回答の上書き、キャンセルと並行処理の問題を修正しました（Thanks @aniruddhaadak80 #3383, #3403, #3424、@c020627 #3582, #3583, #3587、@rudycelekli #3388, #3643, #3650）。
* **音声**：音声合成に失敗してもテキストの返信は送信されます。複数の音声サービスのタイムアウトとエラー処理を修正しました（Thanks @c020627 #3684、@aniruddhaadak80 #3330, #3363, #3491）。
* **プラグイン**：プラグインの再読み込み、重複登録、空メッセージ、キーワードプラグインとロールプラグインの問題を修正しました（Thanks @aniruddhaadak80 #3367, #3398、@c020627 #3520, #3521, #3584、@rudycelekli #3664, #3728）。
* **自己進化**：スナップショットの復元とバックアップがより確実になりました（Thanks @rudycelekli #3385, #3657、@c020627 #3600）。
* **Agent 管理**：Agent を削除すると、アバターとセッションも削除されます（Thanks @c020627 #3580, #3603）。
* **CLI とバックアップ**：`/status` に読み込まれた MCP サーバーを表示します（Thanks @HnBigVolibear #3474）。バックアップ、設定の読み込み、ナレッジベースの一覧、Git worktree での更新の問題を修正しました（Thanks @rudycelekli #3592, #3595, #3596, #3599, #3607）。
* **ログ**：ログページの読み込みがより安定し、リアルタイムログで行が欠けなくなりました（Thanks @c020627 #3349、@rudycelekli #3642）。
* **簡体字・繁体字変換**：簡体字と繁体字の対応表を修正しました（Thanks @aniruddhaadak80 #3347）。
* **Docker**：Compose テンプレートで Web コンソールをデフォルトで有効にし、初回起動後にコンソールからモデルを設定できるようにしました。
* **デスクトップクライアント**：再インストール後にショートカットを復元し、カスタムの更新元を使う場合も更新チャネルを保持します。
* **ドキュメント**：
* Docker でアップグレードする際のデータディレクトリの説明を追加しました（Thanks @Frank-zhu2000 #3680）。
* 日本語のモデルページのリンクを修正しました（Thanks @pratikgx #3681）。
* MCP ドキュメントの用語をコンソールの表記に合わせました（Thanks @c020627 #3418）。
## 📦 アップグレード方法
* **ソースデプロイ**：`cow update` でワンクリック更新するか、Web コンソールのサイドバーのバージョンメニューから更新するか、最新コードを取得して再起動します。詳しくは[アップグレードガイド](https://docs.cowagent.ai/ja/guide/upgrade)を参照してください。
* **デスクトップクライアント**：クライアント内で更新を確認してワンクリックで更新するか、[ダウンロードページ](https://cowagent.ai/download/)から最新版を入手できます。
**リリース日**：2026.10.14 | [Full Changelog](https://github.com/zhayujie/CowAgent/compare/2.2.0...2.2.1)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.