Skip to main content
POST
新しいセッションを作成

承認

Authorization
string
header
必須

個人用APIキー (apk_user_*) またはサービス用APIキー (apk_*)

ボディ

application/json
prompt
string
必須
idempotent
boolean
デフォルト:false
knowledge_ids
string[] | null

使用する Knowledge ID のリストです。None の場合はすべての Knowledge を使用し、空リストの場合は Knowledge を使用しません。

max_acu_limit
integer | null

ACU の最大 limit。正の値である必要があります。

必須範囲: x > 0
playbook_id
string | null
secret_ids
string[] | null

使用するシークレット ID の一覧です。None が指定された場合は、すべてのシークレットを使用します。空リストが指定された場合は、シークレットを一切使用しません。

session_secrets
SessionSecretInput · object[] | null

使用するセッション固有のシークレットのリスト。このセッションでのみ利用可能で、組織のシークレットには保存されません。

snapshot_id
string | null
structured_output_schema
Structured Output Schema · object | null

構造化出力を検証するための JSON Schema(Draft 7 準拠)。最大 64KB。自己完結型である必要があります(外部への $ref 参照は不可)。

tags
string[] | null

セッションに追加するタグのリスト。

Maximum array length: 50
title
string | null

セッションのカスタムタイトル。None が指定された場合は、自動的にタイトルが生成されます。

unlisted
boolean
デフォルト:false

レスポンス

成功時のレスポンス

セッションが正常に作成された場合に返されるレスポンスボディ。

session_id
string
必須
url
string
必須
is_new_session
boolean | null