---
title: Cursor
description: GitHubリポジトリで作業するためのCursorクラウドエージェントを起動および管理する
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="cursor"
  color="#1E1E1E"
/>

{/* MANUAL-CONTENT-START:intro */}
[Cursor](https://www.cursor.so/)は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駆動の開発をスケールすることが可能になります。
{/* MANUAL-CONTENT-END */}

## 使用方法

Cursor Cloud Agents APIを使用して、GitHubリポジトリで作業できるAIエージェントを起動します。エージェントの起動、フォローアップ指示の追加、ステータスの確認、会話の表示、およびエージェントのライフサイクル管理をサポートしています。

## ツール

### `cursor_list_agents`

認証されたユーザーのすべてのクラウドエージェントをオプションのページネーションで一覧表示します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Cursor APIキー |
| `limit` | number | いいえ | 返すエージェントの数（デフォルト：20、最大：100） |
| `cursor` | string | いいえ | 前の応答からのページネーションカーソル |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 人間が読めるエージェントのリスト |
| `metadata` | object | エージェントリストのメタデータ |

### `cursor_get_agent`

クラウドエージェントの現在のステータスと結果を取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Cursor APIキー |
| `agentId` | string | はい | クラウドエージェントの一意の識別子（例：bc_abc123） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 人間が読めるエージェントの詳細 |
| `metadata` | object | エージェントのメタデータ |

### `cursor_get_conversation`

クラウドエージェントの会話履歴（すべてのユーザープロンプトとアシスタントの応答を含む）を取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Cursor APIキー |
| `agentId` | string | はい | クラウドエージェントの一意の識別子（例：bc_abc123） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 人間が読める会話履歴 |
| `metadata` | object | 会話のメタデータ |

### `cursor_launch_agent`

指定された指示で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 | 起動結果のメタデータ |

### `cursor_add_followup`

既存のクラウドエージェントにフォローアップ指示を追加します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Cursor APIキー |
| `agentId` | string | はい | クラウドエージェントの一意の識別子（例：bc_abc123） |
| `followupPromptText` | string | はい | エージェントへのフォローアップ指示テキスト |
| `promptImages` | string | いいえ | base64データと寸法を持つ画像オブジェクトのJSON配列（最大5つ） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 成功メッセージ |
| `metadata` | object | 結果メタデータ |

### `cursor_stop_agent`

実行中のクラウドエージェントを停止します。これはエージェントを削除せずに一時停止します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Cursor APIキー |
| `agentId` | string | はい | クラウドエージェントの一意の識別子（例：bc_abc123） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 成功メッセージ |
| `metadata` | object | 結果メタデータ |

### `cursor_delete_agent`

クラウドエージェントを完全に削除します。この操作は元に戻せません。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Cursor APIキー |
| `agentId` | string | はい | クラウドエージェントの一意の識別子（例：bc_abc123） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `content` | string | 成功メッセージ |
| `metadata` | object | 結果メタデータ |

## 注意事項

- カテゴリー: `tools`
- タイプ: `cursor`
