Skip to main content
はじめに

概要

フルマネージドのクラウドサンドボックスで AI Agent を実行します。

Qoder Cloud Agents は、フルマネージドの AI Agent 実行プラットフォームです。agent loop を自前で構築したり、ツール実行用のサンドボックスを管理したり、ロングコネクションを保守したりする必要はありません。API を通じて Agent を定義し Session を起動するだけで、複雑なタスクをクラウド上で実行し、結果をリアルタイムに受信できます。

コアコンセプト

コンセプト説明アナロジー
Agent再利用可能な構成テンプレート。モデル、システムプロンプト、ツールセットを定義「従業員の職務記述書」
EnvironmentSession が実行されるコンテナ環境。依存パッケージと起動処理の構成を含む「デスクとツールボックス」
Session1 回の対話/タスク実行のインスタンス「具体的な業務セッション」
EventSession 中に発生するリアルタイムなイベントストリーム「業務進捗のリアルタイム配信」

ワークフロー

1

Agent を定義

モデル、system prompt、利用可能なツールを指定します。
2

Environment を構成

コンテナタイプ、プリインストール依存関係、セットアップスクリプトを選択します。新規アカウントには事前プロビジョニングされたデフォルト環境はありません。まず POST /api/v1/cloud/environments で環境を作成する必要があります。
3

Session を起動

Agent と Environment をバインドして実行インスタンスを作成します。
4

メッセージ送信 + イベント受信

Session に user.message を送信し、SSE ストリーム（またはポーリング）で Agent の思考、メッセージ、状態変化などのイベントをリアルタイムに受信します。

接続性のクイック確認

# PAT または SAT が有効か検証し、すべての Agent をリスト表示
curl -s https://api.qoder.com/api/v1/cloud/agents \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"
成功時のレスポンス形式: 
{
  "data": [],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

ユースケース

  • 長時間の非同期タスク — コードレビュー、大規模リファクタリング、自動化テスト生成
  • API 統合 — バックエンドサービスに Agent 機能を組み込み、ランタイム保守を不要に
  • バッチ処理 — 複数の Session を並列で起動し、バッチリクエストを処理
  • 定期タスク — スケジューラと連携し、Agent を定期実行して点検/レポートを完了

認証方式

すべての API リクエストには以下のヘッダーを付与する必要があります。
Header値説明
AuthorizationBearer <PAT or SAT>Personal Access Token（PAT）または Service Account Token（SAT）
個人ユーザーは Qoder コンソールの「設定 → パーソナルアクセストークン」で PAT を作成できます。Service Account は Service Token Exchange エンドポイントを通じて SA API Key を短期間有効な SAT に交換する必要があります。詳しくは 認証 を参照してください。

ページング

リスト系エンドポイントはカーソルページングを統一して使用します。レスポンス構造: 
{
  "data": [...],
  "first_id": "agent_019e451902fe7a2ca42c2dfc62d9320e",
  "last_id": "agent_019e45369b3379e18bfaf59b3aad2fc9",
  "has_more": true
}
after_id / before_id クエリパラメータでページを送ります。

よくある質問

Q: Cloud Agents と Qoder CLI は同時に使えますか? A: 問題ありません。CLI はローカルでのインタラクティブ開発に、Cloud Agents は自動化や統合シナリオに適しており、相互に補完します。 Q: 1 つの Agent で同時に何個の Session を実行できますか? A: ハードリミットはなく、同じ Agent 構成に対して複数のアクティブな Session を同時に紐づけられます。 Q: データセキュリティはどう担保されますか? A: 各 Session は隔離されたコンテナサンドボックス内で実行され、Session 間で相互アクセスはできません。Environment が破棄された後はデータも消去されます。

次のステップ

はじめに
Agent の定義
Agent 環境の設定
Agent にタスクを委任する
Agent 連携
Agent コンテキストの管理
アカウント
ベストプラクティス
お知らせ
API リファレンス