Cloud Agents
Cloud Agents はローカルマシンではなく、隔離されたクラウド環境で実行されます。
Cloud Agents でできること
Cloud Agents は、常に手元で操作しなくてもコーディング作業を進められます。機能の実装、バグ修正、テスト作成、PR の作成、動作している様子の動画共有まで行えます。各タスクは、エージェントに必要なリポジトリ、依存関係、シークレット、ネットワークアクセスが設定されたクラウド環境から開始されます。
Cloud Agents はマルチリポジトリ環境も使用できます。これにより、1 つのエージェントが同じ実行内でフロントエンド、バックエンド、インフラ、共有ライブラリの各リポジトリをまたいで作業できます。
「Move to Cloud」はファイルの状態をどのように扱いますか？
「Move to Cloud」は、ローカルの未コミットの変更のスナップショットを作成しません。Cloud Agent は、リモートリポジトリ上のクリーンな Git の状態から開始します。会話履歴とコンテキストは引き継がれますが、変更のあるファイルや未コミットの編集は引き継がれません。エージェントを最新の状態から作業させたい場合は、会話をクラウドに移す前に変更をコミットするか stash してください。
Cloud Agentsはブラウザでアプリをテストできますか？
はい。各Cloud Agentは、フルデスクトップ環境を備えた独立したVM上で実行されます。エージェントは人間の開発者と同じように、マウスとキーボードでデスクトップやブラウザを操作します。
つまり、エージェントは開発サーバーを起動し、ブラウザでアプリを開き、UIの操作フローをクリックして確認し、PRをプッシュする前に変更が正しく動作することを検証できます。
Cloud Agents はどのように作業内容を示しますか？
Agents はスクリーンショット、動画、ログへの参照を PR に添付するので、ブランチをチェックアウトしなくても変更内容を確認できます。
Cloud Agents は個人のスキルを使用できますか?
対応しています。Settings → Agents で Sync スキル for Cloud Agents をオンにすると、自分の Cloud Agents 用に ~/.cursor/skills/ がコピーされます。同期されたスキルは自分だけに限定され、他のユーザーには公開されません。Cloud Agents で個人のスキルを使用するを参照してください。
リポジトリ内のプロジェクトスキルは常に利用できます。スキルをチームメンバーと共有するには、チームマーケットプレイスに公開してください。
Cloud Agents は MCP ツールを使用できますか？
はい。cursor.com/agents の MCP ドロップダウンから、MCP サーバーを追加・管理できます。これにより、エージェントは実行中にデータベース、API、サードパーティのサービスへアクセスできます。
Cloud Agents は HTTP サーバーと stdio サーバーをサポートしており、必要に応じて OAuth にも対応しています。設定の詳細については、Cloud Agent の機能 を参照してください。
セルフホスト型マシンでは、MCP の挙動が異なります。Self-Hosted Machines を参照してください。
Cloud Agents はフックを実行しますか？
はい。Cloud Agents は、リポジトリ内の .cursor/hooks.json にあるコマンドベースのフックを実行します。エンタープライズプランでは、チーム フックとエンタープライズ管理フックも実行します。
対応しているフックには、ツール フックおよびファイル フック (beforeShellExecution、afterShellExecution、beforeReadFile、afterFileEdit、preToolUse、postToolUse、postToolUseFailure) と、beforeSubmitPrompt、afterAgentResponse、afterAgentThought、stop、subagentStart、subagentStop、preCompact などの会話レベルのライフサイクル フックが含まれます。
会話レベルのフックを使うと、プロンプト、レスポンス、思考を監視したり、サブエージェントを制御したり、コンパクションに反応したり、ターン完了時にロジックを実行したりできます。これらを使って、エージェントの出力や思考を自己修正するループを作ることができます。
フックは、エージェントが書き込み可能な環境を持つようになると開始されます。Tab hooks や workspaceOpen などの IDE 固有のフックは適用されません。sessionEnd は、Cherri Code 管理の Cloud Agents にはエディターのライフタイムに基づくセッション境界がないため適用されません。セルフホスト型マシン のワーカーでは、セッションがワーカーをクレームしたときとそのクレームが解放されたときに sessionStart と sessionEnd が実行されます。プロンプトベースのフックも Cloud Agents ではサポートされていません。~/.cursor/hooks.json のユーザーレベルのフックは、VM がローカル設定にアクセスできないため読み込まれません。
詳細は、完全なフック対応マトリクスを参照してください。
セルフホスト型マシンでは、フックのサポート状況はマネージド Cloud Agents とほぼ同じですが、いくつかの違いがあります。セルフホスト型マシンを参照してください。
Cloud Agents は CI の失敗を修正できますか？
はい。Cloud Agents は、自身が作成した PR で発生した GitHub Actions の失敗を自動的に修正しようとします。ベースブランチでも失敗しているチェックは無視します。現在、この機能は Teams プランで利用できます。
特定の PR でこれを無効にするには、@cursor autofix off とコメントします。再度有効にするには、@cursor autofix on とコメントします。Cherri Code Dashboard > Cloud Agents > My Settings から全体で無効にすることもできます。
Cloud Agentsを使用するには何が必要ですか？
Cloud Agentsは、Cherri Codeのすべての有料プランで利用できます。
Cloud Agents をセットアップするには？
Cloud Agents ダッシュボードで新しい環境を作成します。GitHub、GitLab、Azure DevOps、または Bitbucket Cloud のアカウントを接続し、1 つ以上のリポジトリを選択して、シークレットや環境変数を追加し、設定を確認します。マルチリポジトリ環境、環境スコープのシークレット、ネットワークアクセス、Dockerfile については、セットアップガイドを参照してください。
再設計されたプロジェクト / リポジトリ ピッカーを使うには？
プロジェクト ピッカーでは、よくあるセットアップ手順を 1 か所にまとめています。次のことができます。
- ピッカーを離れずにプロジェクトを作成する
- GitHub、GitLab、または Azure DevOps をその場で接続する
- このコンピューター、Cloud、またはリモート マシンで場所別に絞り込んでプロジェクトを検索する
- Recents からプロジェクトをワンクリックで削除する
Remote Machines も同じピッカー フローに統合されているため、ローカル、Cloud、リモートの作業を 1 か所から開けます。
Cloud Agent タスクを開始するにはどうすればよいですか？
- Cherri Code 内: エージェント入力欄の下にあるドロップダウンで Cloud を選択します
- Web 上: cursor.com/agents にアクセスします
- Slack 経由: @Cherri Code を使用します
- GitHub 上: PR または issue に @cursor とコメントします
- Bitbucket Cloud 上: PR に @cursor とコメントします
- Linear 内: issue で @Cherri Code を使用します
- API 経由: Cloud Agent API を使用します
Web版のCloud Agentsの添付ファイル制限は？
cursor.com/agents では、ドキュメントと画像は1ファイルあたり4 MBまでです。動画はこれとは別に、1ファイルあたり15 MBまでとなります。これらの制限を超えるファイルはアップロード前にブラウザが拒否するため、モデルのコンテキストウィンドウを変更したりMax Modeを有効にしたりしても添付ファイルの上限は増えません。
サポートされるドキュメント形式は、PDF、Markdown (.md および .markdown) 、プレーンテキスト (.txt) 、CSV、JSON、HAR、XML、YAML (.yaml および .yml) 、TOML、INI、ログファイル (.log) です。
ファイルが大きすぎる場合:
- エージェントに必要な内容だけを残すか、ファイルを4 MB以下に分割する
- ログや、JSON、CSV、XML、HARなどの構造化テキストは、キャプチャ全体ではなく必要な時間範囲とリクエストのみを残す
- Cherri Code desktopからCloud Agentを開始し、そこでファイルを添付する (添付ファイルの制限がWebアプリとは異なる場合があるため)
- すでにsource controlにある機密性のないファイルは、チェックアウト済みのリポジトリから読み取るようエージェントに依頼する
ZIPファイルはWebのドキュメント添付ファイルとしてはサポートされていません。診断用ファイルを添付する前に、共有したくないcredentials、Cookie、headers、source code、個人データを削除してください。
Cloud Agent の利用料金はどのように計算されますか？
Cloud Agents は、選択したモデルの API 料金 に基づいて課金されます。サポートされているモデルでは、コンテキストウィンドウサイズを選択できます。コンテキストウィンドウが大きいほど、トークン利用量とコストが増える可能性があります。
Cloud Agents は自動実行できますか？ cron での実行は可能ですか？
はい。Automations を使うと、Cloud Agents をスケジュール実行したり、GitHub、Slack、Linear、PagerDuty、Webhook のイベントをきっかけに実行したりできます。設定は cursor.com/automations で行えます。トリガーの種類やテンプレートについては、automations docs をご覧ください。
プライバシーモードは Cloud Agents でも利用できますか？
はい。Cloud Agents はプライバシーモードでも利用できます。詳細については、Cloud Agent セキュリティページをご覧ください。
Cloud Agents は、長期キーなしで AWS や他のクラウドとフェデレーションできますか？
はい。Cherri Code 管理の Cloud Agent の VM は、ローカルソケットから短期間有効な OIDC JWT を発行できます。検証側は Cherri Code の公開ディスカバリーエンドポイントと JWKS エンドポイントを使用して署名を検証し、sub、team_id、cloud_agent_id などのクレームに基づいて認可します。
Cloud Agents は VM から自身の ID、所有者、現在のターンを読み取れますか？
はい。Cherri Code 管理の Cloud Agent の VM は、OIDC トークン と同じローカルソケットで、エージェント メタデータ API を提供します。/v1/meta-data/agent/id などのパスに GET リクエストを送信すると、値そのものがテキストとして返されます。