メインコンテンツへスキップ
Forward Mode は Build Mode の上に構築された受管の提供レイヤーです。管理者が三層構成モデル(企業 / テンプレート / アイデンティティ)で Agent の形態と利用可能なリソースをあらかじめ設定し、呼び出し側は template_ididentity_id を渡すだけで Agent を利用できます。基盤となるランタイムの詳細を意識する必要はありません。 Forward Mode は IM チャネル連携、定時トリガー(Schedules)、エンドユーザーの身元分離(Identities)を標準搭載しており、SaaS 事業者、業務インテグレーター、そして C 向けや大量の呼び出し側を抱えるチームに適しています。

ベース URL

すべての Forward エンドポイントは本番ゲートウェイを使用します:
https://api.qoder.com/api/v1/forward

認証

すべての Forward エンドポイントは Qoder PAT 認証を必要とします:
ヘッダー必須説明
AuthorizationはいBearer <PAT>
副作用のある POST エンドポイントは Idempotency-Key ヘッダーを受け付ける場合があります。

リソースファミリー

リソース説明
Templatesデフォルトの Agent / Session 設定を定義する、再利用可能な Agent 形態のベースライン
Identitiesアイデンティティ単位の設定オーバーライドと分離を備えたエンドユーザー身元
Sessionsテンプレート + アイデンティティから開始する対話またはタスク実行
SchedulesCron または一回限りのトリガー実行
Schedule runsSchedules が生成する実行記録
Channels外部 IM チャネルとの連携
Resources Registry共有リソースを Forward に登録

エラーエンベロープ

エラーは Forward のエラーエンベロープを使用します:
{
  "type": "error",
  "request_id": "req_xxx",
  "error": {
    "type": "invalid_request_error",
    "code": "invalid_request_body",
    "message": "invalid request body"
  }
}

関連

Template を作成

Session を作成