> ## 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.

# 概要

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

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

<Card title="Cloud Agents コンソールを開く" icon="arrow-up-right-from-square" href="https://qoder.com/cloud/agents" horizontal>
  ブラウザから Agent / Environment / Session を管理できます。
</Card>

## コアコンセプト

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

## ワークフロー

<Steps>
  <Step title="Agent を定義">
    モデル、system prompt、利用可能なツールを指定します。
  </Step>

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

  <Step title="Session を起動">
    Agent と Environment をバインドして実行インスタンスを作成します。
  </Step>

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

## 接続性のクイック確認

```bash theme={null}
# PAT が有効か検証し、すべての Agent をリスト表示
curl -s https://api.qoder.com/api/v1/cloud/agents \
  -H "Authorization: Bearer $QODER_PAT"
```

成功時のレスポンス形式:

```json theme={null}
{
  "data": [],
  "first_id": null,
  "last_id": null,
  "has_more": false
}
```

## ユースケース

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

## 認証方式

すべての API リクエストには以下のヘッダーを付与する必要があります。

| Header          | 値              | 説明            |
| --------------- | -------------- | ------------- |
| `Authorization` | `Bearer <PAT>` | パーソナルアクセストークン |

<Note>
  PAT は Qoder コンソールの「設定 → パーソナルアクセストークン」で作成します。厳重に保管し、コードリポジトリにコミットしないでください。
</Note>

## ページング

リスト系エンドポイントはカーソルページングを統一して使用します。レスポンス構造:

```json theme={null}
{
  "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 が破棄された後はデータも消去されます。

## 次のステップ

<CardGroup cols={2}>
  <Card title="クイックスタート" icon="rocket" href="/ja/cloud-agents/quickstart">
    5 ステップで最初の Cloud Agent を動かす。
  </Card>

  <Card title="Cloud Agents コンソール" icon="browser" href="https://qoder.com/cloud/agents">
    Web 画面から Agent / Environment / Session を管理する。
  </Card>

  <Card title="Agent の定義" icon="user-gear" href="/ja/cloud-agents/define-agent">
    Agent 構成を深掘り。
  </Card>

  <Card title="クラウド環境" icon="server" href="/ja/cloud-agents/environments">
    実行環境を構成する。
  </Card>

  <Card title="Session の開始" icon="play" href="/ja/cloud-agents/sessions">
    セッションのライフサイクルを管理する。
  </Card>
</CardGroup>