概要 - - Alibaba Cloud ドキュメントセンター

Qoder Cloud Agents CN は、フルマネージド型の AI エージェントランタイムプラットフォームです。エージェントループを独自に構築したり、ツール実行サンドボックスを管理したり、長時間存続する接続を処理したりする必要はありません。エージェントを定義し、API を通じてセッションを開始するだけで、複雑なタスクを実行し、クラウド上でリアルタイムに結果を受け取ることができます。

重要

新しい Qoder CN ドキュメントサイトが利用可能になりました。このサイトのコンテンツは、最新の製品機能や変更を反映していない場合があります。最新の製品ドキュメントについては、docs.qoder.cn をご覧ください。

基本概念

概念	説明	類推
エージェント	モデル、システムプロンプト、ツールセットを定義する再利用可能な設定テンプレートです。	従業員の職務記述書
環境	ネットワークや依存関係の設定を含む、セッションが実行されるコンテナ環境です。	デスクとツールボックス
セッション	会話またはタスク実行の特定のインスタンスです。	特定の作業セッション
イベント	セッション内で生成されるリアルタイムのイベントストリームです。	作業進捗のリアルタイム配信

ワークフロー

エージェントを定義する — モデル、システムプロンプト、使用可能なツールを指定します。
環境を設定する — コンテナタイプ、ネットワークポリシー、プリインストールされた依存関係を選択します。新規アカウントでは、デフォルトで提供される環境がないため、まず POST /environments を使用して環境を作成する必要があります。
セッションを開始する — エージェントを環境にバインドして、ランタイムインスタンスを作成します。
メッセージを送信してイベントを受信する — user.message をセッションに送信し、Server-Sent Events (SSE) またはポーリングを通じて、エージェントの思考、メッセージ、ステータス変更などのリアルタイムイベントストリームを受信します。

接続の確認

# PAT を検証してエージェントをリストする
curl -s https://api.qoder.com.cn/api/v1/cloud/agents \
  -H "Authorization: Bearer $QODER_PAT"

成功すると、次のようなレスポンスが返されます。

{
  "data": [ ],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

ユースケース

長時間実行される非同期タスク — コードレビュー、大規模なリファクタリング、自動テスト生成。
API 統合 — ランタイムを維持することなく、エージェント機能をバックエンドサービスに組み込むことができます。
バッチ処理 — 複数のセッションを並行して開始し、バッチリクエストを処理できます。
スケジュールされたタスク — スケジューリングシステムと統合して、検査やレポート作成のためにエージェントを定期的に実行できます。

認証

すべての API リクエストには、次のヘッダーを含める必要があります。

ヘッダー	値	説明
`Authorization`	`Bearer <PAT>`	パーソナルアクセストークン

Qoder コンソールで [Settings] > [Personal Access Tokens] に移動して、パーソナルアクセストークン (PAT) を作成できます。PAT は安全に保管し、コードリポジトリにコミットしないでください。

ページネーション

リスト API は、カーソルベースのページネーションを使用します。レスポンスは次のような構造です。

{
  "data": [...],
  "first_id": "agent_019e451902fe7a2ca42c2dfc62d9320e",
  "last_id": "agent_019e45369b3379e18bfaf59b3aad2fc9",
  "has_more": true
}

after_id と before_id クエリパラメータを使用してページネーションを行います。

よくある質問

Q：Qoder Cloud Agents CN と Qoder CLI を同時に使用できますか?

A：はい。Qoder CLI はローカルでのインタラクティブな開発に最適であり、Qoder Cloud Agents CN は自動化と統合のために設計されています。両者は互いに補完し合います。

Q：1 つのエージェントで同時に実行できるセッション数はいくつですか?

A：ハードリミットはありません。エージェント設定は、同時に複数のアクティブセッションに関連付けることができます。

Q：データセキュリティはどのように確保されますか?

A：各セッションは分離されたコンテナサンドボックスで実行され、セッション間のアクセスを防ぎます。環境が破棄されると、すべてのデータが消去されます。

次のステップ

クイックスタート：5 つのステップで最初のクラウドエージェントを実行
エージェントの定義：エージェント設定の詳細
クラウド環境：ランタイム環境の設定
セッションの開始：セッションライフサイクルの管理