跳转到内容
tansr 资料站

应用策略写入(逐段校验):modelCatalogIds ∈ 本户有效集(用户级选择集∩可服务谓词)、adjudicatorIds ∈ 用户清单∪本户自定义档、contextPolicy.schemeId 存在且可用、searchProviderId 存在且 active(账套级默认搜索商,/t1/websearch 恒首选,null 回继承平台默认);缺席键不动该段、null 回继承、[] 显式空集(fail-closed);写恒 bundle 失效(附 apiKeyId 维度)+ 审计

PUT
/v1/apps/{id}/config

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Header Parameters

Section titled “Header Parameters”
x-tansr-org
string

Org 作用域声明(org 公开 id);服务端校验成员资格与角色,非成员恒 404、角色不够 403

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
systemPrompt
Any of:
string
<= 16000 characters
systemPromptPolicy
Any of:
string
Allowed value: fallback
modelCatalogIds
Any of:
Array<string>
<= 500 items
adjudicatorIds
Any of:
Array<string>
<= 64 items
contextPolicy
Any of:
object
schemeId
required
Any of:
string
>= 1 characters <= 64 characters
overrides

白名单键合并到生效档(T-A8 同白名单;K18 扩面与档体同源)

object
windowBudgetTokens

窗口预算 tokens(下界 1024;T-A42 正名键,写面首选)

integer
>= 1024
maxTokens

窗口预算 tokens(deprecated:T-A42 双发期兼容写键,退役门 CTX-RET-1 后拒收;请改用 windowBudgetTokens)

integer
>= 1024
compactThreshold
number
> 0 <= 1
pinnedPolicy
Any of:
string
Allowed value: none
notes
string
<= 2048 characters
compactOutputBudget

压缩摘要 round 输出预算 tokens;内核缺省 20000

integer
>= 1
configuredReserve

窗口预留区 tokens;内核缺省 20000

integer
>= 1
autoCompactMargin

自动压缩触发余量 tokens;内核缺省 13000

integer
warningMargin

警戒线余量 tokens;内核缺省 20000

integer
blockingMargin

阻塞线余量 tokens;内核缺省 3000

integer
microcompactMargin

Microcompact 触发余量 tokens(须 > autoCompactMargin);内核缺省 40000

integer
keepRecentRounds

压缩保留最近完整 round 数;内核缺省 2

integer
timeoutMs

压缩 round 模型调用空闲闸 ms(无流进展窗口,生成推进中受 ×5 硬上限封顶;写面界 1s..10min);内核缺省 90000

integer
>= 1000 <= 600000
toolResultDecay

L3 工具结果分级衰减门(P-CTX3);内核缺省关

boolean
decayHysteresisTokens

衰减档滞回带 tokens(仅 toolResultDecay=true 生效);内核缺省 0

integer
decayErrorRetention

衰减档错误证据保留门(P-CTX5 K20;仅 toolResultDecay=true 生效):未被取代的 isError 结果阻尼后折;内核缺省关

boolean
endpointAwareCompaction

端点感知压缩门(P-CTX4 机制 3+4);内核缺省关

boolean
cacheAwareRewrite

缓存感知改写节律门(P-CTX5 K21):高命中且水位非紧急时推迟 microcompact 原位改写;内核缺省关

boolean
budgetAwareness

预算自觉注入门(P-CTX5 K22):请求尾部注入 context-budget 协议块供模型自主收敛;内核缺省关

boolean
anchorLayer

锚点层 L1 门(P-CTX4 机制 1);内核缺省关

boolean
anchorBudgetTokens

锚点 digest 预算 tokens(仅 anchorLayer=true 生效);内核缺省 1024

integer
>= 128 <= 8192
bucketedCalibration

估算-校准闭环门(P-CTX4 机制 5);内核缺省关

boolean
confidenceMarginRatio

低置信桶安全边际比(仅 bucketedCalibration=true 生效);内核缺省 0.1

number
<= 0.25
autoMemory

跨会话自动记忆 M1 门(TMEM/1 doc/38 §4.2;cli REMOTE_SCHEME_IDENTITY_KEYS 恒等直落);内核缺省关。bundle orgMemory 段 deny 恒胜本键

boolean
recallSelector

召回选择器(三档)门(TMEM/1 doc/38 §4.7);内核缺省关。末端 autoMemory 生效门关时本键恒不生效

boolean
recallBudgetFileBytes

三档召回单主题浮现帽(UTF-8 字节;超则按行边界截断);仅 recallSelector=true 生效;内核缺省 4096

integer
>= 256 <= 65536
recallBudgetRoundBytes

