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

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

​
ゲートウェイ URL

環境URL
本番環境https://openapi.qoder.sh/api/v1/cloud
テスト環境https://openapi.qoder.sh/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 の最大値: 32 MB
  • 上限を超えた場合は 400 invalid_request_error が返されます。

​
必須リクエストヘッダー

すべての API リクエストには、以下のヘッダーを含める必要があります。 
Authorization: Bearer $QODER_PAT
Content-Type: application/json

​
Beta ステータスについて

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

​
接続性のクイック検証

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

​
次のステップ