2026年10月27日

Cursorの「Agent SDK」とは?エージェントをMarkdown×TypeScriptで定義・評価・デプロイ

Cursorの「Agent SDK」は、Cursorが発表したエージェント開発キットで、エージェントの指示・ツール・評価をMarkdownとTypeScriptのファイルとして定義し、テスト・評価・デプロイまでをコードと同じように扱えるようにするものです。

室谷室谷代表取締役
CursorがAgent SDKの提供を開始したんですよね。エージェントをコードとして定義して、プロンプトはMarkdown、ツールはTypeScript。

Cursorのホスト基盤でも自社インフラでも動かせる、と。これはエディタの話ではなくて、開発ワークフローの話になってきています。
テキトー教師テキトー教師DotAI 認定講師
そうなんですよ。単に「エージェントが作れるようになりました」という話じゃないんです。

指示もツールもevalもファイルとしてバージョン管理できる、というのが本質で。講座でも受講生さんに「プロンプトはGitで管理するもの」と伝えているんですが、その発想がそのまま製品になった形です。

Cursor Agent SDKとは?何が発表されたのか

Cursorのエージェント手段の使い分け
Automations
  • ダッシュボードでプロンプト・モデル・トリガーを定義
  • 業務の自動化はこれで足りる場面が多い
Grok Bot
  • コードを書かずに設定・対話する
室谷室谷代表取締役
まず定義を整理すると、Agent SDKはCursorが提供を開始したSDKで、エージェントをコードとして定義・テスト・評価・デプロイできるものです。公式ドキュメントには、Bugbot、Security Review、Approval Bot、Rolloutsを動かしているCursorのSDKハーネスを使うと書かれています。

つまりCursorが自社プロダクトで回している基盤がそのまま外に出てきた、という理解でいいんですよね。
テキトー教師テキトー教師DotAI 認定講師
そこが大きいですよね。エージェントの振る舞いは、MarkdownとTypeScriptを組み合わせたフォルダで定義されます。

決定的なコードとモデルの判断を組み合わせる、と。そしてSlack、プルリクエスト、Issueトラッカー、Cursorといった、実際に仕事が発生する場所で動くためのAPIが用意されている。
室谷室谷代表取締役
デプロイした後は「Deployed Agents」で管理する、と。発表の中心はあくまでCursorですから、Xで投稿されたからXが発表した、という話ではないですからね。
テキトー教師テキトー教師DotAI 認定講師
そこは正確に押さえたいところです。発表元はCursor。

で、何が新しいのかというと、指示・ツール・評価がレビューできてテストできてバージョン管理できるファイルになる、という点です。従来の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 導入から実行までの流れ
  1. 01
    Node 22.13以上を確認
    前提バージョンをチェック
  2. 02
    npm install --global @grok/agent-sdk
    旧パッケージ名は @cursor/bdk
  3. 03
    同梱ドキュメントのインデックスを読む
  4. 04
    agent-sdk login
    ブラウザでサインイン
  5. 05
    agent-sdk init ./my-bot
    プロジェクトを雛形から作成
  6. 06
    cd my-bot
  7. 07
    agent-sdk dev
    開発モードに入る
  8. 08
    agent-sdk validate --dir .
    動作確認
  9. 09
    agent-sdk run turn
    1ターン動かして返答を確認
テキトー教師テキトー教師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 dev
室谷室谷代表取締役
agent-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年最新】で詳しく解説しているので、あわせて読むと全体像がつかめます。
テキトー教師テキトー教師DotAI 認定講師
テンプレートも用意されていて、PRレビュー用のエージェントをステップバイステップで作るガイドや、レビュー・トリアージのテンプレート、owners-policyの承認エージェントなどが案内されています。最初の1体を作るまでの距離が短いのは大事です。
室谷室谷代表取締役
とはいえ、いきなり本番に置くのではなく、まず1ターン動かして返答を確認するところから、という公式の順番は妥当ですよね。

Cursor Agent SDKの料金と実行環境——自社インフラでも動かせるのか

