Skip to main content

​
Cursor

ShanoneのCursor連携は、Cursor自身のCloud Agents APIを操作する17個のツールをエージェントに提供します。エージェントの起動、実行の監視、フォローアップの送信、アーティファクトの取得が対象です。

​
はじめに

1

Cursor APIキーを発行する

Cursorのcursor.com/settingsでAPIキーを作成します。
2

Shanoneに登録する

Shanoneダッシュボードの連携を開き、Cursorを選択してAPIキーを貼り付けます。
3

リクエストを再実行する

保存が完了すると、cursor_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはCursor向けに17個のツールを、以下のカテゴリに整理して提供しています。
cursor_list_agents, cursor_get_agent_status, cursor_get_agent_conversation, cursor_launch_agent, cursor_add_followup, cursor_delete_agent, cursor_archive_agent, cursor_unarchive_agent
cursor_list_runs, cursor_get_run, cursor_create_run, cursor_cancel_run
cursor_list_artifacts, cursor_download_artifact
cursor_get_api_key_info, cursor_list_models, cursor_list_repositories

​
よくあるユースケース

バックグラウンドコーディングの委任

タスクプロンプトを付けてリポジトリでCloud Agentを起動し、完了までポーリングする

マルチエージェントオーケストレーション

複数のリポジトリ/ブランチにエージェントを分散起動し、会話履歴をレビュー用に集約する

フォローアップによる方向調整

新しいエージェントを最初から起動する代わりに、実行中のエージェントにフォローアップ指示を送る

アーティファクトの取得

完了した実行から生成されたdiff、ログ、ビルド出力を取得する

​
トラブルシューティング

対象のリポジトリは、接続済みアカウントについてcursor_list_repositoriesに表示されている必要があります。Cursor Cloud AgentはAPIキーのアカウントが実際にアクセスできるリポジトリでのみ動作します。
長時間実行のエージェントは数分かかることが想定されています。即座の完了を期待せず、cursor_get_agent_statusを定期的にポーリングし、中間の進行状況はcursor_get_agent_conversationで確認してください。
フォローアップは、まだアクティブな(アーカイブ・削除されていない、または完了していない)エージェントにのみ送信できます。まずcursor_get_agent_statusを確認し、エージェントが既に完了している場合はcursor_launch_agentで新規に起動してください。