Cursor
GitHubリポジトリで作業するためのCursorクラウドエージェントを起動および管理する
CursorはAI IDEおよびクラウドベースのプラットフォームで、GitHubリポジトリで直接作業できる強力なAIエージェントを起動・管理することができます。Cursorエージェントは開発タスクを自動化し、チームの生産性を向上させ、コード変更の実施、自然言語指示への応答、活動に関する会話履歴の維持によってあなたと協力します。
Cursorでは以下のことができます:
- コードベース用のクラウドエージェントを起動: クラウド上であなたのリポジトリで作業する新しいAIエージェントを即座に作成
- 自然言語を使用してコーディングタスクを委任: 書面による指示、修正、説明でエージェントを導く
- 進捗と出力を監視: エージェントのステータスを取得し、詳細な結果を表示し、現在または完了したタスクを検査
- 完全な会話履歴にアクセス: 透明性と監査可能性のためにすべてのプロンプトとAI応答をレビュー
- エージェントのライフサイクルを制御・管理: アクティブなエージェントをリスト表示し、エージェントを終了し、APIベースのエージェント起動とフォローアップを管理
Simでは、Cursor統合によりエージェントとワークフローがCursorクラウドエージェントとプログラム的に対話できるようになります。つまり、Simを使用して以下のことができます:
- すべてのクラウドエージェントをリスト表示し、現在の状態を閲覧 (
cursor_list_agents)
- 任意のエージェントの最新ステータスと出力を取得 (
cursor_get_agent)
- 任意のコーディングエージェントの完全な会話履歴を表示 (
cursor_get_conversation)
- 実行中のエージェントにフォローアップ指示や新しいプロンプトを追加
- 必要に応じてエージェントを管理・終了
この統合により、Simエージェントの柔軟なインテリジェンスとCursorの強力な開発自動化機能を組み合わせることができ、プロジェクト全体でAI駆動の開発をスケールすることが可能になります。
Cursor Cloud Agents APIを使用して、GitHubリポジトリで作業できるAIエージェントを起動します。エージェントの起動、フォローアップ指示の追加、ステータスの確認、会話の表示、およびエージェントのライフサイクル管理をサポートしています。
認証されたユーザーのすべてのクラウドエージェントをオプションのページネーションで一覧表示します。
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Cursor APIキー |
limit | number | いいえ | 返すエージェントの数(デフォルト:20、最大:100) |
cursor | string | いいえ | 前の応答からのページネーションカーソル |
| パラメータ | 型 | 説明 |
|---|
content | string | 人間が読めるエージェントのリスト |
metadata | object | エージェントリストのメタデータ |
クラウドエージェントの現在のステータスと結果を取得します。
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Cursor APIキー |
agentId | string | はい | クラウドエージェントの一意の識別子(例:bc_abc123) |
| パラメータ | 型 | 説明 |
|---|
content | string | 人間が読めるエージェントの詳細 |
metadata | object | エージェントのメタデータ |
クラウドエージェントの会話履歴(すべてのユーザープロンプトとアシスタントの応答を含む)を取得します。
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Cursor APIキー |
agentId | string | はい | クラウドエージェントの一意の識別子(例:bc_abc123) |
| パラメータ | 型 | 説明 |
|---|
content | string | 人間が読める会話履歴 |
metadata | object | 会話のメタデータ |
指定された指示でGitHubリポジトリに取り組む新しいクラウドエージェントを開始します。
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Cursor APIキー |
repository | string | はい | GitHubリポジトリURL(例:https://github.com/your-org/your-repo) |
ref | string | いいえ | 作業するブランチ、タグ、またはコミット(デフォルトはデフォルトブランチ) |
promptText | string | はい | エージェントへの指示テキスト |
promptImages | string | いいえ | base64データと寸法を持つ画像オブジェクトのJSON配列 |
model | string | いいえ | 使用するモデル(自動選択の場合は空のままにする) |
branchName | string | いいえ | エージェントが使用するカスタムブランチ名 |
autoCreatePr | boolean | いいえ | エージェントが終了したときに自動的にPRを作成する |
openAsCursorGithubApp | boolean | いいえ | Cursor GitHub AppとしてPRを開く |
skipReviewerRequest | boolean | いいえ | PRでのレビュアーのリクエストをスキップする |
| パラメータ | 型 | 説明 |
|---|
content | string | エージェントの詳細を含む成功メッセージ |
metadata | object | 起動結果のメタデータ |
既存のクラウドエージェントにフォローアップ指示を追加します。
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Cursor APIキー |
agentId | string | はい | クラウドエージェントの一意の識別子(例:bc_abc123) |
followupPromptText | string | はい | エージェントへのフォローアップ指示テキスト |
promptImages | string | いいえ | base64データと寸法を持つ画像オブジェクトのJSON配列(最大5つ) |
| パラメータ | 型 | 説明 |
|---|
content | string | 成功メッセージ |
metadata | object | 結果メタデータ |
実行中のクラウドエージェントを停止します。これはエージェントを削除せずに一時停止します。
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Cursor APIキー |
agentId | string | はい | クラウドエージェントの一意の識別子(例:bc_abc123) |
| パラメータ | 型 | 説明 |
|---|
content | string | 成功メッセージ |
metadata | object | 結果メタデータ |
クラウドエージェントを完全に削除します。この操作は元に戻せません。
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Cursor APIキー |
agentId | string | はい | クラウドエージェントの一意の識別子(例:bc_abc123) |
| パラメータ | 型 | 説明 |
|---|
content | string | 成功メッセージ |
metadata | object | 結果メタデータ |