三档召回单轮注入总帽(UTF-8 字节;装不下整条跳过);仅 recallSelector=true 生效;内核缺省 20480

integer
>= 1024 <= 262144
recallBudgetSessionBytes

三档召回纪元注入总帽(UTF-8 字节;/clear 纪元轮换重置);仅 recallSelector=true 生效;内核缺省 61440

integer
>= 1024 <= 1048576
taskConcurrency

Task 同轮并发上限(kernel governance-baseline 同名同界 1..8);缺省 1 = 独占串行;涉费用放大,调大须与预算面联动评估

integer
>= 1 <= 8
searchProviderId
Any of:
string
>= 1 characters <= 64 characters

Responses

Section titled “Responses”

200

Section titled “200”

已写({app, config})

Media typeapplication/json
object
app
required
object
credentialRotationRequired

离组收回旧凭据；应用仍归组织，须当前组织管理员轮换。旧令牌和双头立即失效。

boolean
ownership
object
type
required
Any of:
string
Allowed value: user
orgId
required
Any of:
string
permissions
object
canManage
required
boolean
canDelete
required
boolean
canRequestDeletion
required
boolean
deletionRequestUnavailableReason
string
Allowed value: org_governance_disabled
id
required

ApiKeyId(api_keys.public_id;门户/审计/报表同键,可公开引用)

string
name
required
string
status
required
Any of:
string
Allowed value: active
ipAllowlist
required
Any of:
Array<string>
keyPrefix
required

密文展示前缀(tsk_ + 6);密文仅创建/轮换各回显一次,hash 永不回读

string
expiresAt
required
Any of:
string
signRequired
required

True = 未签名 /t1 请求恒 401 signature_invalid

boolean
platform
required
Any of:
Any of:
string
Allowed value: desktop
deviceBound
required

True = CLI init 派生装置绑定键(走用户层能力控制面,应用配置对其不生效)

boolean
purpose
required
Any of:
string
lastUsedAt
required
Any of:
string
createdAt
required
string
config
required
object
systemPrompt
required
Any of:
string
<= 16000 characters
systemPromptPolicy
required
Any of:
string
Allowed value: fallback
modelCatalogIds
required
Any of:
Array<string>
adjudicatorIds
required
Any of:
Array<string>
contextPolicy
required
Any of:
object
schemeId
required
Any of:
string
>= 1 characters <= 64 characters
overrides

白名单键合并到生效档(T-A8 同白名单;K18 扩面与档体同源)

object
windowBudgetTokens

窗口预算 tokens(下界 1024;T-A42 正名键,写面首选)

integer
>= 1024
maxTokens

窗口预算 tokens(deprecated:T-A42 双发期兼容写键,退役门 CTX-RET-1 后拒收;请改用 windowBudgetTokens)

integer
>= 1024
compactThreshold
number
> 0 <= 1
pinnedPolicy
Any of:
string
Allowed value: none
notes
string
<= 2048 characters
compactOutputBudget

压缩摘要 round 输出预算 tokens;内核缺省 20000

integer
>= 1
configuredReserve

窗口预留区 tokens;内核缺省 20000

integer
>= 1
autoCompactMargin

自动压缩触发余量 tokens;内核缺省 13000

integer
warningMargin

警戒线余量 tokens;内核缺省 20000

integer
blockingMargin

阻塞线余量 tokens;内核缺省 3000

integer
microcompactMargin

Microcompact 触发余量 tokens(须 > autoCompactMargin);内核缺省 40000

integer
keepRecentRounds

压缩保留最近完整 round 数;内核缺省 2

integer
timeoutMs

压缩 round 模型调用空闲闸 ms(无流进展窗口,生成推进中受 ×5 硬上限封顶;写面界 1s..10min);内核缺省 90000

integer
>= 1000 <= 600000
toolResultDecay

L3 工具结果分级衰减门(P-CTX3);内核缺省关

boolean
decayHysteresisTokens

衰减档滞回带 tokens(仅 toolResultDecay=true 生效);内核缺省 0

integer
decayErrorRetention

衰减档错误证据保留门(P-CTX5 K20;仅 toolResultDecay=true 生效):未被取代的 isError 结果阻尼后折;内核缺省关

boolean
endpointAwareCompaction

端点感知压缩门(P-CTX4 机制 3+4);内核缺省关

boolean
cacheAwareRewrite

缓存感知改写节律门(P-CTX5 K21):高命中且水位非紧急时推迟 microcompact 原位改写;内核缺省关

boolean
budgetAwareness

预算自觉注入门(P-CTX5 K22):请求尾部注入 context-budget 协议块供模型自主收敛;内核缺省关

boolean
anchorLayer