室谷室谷代表取締役
ここが一番気になる人が多いところだと思うんですが、料金は選択したモデルのAPIレートに従い、プランの週次プールから消費、超過分はオンデマンド、という説明です。Cloud AgentsにVMなどの別途課金はない、と。
テキトー教師テキトー教師DotAI 認定講師
公式フォーラムでもCursorの担当者が「Cloud AgentsにVM・コンピュート・メモリの別途課金はない」と明言していて、選択したモデルのAPIレートで、まずプランに含まれる利用枠から、次にオンデマンドで、と説明しています。ビルドも追加費用なし。

コストに影響するのはモデルとコンテキストウィンドウの選択、そしてTeamsとEnterpriseではサードパーティモデルにCursor Token Rateがかかる、という整理です。
室谷室谷代表取締役
セルフホストは「Self-Hosted Machines」で、ワーカーがファイル編集とターミナル実行を担当し、Cursorがエージェントループ・推論・計画を担当する。つまり頭脳はCursor側、手足は自社側という分担なんですね。
テキトー教師テキトー教師DotAI 認定講師
公式ドキュメントによると、ワーカーはCursor CLIを入れて外向きHTTPS接続ができればよく、内向きのポートやパブリックIP、VPNトンネルは不要。接続はワーカーからCursorへの外向きのみで、Cursorが自社ネットワークに入ってくることはない、と説明されています。
室谷室谷代表取締役
これは大きいですよ。厳しいネットワーク要件があって外からコードに到達できない、GPUマシンやiOS開発用のMacが必要、カスタムイメージがある、といったケースで自社マシンを使える。

MYUUUでも顧客データを扱う案件だと実行場所は必ず論点になるので、ここが選べるのは現実的です。
テキトー教師テキトー教師DotAI 認定講師
ただし条件があります。Team Poolsでの利用にはEnterpriseプランとサービスアカウントAPIキーが必要で、個人のログインや他の種類のAPIキーではプールワーカーを起動できない、と明記されています。

あと、ワーカーはユーザーあたり200台、チームあたり1000台まで接続できる、という上限も書かれていますね。
室谷室谷代表取締役
料金体系そのものはCursorの料金を徹底解説!Pro/Pro+/Ultraの違いと選び方で整理しているので、プランの部分はそちらを見てもらうのが早いです。Agent SDK自体はモデルのAPIレートに乗る、という理解でいいんですよね。
テキトー教師テキトー教師DotAI 認定講師
そこは誤解されやすいので、公式の表現どおり「選択したモデルのAPIレートに従う」と押さえておきましょう。現時点では、Agent SDK専用の別料金が設定されているという記述は公式資料にはありません。

従来のAutomations・Grok BotとAgent SDKはどう使い分けるか

テキトー教師テキトー教師DotAI 認定講師
公式が比較表を出しているので、整理するとこうです。
観点Cursor AutomationsGrok BotAgent SDK
何を定義するかダッシュボードでプロンプト・モデル・トリガーアプリ内で指示・スキル・接続ツールバージョン管理されたMarkdownとTypeScriptのプロジェクト
実行場所Cursor管理Cursor管理Cursor管理のホスティング、または自社インフラ
選ぶ条件スケジュールやイベントトリガーに合う仕事コードを書かず設定と対話をしたいモデル判断の周りにコードを置き、チームでバージョン管理・レビュー・テスト・改善したい
室谷室谷代表取締役
すごく素直な分け方ですよね。定型的な定期実行ならAutomations、非エンジニアが対話で設定するならGrok Bot、ロジックとテストが要るならAgent SDK。
テキトー教師テキトー教師DotAI 認定講師
講座でよく聞かれるのが「どれから始めればいいか」なんですが、答えは「やりたいことの複雑さ」ではなく「チームで管理したいかどうか」なんですよ。プロンプトの変更をレビューしたい、テストしたい、劣化を測りたい。

