エージェント

エージェントにより、AI は会話だけでなく、さらに自律的にタスクを完了できる。

たとえ話：

• 通常の会話における AI は、 助言しかできない同僚に似ている —— 方法を尋ねると、手順を教えてくれる
• エージェントは 実行能力を備えた同僚に似ている —— 目標を与えると、自らファイルを読み、資料を調べ、ツールを呼び出し、段階的に完了する

適用シーンの例：

• "を ~/Downloads 内のすべての PDF を Excel の一覧に整理する"
• "今日の主要テックメディアのトップ記事を調べ、5つの要点からなるブリーフを作成する"
• "指定の Python ファイルをレビューし、改善提案を出してそのまま修正する"
• "毎日午前9時に上記タスクを自動実行"（と組み合わせて スケジュールタスク）

まずはこちらを読むことをおすすめします 概念入門 アシスタント / エージェント / スキル / MCP / チャンネルの関係を整理する。

始める前の2つの準備

1. Anthropic プロトコルに対応した Provider 1社

エージェントは「ツール呼び出し」形式の会話に依存しており、現時点で最も成熟した実装は Anthropic Claude 系列のモデルです。そのため、このプロトコルを提供するモデルサービスが必要です。おすすめの選択肢：

• CherryIN（最も手軽）：1つのアカウントで通常会話とエージェントの両方に対応
• Anthropic 公式：Claude アカウントをそのまま使用
• その他の主要 AI ゲートウェイ（例： OpenRouter）

2. API サーバーを有効化

Cherry Studio では、Agent を動かすためにローカルで内部サービスを実行する必要があります。操作は 設定 → API サーバー で起動ボタンをクリックするだけです。詳細は API サーバー。

トークン消費に関する注意：Agent モードは複数ターンの会話とツール呼び出しを伴うため、1回のタスクで消費するトークンは通常会話よりかなり多くなります。Provider 側の管理画面で月間上限を設定して、使い過ぎを防ぐことをおすすめします。

ステップ1：Anthropic タイプの Provider を設定する

開く 設定 → モデルサービスで、Anthropic エンドポイントに対応した Provider を見つける（または新規作成する）：

• 入力する API キー
• 確認 API アドレス が正しい Anthropic エンドポイントを指していること（CherryIN のデフォルトは https://open.cherryin.cc）
• クリック モデル一覧を取得で、少なくとも1つの会話モデルを追加する（例： claude-sonnet-4 / agent/deepseek-v4-pro など）

CherryIN の設定が完了し、agent モデルが追加されている

Claude Code を契約しているユーザーは、Anthropic key と endpoint を該当欄に直接入力してモデルを利用できます。

ステップ2：API サーバーを有効化する

開く 設定 → API サーバーで、ポートとキーを確認してから ▶ 起動をクリックします。詳細は API サーバー。

API サーバーが稼働してはじめて、Agent は動作できます

ステップ3：エージェントページに入る

上部の Tab でクリック エージェント。Cherry Studio にはデフォルトで Cherry Assistant と Cherry Claw という2つのエージェントが内蔵されており、そのまま使うことも、自分のニーズに合わせて新規作成することもできます。

エージェントページ：左側の一覧 + 右側の会話エリア

ステップ4：エージェントを新規作成する

左サイドバー上部の + エージェント ボタンをクリックすると、 Agent を追加 フォーム：

Agent 追加フォーム

各項目の説明：

項目	説明
名称	一覧での Agent の表示名
モデル	前の手順で Anthropic タイプの Provider に追加した会話モデルを選択
自律モード	独立したスイッチです。オンにするとワークスペースを有効化します soul.md 独自のアイデンティティを設定し、タスク管理ツールを自動挿入し、無人運用に向かない対話型ツールを無効化します。チャンネル と スケジュールタスク この項目を有効にし、権限モードを全自動モードに設定する必要があります
権限モード	Agent がツールを呼び出す際に人の承認が必要かどうかを制御します。詳細は下表をご覧ください。デフォルトは 通常モード
作業ディレクトリ	Agent が読み書きできるローカルディレクトリ。空欄にするとデフォルトディレクトリが自動作成されます

