コンテンツにスキップ
tansr 资料站

AssemblePlatformModelOptions

このコンテンツはまだ日本語訳がありません。

令牌档装配选项(createSession/query 的 token 档字段投影)

属性

Section titled “属性”

appId?

Section titled “appId?”
optional appId?: string;

缓存键的应用维(令牌所属 app 的公开标识):同一进程对同一 baseUrl 混用多个 app 的令牌时必须传, 否则缓存退化为 per-baseUrl 单条目(首个令牌拉到的 bundle 被后续会话复用)。app_user 令牌本体不暴露 appId,故无法自推。

baseUrl

Section titled “baseUrl”
baseUrl: string;

平台 API 基址(如 https://api.example.com;/t1 前缀由装配追加)

bundleCache?

Section titled “bundleCache?”
optional bundleCache?: BundleCache;

bundle/features 进程级缓存(createBundleCache):在场时 bundle 与 features 经缓存取得 (TTL = 响应 max-age 与 ttlMs 取小;过期后 If-None-Match 条件重拉;同键并发只一次出网), 命中即零上游往返;缺席 = 逐会话拉取(零漂移)。serve 平台内置形缺省接一枚;SDK 端侧多会话同 app 可自接。

fetchImpl?

Section titled “fetchImpl?”
optional fetchImpl?: any;

fetch 注入缝(bundle 拉取与 twp 交换共用;测试桩网关)

model?

Section titled “model?”
optional model?: string;

模型别名(bundle aliases/目录 handle);缺省 ‘main’

onProviderSelected?

Section titled “onProviderSelected?”
optional onProviderSelected?: (selection) => void;

fallback 链最终命中通报(session 装配合成 cost.provider.switched)

参数

Section titled “参数”
selection
Section titled “selection”

FallbackSelection

返回

Section titled “返回”

void

onSessionArchived?

Section titled “onSessionArchived?”
optional onSessionArchived?: (sessionId) => void;

归档会话心跳(410 session_archived)旁路:装配期心跳报告「本会话 id 已被平台归档」——消费方 (createSession)据此停止对该 id 的心跳、不重试,并铸新平台会话 id,下轮 exchange 以新 id 开新会话 (exchange 首见幂等登记)。入参 = 被归档的会话 id(平台信封 detail.sessionId;缺席回落本次心跳携带的 id; 皆缺席 undefined)。缺席 = 410 与其它非 2xx 同为静默失败(features 门关),行为现状。

参数

Section titled “参数”
sessionId
Section titled “sessionId”

string | undefined

返回

Section titled “返回”

void

onWarn?

Section titled “onWarn?”
optional onWarn?: (warn) => void;

平台 t.warn 提示帧旁路(thinking_unavailable_on_face / balance_low 等):平台的结构化告知经此到达 开发者,不静默蒸发;经既有 registry twp 选项缝透传。

参数

Section titled “参数”
warn
Section titled “warn”

PlatformWarning

返回

Section titled “返回”

void

sessionId?

Section titled “sessionId?”
optional sessionId?: () => string | undefined;

twp meta.sessionId 动态供给(平台会话 id,ULID 形制;经 ProviderRegistry twp 选项缝透传)。 createSession 令牌档 per-AgentSession 铸造一枚注入;缺席 = meta.sessionId 如实不携带 (归账兜底在认证头),query 单轮档现维持缺席。

返回

Section titled “返回”

string | undefined

token

Section titled “token”
token: string;

app_user 短期令牌(开发者服务端经 POST /v1/app-tokens 换发)