Cursorの「Agent SDK」は、Cursorが発表したエージェント開発キットで、エージェントの指示・ツール・評価をMarkdownとTypeScriptのファイルとして定義し、テスト・評価・デプロイまでをコードと同じように扱えるようにするものです。
室谷代表取締役CursorがAgent SDKの提供を開始したんですよね。エージェントをコードとして定義して、プロンプトはMarkdown、ツールはTypeScript。
Cursorのホスト基盤でも自社インフラでも動かせる、と。これはエディタの話ではなくて、開発ワークフローの話になってきています。
Cursorのホスト基盤でも自社インフラでも動かせる、と。これはエディタの話ではなくて、開発ワークフローの話になってきています。
テキトー教師DotAI 認定講師そうなんですよ。単に「エージェントが作れるようになりました」という話じゃないんです。
指示もツールもevalもファイルとしてバージョン管理できる、というのが本質で。講座でも受講生さんに「プロンプトはGitで管理するもの」と伝えているんですが、その発想がそのまま製品になった形です。
指示もツールもevalもファイルとしてバージョン管理できる、というのが本質で。講座でも受講生さんに「プロンプトはGitで管理するもの」と伝えているんですが、その発想がそのまま製品になった形です。
Cursor Agent SDKとは？何が発表されたのか
Cursorのエージェント手段の使い分け
Automations
- ダッシュボードでプロンプト・モデル・トリガーを定義
- 業務の自動化はこれで足りる場面が多い
Grok Bot
- コードを書かずに設定・対話する
室谷代表取締役まず定義を整理すると、Agent SDKはCursorが提供を開始したSDKで、エージェントをコードとして定義・テスト・評価・デプロイできるものです。公式ドキュメントには、Bugbot、Security Review、Approval Bot、Rolloutsを動かしているCursorのSDKハーネスを使うと書かれています。
つまりCursorが自社プロダクトで回している基盤がそのまま外に出てきた、という理解でいいんですよね。
つまりCursorが自社プロダクトで回している基盤がそのまま外に出てきた、という理解でいいんですよね。
テキトー教師DotAI 認定講師そこが大きいですよね。エージェントの振る舞いは、MarkdownとTypeScriptを組み合わせたフォルダで定義されます。
決定的なコードとモデルの判断を組み合わせる、と。そしてSlack、プルリクエスト、Issueトラッカー、Cursorといった、実際に仕事が発生する場所で動くためのAPIが用意されている。
決定的なコードとモデルの判断を組み合わせる、と。そしてSlack、プルリクエスト、Issueトラッカー、Cursorといった、実際に仕事が発生する場所で動くためのAPIが用意されている。
室谷代表取締役デプロイした後は「Deployed Agents」で管理する、と。発表の中心はあくまでCursorですから、Xで投稿されたからXが発表した、という話ではないですからね。
テキトー教師DotAI 認定講師そこは正確に押さえたいところです。発表元はCursor。
で、何が新しいのかというと、指示・ツール・評価がレビューできてテストできてバージョン管理できるファイルになる、という点です。従来のAutomationsはダッシュボードでプロンプト・モデル・トリガーを定義する、Grok Botはコードを書かずに設定・対話する。
Agent SDKは「モデル判断の周りにコードを置いて、チームでバージョン管理・レビュー・テスト・改善したい」場合に選ぶもの、と公式が位置づけています。
で、何が新しいのかというと、指示・ツール・評価がレビューできてテストできてバージョン管理できるファイルになる、という点です。従来のAutomationsはダッシュボードでプロンプト・モデル・トリガーを定義する、Grok Botはコードを書かずに設定・対話する。
Agent SDKは「モデル判断の周りにコードを置いて、チームでバージョン管理・レビュー・テスト・改善したい」場合に選ぶもの、と公式が位置づけています。
室谷代表取締役きれいに役割が分かれているんですよね。MYUUUでも業務の自動化はAutomationsで足りる場面が多いんですが、ロジックを差し込みたくなった瞬間にコードで書きたい欲が出る。
そこにちょうど刺さる道具が出てきたなと。
そこにちょうど刺さる道具が出てきたなと。
Cursor Agent SDKでできること——プロンプトはMarkdown、ツールはTypeScript
Cursor Agent SDKの役割分担
持ち込むもの（ユーザー側）
- エージェント・アズ・コード
- プロンプトは.mdまたは.ts
- 決定的なコードフック
- Cursor管理またはセルフホスト
- ソース管理・Issueトラッカー・Slackのトリガー
Cursor側が提供するもの
- モデルルーティング
- eval
- MCP接続
- セッションとモデルループ
- サブエージェントとツール呼び出し
- シークレット管理
- サンドボックス
- デプロイ
- ストレージとアーティファクト
- プライバシー設定
テキトー教師DotAI 認定講師公式のアーキテクチャ図を見ると構造がよく分かります。こちらが「持ち込むもの」として、エージェント・アズ・コード、プロンプトは.mdまたは.ts、決定的なコードフック、Cursor管理またはセルフホスト、ソース管理・Issueトラッカー・Slackのトリガー。
室谷代表取締役で、Cursor側が提供するのがモデルルーティング、eval、MCP接続、セッションとモデルループ、サブエージェントとツール呼び出し、シークレット管理、サンドボックス、デプロイ、ストレージとアーティファクト、プライバシー設定、と。
テキトー教師DotAI 認定講師ここ、整理するとこうです。
- 指示（プロンプト）はMarkdownファイル、またはTypeScriptで書ける
- ツールはTypeScriptで定義し、決定的なコードとしてフックを差し込める
- 組み込みのevalで、変更のたびに性能を測定できる
- MCP接続、サブエージェント、ツール呼び出し、シークレット管理、サンドボックスはCursor側が担う
- 実行先はCursor管理のホスティングか、自社インフラかを選べる
室谷代表取締役「モデルの判断」と「決定的なコード」を混ぜられるのが実務的で。全部をモデルに任せると再現性が消えるし、全部コードにすると柔軟性が消える。
その中間をファイルとして表現できるわけです。
その中間をファイルとして表現できるわけです。
テキトー教師DotAI 認定講師しかもevalが組み込みなのが効きます。プロンプトを1行変えたときに、良くなったのか悪くなったのかを測れる。
これがないとチーム開発は怖くてできないですからね。
これがないとチーム開発は怖くてできないですからね。
室谷代表取締役エージェント開発って、やってみると「なんとなく良さそう」で進みがちなんですよ。それが変更ごとに測定できるなら、改善のループが回せる。
地味だけど一番効く部分だと思います。
地味だけど一番効く部分だと思います。
Cursor Agent SDKの使い方・始め方（インストールから実行まで）
Cursor Agent SDK 導入から実行までの流れ
- 01Node 22.13以上を確認前提バージョンをチェック
- 02npm install --global @grok/agent-sdk旧パッケージ名は @cursor/bdk
- 03同梱ドキュメントのインデックスを読む
- 04agent-sdk loginブラウザでサインイン
- 05agent-sdk init ./my-botプロジェクトを雛形から作成
- 06cd my-bot
- 07agent-sdk dev開発モードに入る
- 08agent-sdk validate --dir .動作確認
- 09agent-sdk run turn1ターン動かして返答を確認
テキトー教師DotAI 認定講師手順は公式ドキュメントにかなり具体的に書かれています。まずNodeが22.13以上であることを確認して、
パッケージ名は以前
npm install --global @grok/agent-sdkを実行します。パッケージ名は以前
@cursor/bdkだったものが@grok/agent-sdkになっています。室谷代表取締役その後、パッケージに同梱されているドキュメントのインデックスを読んで、
agent-sdk loginでブラウザサインイン。agent-sdk initでプロジェクトを雛形から作って、agent-sdk validate --dir .とagent-sdk run turnで動作確認、という流れなんですね。テキトー教師DotAI 認定講師最小構成で言うとこうです。
code
npm install --global @grok/agent-sdk
agent-sdk init ./my-bot
cd my-bot
agent-sdk devagent-sdk devで開発モードに入れる。公式ドキュメントには、コーディングエージェントに渡すためのプロンプトも用意されていて、CLIのインストールから雛形作成までをエージェントにやらせられるようになっています。ドキュメントの各ページがURLに
.mdを付けるとMarkdownで取得できるのも、エージェントに読ませる前提の設計を感じます。テキトー教師DotAI 認定講師そこはまさに「エージェントでエージェントを作る」という思想ですよね。公式にも「Build agents with agents using a coding agent」という導線が用意されています。
室谷代表取締役あと、既存のAutomationをAgent SDKプロジェクトに変換する導線も用意されているのが実務的で。ゼロから作り直さなくていい、と。
Cursor CLIについてはCursor CLIとは？インストール・使い方・料金・Claude Codeとの違いを完全解説【2026年最新】で詳しく解説しているので、あわせて読むと全体像がつかめます。
Cursor CLIについてはCursor CLIとは？インストール・使い方・料金・Claude Codeとの違いを完全解説【2026年最新】で詳しく解説しているので、あわせて読むと全体像がつかめます。
テキトー教師DotAI 認定講師テンプレートも用意されていて、PRレビュー用のエージェントをステップバイステップで作るガイドや、レビュー・トリアージのテンプレート、owners-policyの承認エージェントなどが案内されています。最初の1体を作るまでの距離が短いのは大事です。
室谷代表取締役とはいえ、いきなり本番に置くのではなく、まず1ターン動かして返答を確認するところから、という公式の順番は妥当ですよね。
Cursor Agent SDKの料金と実行環境——自社インフラでも動かせるのか
室谷代表取締役ここが一番気になる人が多いところだと思うんですが、料金は選択したモデルのAPIレートに従い、プランの週次プールから消費、超過分はオンデマンド、という説明です。Cloud AgentsにVMなどの別途課金はない、と。
テキトー教師DotAI 認定講師公式フォーラムでもCursorの担当者が「Cloud AgentsにVM・コンピュート・メモリの別途課金はない」と明言していて、選択したモデルのAPIレートで、まずプランに含まれる利用枠から、次にオンデマンドで、と説明しています。ビルドも追加費用なし。
コストに影響するのはモデルとコンテキストウィンドウの選択、そしてTeamsとEnterpriseではサードパーティモデルにCursor Token Rateがかかる、という整理です。
コストに影響するのはモデルとコンテキストウィンドウの選択、そしてTeamsとEnterpriseではサードパーティモデルにCursor Token Rateがかかる、という整理です。
室谷代表取締役セルフホストは「Self-Hosted Machines」で、ワーカーがファイル編集とターミナル実行を担当し、Cursorがエージェントループ・推論・計画を担当する。つまり頭脳はCursor側、手足は自社側という分担なんですね。
テキトー教師DotAI 認定講師公式ドキュメントによると、ワーカーはCursor CLIを入れて外向きHTTPS接続ができればよく、内向きのポートやパブリックIP、VPNトンネルは不要。接続はワーカーからCursorへの外向きのみで、Cursorが自社ネットワークに入ってくることはない、と説明されています。
室谷代表取締役これは大きいですよ。厳しいネットワーク要件があって外からコードに到達できない、GPUマシンやiOS開発用のMacが必要、カスタムイメージがある、といったケースで自社マシンを使える。
MYUUUでも顧客データを扱う案件だと実行場所は必ず論点になるので、ここが選べるのは現実的です。
MYUUUでも顧客データを扱う案件だと実行場所は必ず論点になるので、ここが選べるのは現実的です。
テキトー教師DotAI 認定講師ただし条件があります。Team Poolsでの利用にはEnterpriseプランとサービスアカウントAPIキーが必要で、個人のログインや他の種類のAPIキーではプールワーカーを起動できない、と明記されています。
あと、ワーカーはユーザーあたり200台、チームあたり1000台まで接続できる、という上限も書かれていますね。
あと、ワーカーはユーザーあたり200台、チームあたり1000台まで接続できる、という上限も書かれていますね。
室谷代表取締役料金体系そのものはCursorの料金を徹底解説！Pro/Pro+/Ultraの違いと選び方で整理しているので、プランの部分はそちらを見てもらうのが早いです。Agent SDK自体はモデルのAPIレートに乗る、という理解でいいんですよね。
テキトー教師DotAI 認定講師そこは誤解されやすいので、公式の表現どおり「選択したモデルのAPIレートに従う」と押さえておきましょう。現時点では、Agent SDK専用の別料金が設定されているという記述は公式資料にはありません。
従来のAutomations・Grok BotとAgent SDKはどう使い分けるか
テキトー教師DotAI 認定講師公式が比較表を出しているので、整理するとこうです。
| 観点 | Cursor Automations | Grok Bot | Agent SDK |
|---|---|---|---|
| 何を定義するか | ダッシュボードでプロンプト・モデル・トリガー | アプリ内で指示・スキル・接続ツール | バージョン管理されたMarkdownとTypeScriptのプロジェクト |
| 実行場所 | Cursor管理 | Cursor管理 | Cursor管理のホスティング、または自社インフラ |
| 選ぶ条件 | スケジュールやイベントトリガーに合う仕事 | コードを書かず設定と対話をしたい | モデル判断の周りにコードを置き、チームでバージョン管理・レビュー・テスト・改善したい |
室谷代表取締役すごく素直な分け方ですよね。定型的な定期実行ならAutomations、非エンジニアが対話で設定するならGrok Bot、ロジックとテストが要るならAgent SDK。
テキトー教師DotAI 認定講師講座でよく聞かれるのが「どれから始めればいいか」なんですが、答えは「やりたいことの複雑さ」ではなく「チームで管理したいかどうか」なんですよ。プロンプトの変更をレビューしたい、テストしたい、劣化を測りたい。
そう思った時点でAgent SDKの出番です。
そう思った時点でAgent SDKの出番です。
室谷代表取締役逆に、1人で毎朝のレポートを出したいだけならAutomationsで十分。道具を重くする必要はないですからね。
テキトー教師DotAI 認定講師あと、Agent SDKはCursorのSDKハーネスを使うので、BugbotやSecurity Review、Approval Bot、Rolloutsと同じ基盤に乗る。つまりCursor自身がプロダクトで使っている実績のある部分を土台にできる、という安心感があります。
Cursor Agent SDKで作れるエージェントのユースケース
室谷代表取締役公式が用意しているテンプレートから見えるユースケースが分かりやすいんですよね。まずPRレビュアー。
これはステップバイステップのガイドまで用意されています。
これはステップバイステップのガイドまで用意されています。
テキトー教師DotAI 認定講師レビューやトリアージのテンプレート、owners-policyの承認エージェントもあります。あとはSlack、プルリクエスト、Issueトラッカー、Cursorで動くAPIが前提なので、日常のワークフローに埋め込む形が想定されています。
室谷代表取締役実務だと、PRが上がったら規約に沿っているかを見る、Issueを分類して担当を振る、承認ルールに沿って判断する、あたりはすぐ形にできそうです。決定的なコードをフックとして差し込めるので、機械的に判定できる部分はコードに寄せられる。
テキトー教師DotAI 認定講師CI/CDに組み込む使い方も自然ですよね。公式ドキュメントにはCLIのHeadless / CIという項目もあり、パイプラインからエージェントを呼ぶ前提の作りになっています。
室谷代表取締役バックエンドに組み込むなら、Cursor APIの話も関わってきます。APIキーの扱いはCursor APIキーの完全ガイド【2026年最新】：BYOK設定方法・料金・対応プロバイダー・よくあるエラー対処まで徹底解説で整理しているので、認証周りはそちらが参考になります。
テキトー教師DotAI 認定講師ユースケースを考えるときのコツは、モデルに判断してほしい部分と、絶対にコードで決めたい部分を先に分けることです。Agent SDKはその分離をファイル構造として表現できるので、設計がそのまま成果物になります。
室谷代表取締役そこが「プロンプトを書く」との一番の違いですよね。指示を書くというより、エージェントの振る舞いを設計してリポジトリに置く、という感覚。
よくある質問
テキトー教師DotAI 認定講師ここまでの内容でよく聞かれそうな点を整理しておきます。
室谷代表取締役まず、Pythonには対応しているんですか、という質問。公式ドキュメントのSDKのメニューにはTypeScriptとPythonが並んでいますが、Agent SDKの発表で示されている定義は「プロンプトはMarkdown、ツールはTypeScript」です。
Agent SDKにおけるPythonでのツール定義については、現時点では明らかにされていません。
Agent SDKにおけるPythonでのツール定義については、現時点では明らかにされていません。
テキトー教師DotAI 認定講師パッケージ名と必要な環境は、
ここは正確に覚えておきたいですね。
@grok/agent-sdkで、Node 22.13以上。以前は@cursor/bdkでした。ここは正確に覚えておきたいですね。
室谷代表取締役無料で使えるのか、という点。Agent SDKは選択したモデルのAPIレートに従い、プランの週次プールから消費、超過はオンデマンドという説明です。
FreeプランでのAgent SDK利用可否については、現時点では明らかにされていません。
FreeプランでのAgent SDK利用可否については、現時点では明らかにされていません。
テキトー教師DotAI 認定講師セルフホストは誰でも使えるのか、という点は、Team Poolsでの利用にEnterpriseプランとサービスアカウントAPIキーが必要と明記されています。個人のMy Machinesは個人の資格情報で接続する形です。
室谷代表取締役サンドボックスやセキュリティはどうなっているのか。Cursor管理のCloud Agentsはエージェントごとに隔離されたVMをCursorが用意し、ネットワークの許可リストやプライベート接続、Privacy Modeといった制御が説明されています。
セルフホストの場合、チェックアウトやビルドキャッシュ、マシンローカルの資格情報は自社マシンに残り、実行中はファイル内容やターミナル出力、差分、スクリーンショットなどエージェントが必要とする内容がCursorに送られる、という説明です。
セルフホストの場合、チェックアウトやビルドキャッシュ、マシンローカルの資格情報は自社マシンに残り、実行中はファイル内容やターミナル出力、差分、スクリーンショットなどエージェントが必要とする内容がCursorに送られる、という説明です。
テキトー教師DotAI 認定講師既存のCursorエディタとの違いは、エディタが人が書く場所、Agent SDKがエージェントを定義して運用する場所、という整理になります。Cursor全体の機能はCursor AIとは？使い方・料金・モデル・インストールを完全解説【2026年最新】にまとまっています。
室谷代表取締役テキトー教師DotAI 認定講師最後に、実際の使用感や他ツールとの比較については、現時点で公式から評価が示されているわけではないので、本記事では触れていません。まずは公式ドキュメントのクイックスタートで1体動かして、evalで測る、という順番が確実です。
室谷代表取締役エージェントを「作って終わり」にしないための仕組みが揃ってきた、というのが今回の発表の面白さなんですよね。プロンプトがリポジトリに入る日が、もうそこまで来ていると思います。
