概要 - AI Coding Assistant Lingma - Alibaba Cloud ドキュメントセンター

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

基本概念

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

ワークフロー

エージェントの定義 — モデル、システムプロンプト、利用可能なツールを指定します。
環境の設定 ーコンテナタイプ、ネットワークポリシー、プレインストールされた依存関係を選択します。新規アカウントは、デフォルトでは環境が提供されていないため、まず 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>`	パーソナルアクセストークン

パーソナルアクセストークン (PAT) は、Qoder コンソールで [Settings] > [Personal Access Tokens] に移動して作成できます。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：厳密な制限はありません。1 つのエージェント設定を、複数のアクティブセッションに同時に関連付けることができます。

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

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

次のステップ

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