入力後、 追加 をクリックすると作成完了です。

ステップ5：エージェントのプロンプト、ツール、スキルを調整する

エージェントカード右側の ⋮ メニュー → をクリック 編集して、完全な編集パネルを開きます：

エージェント編集パネル（基本設定 Tab）

左側の Tab 分類は、それぞれ異なる設定に対応しています：

• 基本設定：アイコン、名称、モデル、作業ディレクトリ、自律モード、ハートビート有効化、ハートビート間隔、説明
• プロンプト設定：システムプロンプトを編集し、Agent の役割と会話スタイルを決めます
• 権限モード：4種類の権限ポリシーを切り替えます（下表参照）
• ツール：Agent が使用できる内蔵ツールを選択し、さらに MCP サーバー 由来の外部ツールをマウントします
• スキル：事前にインストールされた スキル
• 詳細設定：最大会話ターン数上限と環境変数の2つの設定

権限モードの4つの選択肢

モード	動作	適用シーン
通常モード（デフォルト）	ファイルを自由に読み取れます。ファイル編集やコマンド実行の前には人の承認を求めます	日常会話型 Agent
計画モード	ファイルの読み取りと計画作成のみ可能で、編集やコマンド実行はできません	Agent に「案を出させ」、実行はあなたが行う
自動編集モード	ファイルの読み書きは自由にできます。コマンド実行前には引き続き承認を求めます	Agent にコード / 文書編集を任せつつ、コマンドの制御は保持する
全自動モード	すべてのツールで人の承認は不要です	チャンネルと定時タスクではこのモードを使用し、同時に自律モードを有効にする必要があります；自律的に判断する全自動シーン

全自動モードAgent はファイル書き込み、コマンド実行、外部 API 呼び出しなど、すべての人による確認をスキップします。制御された環境でのみ有効にしてください、そして 作業ディレクトリ Agent に変更されてもよい範囲に限定してください。

自律モード vs 権限モードに由来する：

• 自律モード Agent が できるかどうか「無人運用・長時間タスク」形態に入れるか（soul.md を読み込み、タスク管理ツールを注入するか）
• 権限モード Agent が どのようにツール呼び出しの承認を処理するか

この2つは独立しています。Agent に定時タスクを自動実行させて飛書グループへ送信するには、次が必要です：自律モードを有効化 + 全自動モードを選択。

ステップ6：エージェントと対話する

エージェントページに戻り、エージェントカードをクリックして会話に入ります：

• 下部の入力欄にタスクを入力します。例：「 ~/Downloads/report.md を PPT のアウトラインに変換して」
• Agent はどのツールを呼び出すか、複数ターンの推論が必要かを自動判断します
• ツール呼び出しと判断プロセスは、折りたたみ可能なカード形式で段階的に表示されます

結果表示

エージェントがツールを呼び出して結果を返す例

よくある質問

エージェントページに「エージェント機能を使うには API サーバーを有効にしてください」と表示される

戻る 設定 → API サーバー、緑の ▶ 起動ボタンをクリックします。詳細は API サーバー。

Agent 作成時のプルダウンにモデルがない

• 選択した Provider に少なくとも1つの会話モデルが追加されていることを確認してください
• その Provider のタイプが Anthropic または CherryINであることを確認してください（OpenAI のみの Provider は Agent のモデル選択に表示されません）

Agent の出力が突然停止する

ツール呼び出し上限、または1回の会話長上限に達している可能性があります。Agent 設定の最大ターン数と1回あたりの出力トークン上限を上げてください。

次のステップ

• Agent を IM プラットフォーム（飛書 / Telegram / QQ / WeChat / Discord / Slack）に接続 → チャンネル
• Agent に定時でタスクを自動実行させる → スケジュールタスク
• ツール機能を拡張 → MCP の使い方チュートリアル

---

💡 ヘルプの取得とフィードバックの送信

設定や使用の過程で疑問、Bug、機能改善の提案がある場合は、 フィードバックと提案 に記載の公式チャネルをご参照ください。