锚点层 L1 门(P-CTX4 机制 1);内核缺省关

boolean
anchorBudgetTokens

锚点 digest 预算 tokens(仅 anchorLayer=true 生效);内核缺省 1024

integer
>= 128 <= 8192
bucketedCalibration

估算-校准闭环门(P-CTX4 机制 5);内核缺省关

boolean
confidenceMarginRatio

低置信桶安全边际比(仅 bucketedCalibration=true 生效);内核缺省 0.1

number
<= 0.25
autoMemory

跨会话自动记忆 M1 门(TMEM/1 doc/38 §4.2;cli REMOTE_SCHEME_IDENTITY_KEYS 恒等直落);内核缺省关。bundle orgMemory 段 deny 恒胜本键

boolean
recallSelector

召回选择器(三档)门(TMEM/1 doc/38 §4.7);内核缺省关。末端 autoMemory 生效门关时本键恒不生效

boolean
recallBudgetFileBytes

三档召回单主题浮现帽(UTF-8 字节;超则按行边界截断);仅 recallSelector=true 生效;内核缺省 4096

integer
>= 256 <= 65536
recallBudgetRoundBytes

三档召回单轮注入总帽(UTF-8 字节;装不下整条跳过);仅 recallSelector=true 生效;内核缺省 20480

integer
>= 1024 <= 262144
recallBudgetSessionBytes

三档召回纪元注入总帽(UTF-8 字节;/clear 纪元轮换重置);仅 recallSelector=true 生效;内核缺省 61440

integer
>= 1024 <= 1048576
taskConcurrency

Task 同轮并发上限(kernel governance-baseline 同名同界 1..8);缺省 1 = 独占串行;涉费用放大,调大须与预算面联动评估

integer
>= 1 <= 8
quota
required
Any of:
object
dailyTokens
required
Any of:
integer
>= 1
endUserDailyTokens
required
Any of:
integer
>= 1
rpm
required
Any of:
integer
>= 1
endUserDailyImages
Any of:
integer
>= 1
endUserDailyVideoSeconds
Any of:
integer
>= 1
endUserDailyAsrSeconds
Any of:
integer
>= 1
endUserDailyTtsChars
Any of:
integer
>= 1
capabilities
required
Any of:
object
tools
required
object
read
required
boolean
write
required
boolean
edit
required
boolean
glob
required
boolean
grep
required
boolean
list
required
boolean
shell
required
boolean
process
required
boolean
webFetch
required
boolean
webSearch
required
boolean
http
required
boolean
todoWrite
required
boolean
askUser
required
boolean
agent
required
boolean
skills
required
boolean
mcp
required
boolean
customTools
required
boolean
platform
required
object
imageGen
required
boolean
videoGen
required
boolean
webSearch
required
boolean
speechToText
boolean
textToSpeech
boolean
updatedAt
required
Any of:
string
Example
{
  "app": {
    "ownership": {
      "type": "user"
    },
    "permissions": {
      "deletionRequestUnavailableReason": "org_governance_disabled"
    },
    "status": "active",
    "platform": "desktop"
  },
  "config": {
    "systemPromptPolicy": "fallback",
    "contextPolicy": {
      "overrides": {
        "pinnedPolicy": "none"
      }
    }
  }
}

400

Section titled “400”

Validation_failed(段内非法引用,detail.invalid 全列)

Media typeapplication/json
object
error
required
object
code
required

错误码注册表单源派生(src/http/errors.ts ERROR_CODES;码稳定,消费方按码翻译)

string
Allowed values: adjudicator_not_authorized admin_forbidden admin_key_invalid app_disabled app_ip_denied app_key_invalid approval_self_forbidden asr_not_configured asr_quota_exceeded auth_channel_undelivered bad_request conflict content_blocked context_window_exceeded currency_not_supported device_code_denied device_code_expired device_code_pending device_code_slow_down egress_blocked endpoint_disabled envelope_key_undelivered fence_denied forbidden idempotency_conflict idp_untrusted image_not_supported imagegen_not_configured imagegen_quota_exceeded insufficient_balance internal_error invalid_api_key license_required limit_exceeded liquidation_not_enabled model_not_authorized model_not_found nonce_replayed not_found order_state_invalid org_byok_not_available org_ceiling_exceeded otp_invalid otp_rate_limited pay_amount_mismatch pay_channel_undelivered pay_signature_invalid payload_too_large payment_required plan_apps_exceeded plan_concurrency_exceeded plan_end_users_exceeded plan_gate_unavailable plan_members_exceeded plan_required plan_tier_insufficient policy_locked pool_signing_undelivered preflight_required pricing_guard_tripped principal_required protocol_unsupported quota_exceeded rate_limited refund_not_eligible section_not_deliverable session_archived signature_invalid stream_backpressure token_expired tts_not_configured tts_quota_exceeded unauthorized upstream_connect_timeout upstream_disconnected upstream_error upstream_idle_timeout upstream_timeout upstream_total_timeout upstream_ttfb_timeout validation_failed videogen_not_configured videogen_quota_exceeded websearch_not_configured websearch_quota_exceeded
message
required
string
requestId
required
string
detail
object
Example
{
  "error": {
    "code": "adjudicator_not_authorized"
  }
}

