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

​
はじめに

Qoder Cloud Agents API は、クラウド AI Agent の包括的な管理機能を提供します。Agent の作成、環境設定、セッション管理、イベントストリーム処理などの主要機能をカバーします。すべての API は RESTful 設計に従い、リクエスト / レスポンス形式として JSON を使用します。
現在、API は Beta 段階にあり、一部の機能は今後のバージョンで調整される可能性があります。

​
ゲートウェイ URL

環境URL
本番環境https://api.qoder.com/api/v1/cloud

​
バージョン

API は現在 v1 バージョンです。すべてのエンドポイントは /v1/ パスプレフィックスでバージョンを区別し、追加のバージョンヘッダーは不要です。

​
利用可能な API 一覧

リソース説明ベースパス
AgentsAgent インスタンスの作成・取得・更新・削除・アーカイブ/agents
Environments実行環境設定の管理/environments
SessionsAgent セッションの作成とライフサイクル管理/sessions
Eventsセッションイベントストリームの読み取りとプッシュ/events
Filesファイルのアップロードと関連付け管理/files
Vaults機密認証情報の安全な保管/vaults
SkillsAgent Skill の登録と管理/skills
Memory Stores永続化されたメモリストア/memory_stores

​
リクエストサイズ制限

  • 1 回のリクエスト Body の最大値: 4 MB
  • 上限を超えるとサーバー側で Body が切り詰められ、JSON パースに失敗して 400 invalid_request_error（message: “Request body must be valid JSON.”）が返されます。

​
リクエストヘッダー

すべての API リクエストには Authorization ヘッダーが必須です。Content-Type は推奨ですが必須ではありません。 
Authorization: Bearer $QODER_PAT
Content-Type: application/json   # 推奨

​
レート制限

API アプリケーション層では明示的なレート制限を実装していません。ゲートウェイ層のグローバル保護がリクエスト頻度を管理します。ゲートウェイ保護がトリガーされると HTTP 429 または 503 が返される場合があります。クライアント側では指数バックオフリトライと適度なリクエスト間隔を推奨します。

​
Beta ステータスについて

  1. API インターフェースは全体として安定していますが、シグネチャは今後のバージョンで微調整される可能性があります。
  2. 新機能は新しい Beta 識別子としてリリースされます。
  3. 本番環境ではバージョンの固定と互換性対応を行うことを推奨します。
  4. 現在のすべての機能は、追加の Beta ヘッダーなしで利用可能です。

​
接続性のクイック検証

# 現在のアカウント配下の Agent を一覧表示（認証と接続性の確認） \
curl -s https://api.qoder.com/api/v1/cloud/agents?limit=1 \
  -H "Authorization: Bearer $QODER_PAT"
成功時のレスポンス例: 
{
  "data": [],
  "first_id": null,
  "last_id": null,
  "has_more": false
}

​
次のステップ