All Products
Search

This Product

    Seri Qoder CN:Buat sesi

    Document Center

    Seri Qoder CN:Buat sesi

    Last Updated:Jul 04, 2026

    Buat sesi Forward berdasarkan suatu Identity dan Template.

    Header permintaan

    Header

    Wajib

    Deskripsi

    Authorization

    Ya

    Bearer <PAT>

    Content-Type

    Ya

    application/json

    Idempotency-Key

    Tidak

    Kunci idempotensi opsional untuk permintaan yang tidak aman.

    Badan permintaan

    Parameter

    Tipe

    Wajib

    Deskripsi

    identity_id

    string

    Ya

    Penerusan ID Identitas.

    template_id

    string

    Ya

    ID Forward Template.

    title

    string

    Tidak

    Judul sesi.

    incremental_streaming_enabled

    boolean

    Tidak

    Mengaktifkan event streaming inkremental asisten. Nilai default-nya adalah false.

    metadata

    object

    Tidak

    Metadata kustom.

    config

    object

    Tidak

    Penggantian konfigurasi per-sesi. Hanya bidang yang ada dalam daftar izin yang diterima.

    config.environment_variables

    object

    Tidak

    Variabel lingkungan sesi dalam bentuk pasangan kunci-nilai.

    resources

    array

    Tidak

    Sumber daya tingkat sesi, saat ini berupa file mounts.

    resources[].type

    string

    Ya jika resources digunakan

    Tipe sumber daya. Saat ini hanya file.

    resources[].file_id

    string

    Ya jika resources digunakan

    ID file dari Files API.

    resources[].mount_path

    string

    Tidak

    Jalur mount di dalam kontainer agen. Jika diabaikan, Forward akan menentukan jalurnya berdasarkan nama file.

    Contoh permintaan

    curl -s -X POST 'https://api.qoder.com.cn/api/v1/forward/sessions' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "identity_id": "idn_xxx",
    "template_id": "tmpl_support",
    "title": "Customer support session",
    "incremental_streaming_enabled": true,
    "metadata": {
      "source": "web",
      "biz_id": "ticket_123"
    },
    "config": {
      "environment_variables": {
        "API_KEY": "sk-xxx",
        "REGION": "cn-hangzhou"
      }
    },
    "resources": [
      {
        "type": "file",
        "file_id": "file_019e6a18dc09abcd",
        "mount_path": "/data/input.py"
      }
    ]
  }'

    Contoh tanggapan

    HTTP 200 OK

    {
  "id": "sess_xxx",
  "type": "session",
  "identity_id": "idn_xxx",
  "template": {
    "id": "tmpl_support",
    "type": "template",
    "name": "Support assistant",
    "model": "ultimate",
    "version": 3
  },
  "source_type": "api",
  "status": "idle",
  "title": "Customer support session",
  "incremental_streaming_enabled": true,
  "metadata": {
    "source": "web",
    "biz_id": "ticket_123"
  },
  "config": {
    "environment_variables": {
      "API_KEY": "sk-xxx"
    }
  },
  "stats": {
    "active_seconds": 0,
    "duration_seconds": 0
  },
  "archived_at": null,
  "created_at": "2026-06-22T10:00:00Z",
  "updated_at": "2026-06-22T10:00:00Z"
}

    Bidang tanggapan

    Bidang

    Tipe

    Deskripsi

    id

    string

    ID sesi.

    type

    string

    Selalu session.

    identity_id

    string

    ID Forward Identity.

    template

    object

    Rangkuman template.

    source_type

    string

    Sumber sesi. Pembuatan langsung melalui API menggunakan api.

    status

    string

    idle, running, rescheduling, canceling, atau terminated.

    incremental_streaming_enabled

    boolean

    Menunjukkan apakah streaming inkremental diaktifkan untuk sesi ini.

    archived_at

    string|null

    Timestamp arsip.

    created_at

    string

    Timestamp pembuatan.

    updated_at

    string

    Timestamp pembaruan.

    Kesalahan

    HTTP

    Tipe

    Kode

    Pemicu

    400

    invalid_request_error

    invalid_request_body

    Badan permintaan tidak valid.

    403

    permission_error

    template_access_denied

    Identity tidak dapat menggunakan Template tersebut.

    404

    not_found_error

    identity_not_found

    Identity tidak ada atau telah dihapus.

    404

    not_found_error

    template_not_found

    Template tidak ada.

    409

    conflict_error

    identity_disabled

    Identity dinonaktifkan.

    422

    invalid_request_error

    runtime_config_invalid

    Konfigurasi waktu proses efektif tidak valid.

    401

    authentication_error

    authentication_required

    PAT tidak valid atau telah kedaluwarsa.

    Catatan

    • source_type ditetapkan oleh Forward dan tidak diterima dalam permintaan pembuatan.

    • incremental_streaming_enabled disimpan pada Sesi dan tidak dapat diubah setelahnya.

    • File yang diunggah harus sudah tersedia di Files API sebelum dimasukkan ke dalam resources.