そう思った時点で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でのツール定義については、現時点では明らかにされていません。
テキトー教師テキトー教師DotAI 認定講師
パッケージ名と必要な環境は、@grok/agent-sdkで、Node 22.13以上。以前は@cursor/bdkでした。

ここは正確に覚えておきたいですね。
室谷室谷代表取締役
無料で使えるのか、という点。Agent SDKは選択したモデルのAPIレートに従い、プランの週次プールから消費、超過はオンデマンドという説明です。

FreeプランでのAgent SDK利用可否については、現時点では明らかにされていません。
テキトー教師テキトー教師DotAI 認定講師
セルフホストは誰でも使えるのか、という点は、Team Poolsでの利用にEnterpriseプランとサービスアカウントAPIキーが必要と明記されています。個人のMy Machinesは個人の資格情報で接続する形です。
室谷室谷代表取締役
サンドボックスやセキュリティはどうなっているのか。Cursor管理のCloud Agentsはエージェントごとに隔離されたVMをCursorが用意し、ネットワークの許可リストやプライベート接続、Privacy Modeといった制御が説明されています。

セルフホストの場合、チェックアウトやビルドキャッシュ、マシンローカルの資格情報は自社マシンに残り、実行中はファイル内容やターミナル出力、差分、スクリーンショットなどエージェントが必要とする内容がCursorに送られる、という説明です。
テキトー教師テキトー教師DotAI 認定講師
既存のCursorエディタとの違いは、エディタが人が書く場所、Agent SDKがエージェントを定義して運用する場所、という整理になります。Cursor全体の機能はCursor AIとは?使い方・料金・モデル・インストールを完全解説【2026年最新】にまとまっています。
室谷室谷代表取締役
チームで導入するならTeamsやEnterpriseの話も避けられないので、Cursor Teamsとは?法人向けプランの全機能・料金・導入手順を完全解説【2026年最新】も参考にしてもらえればと。
テキトー教師テキトー教師DotAI 認定講師
最後に、実際の使用感や他ツールとの比較については、現時点で公式から評価が示されているわけではないので、本記事では触れていません。まずは公式ドキュメントのクイックスタートで1体動かして、evalで測る、という順番が確実です。
室谷室谷代表取締役
エージェントを「作って終わり」にしないための仕組みが揃ってきた、というのが今回の発表の面白さなんですよね。プロンプトがリポジトリに入る日が、もうそこまで来ていると思います。

Related

関連記事

New Articles

新着記事

ガイド

GoogleのAIモードとAIによる概要の消し方|公式オフ機能の有無とPC・スマホの回避策

2026年11月18日
室谷テキトー教師
ガイド

Azure OpenAI Serviceとは?料金・モデル一覧・データの扱いを最新情報で整理

2026年11月18日
室谷テキトー教師
ニュース

Perplexityの「Orchestrator API」とは?45以上のモデルを1つのAPIキーに統合

2026年11月18日
室谷テキトー教師
ニュース

Microsoftの「Copilot Workspaces」とは?人とエージェントが協働する新体験

2026年11月18日
室谷テキトー教師
ガイド

Geminiのファミリープランは何人まで?Google AI Proを家族で割る料金と設定の手順

2026年11月18日
室谷テキトー教師
ニュース

Microsoft MAIとは?Ignite 2026で発表の7モデルと料金

2026年11月18日
室谷テキトー教師
ニュース

Replit Missionsとは?エージェントスウォームで目標達成型の自律実行

2026年11月18日
室谷テキトー教師
ニュース

Copilot Fusion Maxとは?Terminal-Bench 4.1首位の自動モデル選択

2026年11月18日
室谷テキトー教師
ニュース

Googleの「Gemini Tasks」とは?日本でも無料開始、Gemini 4 Hydrogen搭載

2026年11月18日
室谷テキトー教師
ニュース

HeyGenの「Avatar 6」とは?実映像と見分け84.4%の最新アバター

2026年11月18日
室谷テキトー教師

Join

AIプレナーになる。

入会は審査制です。いまの事業と、AIで何を動かしたいのかを聞かせてください。

参加を申請する