从一句话，看见理解固定示例 · 不调用模型
01 / 用户所说
查询订单000123，不要取消订单
保留用户要做的事，也保留明确的禁止事项。
本例已配置订单号 Schema，并通过 fields 选择 orderId。
参数与条件禁止事项正向要求
查看本例的输入配置
调用方提供这些材料；固定示例不在浏览器调用模型。
02 / 结构化理解 · 摘要
理解完整- 查询订单000123
intent-2- 禁止不要取消订单
- orderId
- "000123"
fieldResults / 本轮字段
orderId已验证完整意图只保留在 effective；摘要不替代完整响应。
查看完整 JSON
从一次调用开始
一个模型，一次调用。
接入你的模型，调用 parse，再读取目标与约束。需要业务参数时，再添加 Schema。
intent.js
import { Intent, IntentError } from '@devcodex/intent-runtime';
import { createApiExecutor } from '@devcodex/intent-runtime/adapters/api';
const apiKey = process.env.INTENT_API_KEY;
const model = process.env.INTENT_MODEL;
if (!apiKey || !model)
throw new Error('Set INTENT_API_KEY and INTENT_MODEL.');
const intent = new Intent({
language: 'zh-CN',
executor: createApiExecutor({ provider: 'openai', apiKey, model }),
});
const request = { input: '查询订单000123，不取消订单' };
try {
const result = await intent.parse(request);
console.log(JSON.stringify(result, null, 2));
console.log('目标：', result.effective.intents.map(node => node.goal));
console.log('需要澄清：', result.issues.map(issue => issue.message));
}
catch (error) {
if (!(error instanceof IntentError))
throw error;
console.error(JSON.stringify(error.toJSON()));
process.exitCode = 1;
}
finally {
await intent.dispose();
}import {Intent, IntentError, type IntentParseRequest} from '@devcodex/intent-runtime';
import {createApiExecutor} from '@devcodex/intent-runtime/adapters/api';
const apiKey = process.env.INTENT_API_KEY;
const model = process.env.INTENT_MODEL;
if (!apiKey || !model) throw new Error('Set INTENT_API_KEY and INTENT_MODEL.');
const intent = new Intent({
language: 'zh-CN',
executor: createApiExecutor({provider: 'openai', apiKey, model}),
});
const request: IntentParseRequest = {input: '查询订单000123，不取消订单'};
try {
const result = await intent.parse(request);
console.log(JSON.stringify(result, null, 2));
console.log('目标：', result.effective.intents.map(node => node.goal));
console.log('需要澄清：', result.issues.map(issue => issue.message));
} catch (error) {
if (!(error instanceof IntentError)) throw error;
console.error(JSON.stringify(error.toJSON()));
process.exitCode = 1;
} finally {
await intent.dispose();
}先设置模型名称和 API Key。JS 项目设置 type: module，TS 按 ESM 编译；模型与网关均可自定义。
沿用你的工作方式
接到你已有的应用里。
应用调用、当前宿主模型、独立服务或已有 MCP Server，选择与你的工程对应的一条路径。
Intent Runtime 只理解你提供的材料。消息与历史由你提供，工具、授权和业务执行由应用管理。