メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
コアコンセプト

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

​
ワークフロー

1

Agent を定義

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

Environment を構成

コンテナタイプ、ネットワークポリシー、プリインストールする依存関係を選択します（または default 環境を直接利用）。
3

Session を起動

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

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

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

​
接続性のクイック確認

# PAT が有効か検証し、すべての Agent をリスト表示
curl -s https://openapi.qoder.sh/api/v1/cloud/agents \
  -H "Authorization: Bearer $QODER_PAT"
成功時のレスポンス形式: 
{

  "data": [ ],

  "first_id": null,
  "last_id": null,
  "has_more": false
}

​
ユースケース

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

​
認証方式

すべての API リクエストには以下のヘッダーを付与する必要があります。
Header値説明
AuthorizationBearer <PAT>パーソナルアクセストークン
PAT は Qoder コンソールの「設定 → パーソナルアクセストークン」で作成します。厳重に保管し、コードリポジトリにコミットしないでください。

​
ページング

リスト系エンドポイントはカーソルページングを統一して使用します。レスポンス構造: 
{
  "data": [...],
  "first_id": "ag_abc123",
  "last_id": "ag_xyz789",
  "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 が破棄された後はデータも消去されます。

​
次のステップ