404

Section titled “404”

Not_found

Media typeapplication/json
object
error
required
object
code
required

错误码注册表单源派生(src/http/errors.ts ERROR_CODES;码稳定,消费方按码翻译)

string
Allowed values: adjudicator_not_authorized admin_forbidden admin_key_invalid app_disabled app_ip_denied app_key_invalid approval_self_forbidden asr_not_configured asr_quota_exceeded auth_channel_undelivered bad_request conflict content_blocked context_window_exceeded currency_not_supported device_code_denied device_code_expired device_code_pending device_code_slow_down egress_blocked endpoint_disabled envelope_key_undelivered fence_denied forbidden idempotency_conflict idp_untrusted image_not_supported imagegen_not_configured imagegen_quota_exceeded insufficient_balance internal_error invalid_api_key license_required limit_exceeded liquidation_not_enabled model_not_authorized model_not_found nonce_replayed not_found order_state_invalid org_byok_not_available org_ceiling_exceeded otp_invalid otp_rate_limited pay_amount_mismatch pay_channel_undelivered pay_signature_invalid payload_too_large payment_required plan_apps_exceeded plan_concurrency_exceeded plan_end_users_exceeded plan_gate_unavailable plan_members_exceeded plan_required plan_tier_insufficient policy_locked pool_signing_undelivered preflight_required pricing_guard_tripped principal_required protocol_unsupported quota_exceeded rate_limited refund_not_eligible section_not_deliverable session_archived signature_invalid stream_backpressure token_expired tts_not_configured tts_quota_exceeded unauthorized upstream_connect_timeout upstream_disconnected upstream_error upstream_idle_timeout upstream_timeout upstream_total_timeout upstream_ttfb_timeout validation_failed videogen_not_configured videogen_quota_exceeded websearch_not_configured websearch_quota_exceeded
message
required
string
requestId
required
string
detail
object
Example
{
  "error": {
    "code": "adjudicator_not_authorized"
  }
}

409

Section titled “409”

Policy_locked(T-A17:enforced 策略包钉住的段(裁决人/上下文)覆写恒拒;detail.locked 列段名、detail.packId 携包 id)

Media typeapplication/json
object
error
required
object
code
required

错误码注册表单源派生(src/http/errors.ts ERROR_CODES;码稳定,消费方按码翻译)

string
Allowed values: adjudicator_not_authorized admin_forbidden admin_key_invalid app_disabled app_ip_denied app_key_invalid approval_self_forbidden asr_not_configured asr_quota_exceeded auth_channel_undelivered bad_request conflict content_blocked context_window_exceeded currency_not_supported device_code_denied device_code_expired device_code_pending device_code_slow_down egress_blocked endpoint_disabled envelope_key_undelivered fence_denied forbidden idempotency_conflict idp_untrusted image_not_supported imagegen_not_configured imagegen_quota_exceeded insufficient_balance internal_error invalid_api_key license_required limit_exceeded liquidation_not_enabled model_not_authorized model_not_found nonce_replayed not_found order_state_invalid org_byok_not_available org_ceiling_exceeded otp_invalid otp_rate_limited pay_amount_mismatch pay_channel_undelivered pay_signature_invalid payload_too_large payment_required plan_apps_exceeded plan_concurrency_exceeded plan_end_users_exceeded plan_gate_unavailable plan_members_exceeded plan_required plan_tier_insufficient policy_locked pool_signing_undelivered preflight_required pricing_guard_tripped principal_required protocol_unsupported quota_exceeded rate_limited refund_not_eligible section_not_deliverable session_archived signature_invalid stream_backpressure token_expired tts_not_configured tts_quota_exceeded unauthorized upstream_connect_timeout upstream_disconnected upstream_error upstream_idle_timeout upstream_timeout upstream_total_timeout upstream_ttfb_timeout validation_failed videogen_not_configured videogen_quota_exceeded websearch_not_configured websearch_quota_exceeded
message
required
string
requestId
required
string
detail
object
Example
{
  "error": {
    "code": "adjudicator_not_authorized"
  }
}