配置参考

第一次调用使用快速开始的最少配置即可。本页供需要选择默认输出、规则、容量或取消行为时查表;字段规则的完整支持范围见Schema参考。

new Intent(config) 创建实例并快照配置。改变规则时创建新实例;之后修改原配置对象不会更新已创建的实例。模型执行器保留调用方服务对象的连接状态,库不关闭共享服务。

按任务查配置

你要做什么需要配置完整入口
首次识别目标与约束executor,可选 language快速开始
提取订单编号schema,加请求 fields订单字段
带上前轮材料请求 context/baseline,不是新增实例会话配置多轮指南
复用 Codex 当前模型host 配置,无需 executorCodex
详细证据、建议或语义标签defaultOutput/output,扩展需 extensionSchema输出选项

保持默认 limits 与 timeoutMs 即可开始;它们不是首次接入必填项,也不替代宿主自己的连接配置。

IntentConfig

路径类型 / 必填默认用途与规则
languagestring / 否en解释文字的BCP 47语言标签;不翻译代码、编号或配置的动作标识
executorModelExecutor / Native与executor模式需要无显式模型来源;host不调用它,无默认供应商
schemaIntentSchema / 选择业务字段时需要无schema-dsl@3.0.4 Builder或支持的JSON Schema
extensionSchemaIntentSchema / 否无意图附加语义标签;顶层名不能与schema业务参数重名
semanticsBusinessSemantics / 否无领域、术语、动作与正反例;不表示执行能力清单
timeoutMs非负安全整数 / 否00不加识别期限;正值含模型、校验、host等待,最大2147483647ms
defaultOutputIntentOutputOptions / 否各项false请求output按键覆盖,不替换整个默认对象
limitsPartial<IntentLimits> / 否见下表容量/工作限制,均为正安全整数,不由MCP参数改变

配置与标准请求参数拒绝未知键,Context内部自由命名。Native可选顶层属性为undefined按省略;Context内部undefined不是JSON。无效配置通常在构造时抛错,见错误参考。

semantics

本节行名相对 semantics,例如 terms[].name 的完整路径为 semantics.terms[].name。

路径类型 / 必填规则
domainstring / 否领域名称
descriptionstring / 否业务说明
terms数组 / 否每项name、meaning非空;aliases为可选字符串数组
actions数组 / 否每项name、meaning非空;examples/counterExamples为可选字符串数组
完整嵌套路径类型 / 必填缺省用途
semantics.terms[].name非空 string / 是无术语名
semantics.terms[].meaning非空 string / 是无术语的业务含义
semantics.terms[].aliasesstring[] / 否省略对应别名,不新增用户事实
semantics.actions[].name非空 string / 是无明确匹配时保留的动作标识
semantics.actions[].meaning非空 string / 是无动作含义
semantics.actions[].examplesstring[] / 否省略正例
semantics.actions[].counterExamplesstring[] / 否省略反例,帮助区分容易混淆的动作

同名含义冲突报CONFIG_INVALID。明确匹配的domain/action保留配置名称,不随输出语言翻译。定义帮助理解,不把未支持动作删除或把示例当用户事实。

输出选项

下表行名相对 defaultOutput 或请求 output,例如 defaultOutput.evidence、request.output.evidence。未指定时合并实例默认值。

路径类型 / 默认开启后关闭后
suggestionsboolean / false语义澄清/完善建议,无建议为[]不生成该附加部分
evidenceboolean / false详细来源,无证据为[]必要来源、issues、inferences仍保留
diagnosticsboolean / falsedurationMs/modelCallCount不返回诊断部分
extensionsboolean / false按extensionSchema提取全部扩展顶层字段不提取新标签;仍处理旧扩展失效

defaultOutput: {evidence:true} 加 output:{} 仍开启证据;output:{evidence:false} 明确关闭。开启extensions却没有extensionSchema报SCHEMA_NOT_CONFIGURED;扩展不能绕过fields提取操作参数。

limits

下表行名均相对 limits,例如完整路径 limits.maxValidationChecks。省略对象或其中某项均使用对应默认值。

路径默认统计范围
maxInputBytes65536原input的UTF-8字节
maxContextBytes1048576Context JSON
maxBaselineBytes1048576baseline JSON
maxSchemaBytes262144每份业务/扩展Schema
maxRequestBytes3145728静态材料与完整逻辑请求,不能仅分别检查各部分
maxOutputBytes1048576候选文本、HostTask、最终结果各自检查
maxDepth64JSON根容器深度0
maxConcurrentParses8单个Intent的Native/host活动识别和未结束底层调用
maxValidationChecks256单次识别业务校验调用数;host纠正不重置

超限报RESOURCE_LIMIT,不静默截断。预算不等于会话过期。取消不配合的外部执行器可先返回,但名额在其实际结束后才释放。库不保证终止调用方任意代码或退还模型费用。

其他公开配置

  • 模型API:ApiExecutorConfig、地址、格式、响应体字节限制。
  • MCP:IntentMcpAdapterConfig、独立服务配置、实例选择、前缀和协议。
  • Codex与维护命令:可信文件、环境路径、CLI参数及退出码。

完整类型见类型参考。