@happyvertical/smrt-playbooks (欢快的垂直/游戏本)
有分层的游戏本定义、房客意识的超标和 特工们.
游戏本是一款被命名的,描述的由代理人所遵循的步骤序列. 它给了一个 多步骤意图——"检查出这辆车"——一个既非习惯的家 模式动作或视图意图,浏览器代理、程序内代理、节点MCP 服务器,并且 CLI 都遵循同样的解析计划.
安装
pnpm add @happyvertical/smrt-playbooks
快开始
import { definePlaybook, resolvePlaybook } from '@happyvertical/smrt-playbooks';
// 1. Register a playbook's defaults at startup
definePlaybook({
key: 'commerce.cart.checkout',
title: 'Check out this cart',
description: 'Submits the order and captures payment.',
steps: [
{
kind: 'operation',
model: '@happyvertical/smrt-commerce:Order',
action: 'submit',
},
{
kind: 'operation',
model: '@happyvertical/smrt-commerce:Payment',
action: 'capture',
},
],
onStepFailure: 'abort',
});
// 2. Resolve a plan for a caller on a plane
const resolution = await resolvePlaybook('commerce.cart.checkout', {
db,
plane: 'server',
});
if (!resolution.ok) {
// Fails closed with a specific reason: unknown-playbook, disabled,
// plane-not-declared, intent-registry-unavailable, unknown-intent.
throw new Error(resolution.message);
}
for (const step of resolution.plan.steps) {
// The agent executes each step itself; this package never does.
// step.classification is inherited from the referenced operation.
}
这个软件包提供了什么
definePlaybook()——全球进程中代码第一游戏本注册 注册,所以一个包船 自己的游戏本resolvePlaybook()分层分辨率:代码默认 = 配置覆盖 = 存储的应用程序覆盖 – 存储的租户覆盖 – 运行时间覆盖PlaybookOverride- CRUD 应用级和租户级游戏手册模式 设置, 存储于_smrt_playbook_overrides- 飞机有效性 - 游戏手册声明
browser, (中文(简体) ),server,或两者兼有,以及 未宣布的平面解析失败 - TTL 缓存 键
(key, tenantId),在覆盖保存/删除时无效
保证
- 剧本是剧本,从来不是电话. 解析返回计划; 无 这里执行一个步骤。 因此,游戏本绝不是当局的界限 每个步骤在运行时都会独立授权.
- 步骤列表永远无法编辑 . 无覆盖层,包括直接 模型写作,可以改变游戏本的步法. 一个特工描述它是什么 总是跟它接下来的步调相符.
- 启用只收缩 . 租户可以禁用游戏本;它永远不会 启用一个下层.
- 未申报分类失败 改为
{ effect: 'destructive', idempotent: false, openWorld: true }步骤永远不会 分类本身; 分类继承自引用 操作.
文档
- 见
AGENTS.md用于软件包内部模式 - 见
docs/content/standards.md页:1 b. 单一权利公约 - 参见:
@happyvertical/smrt-prompts(层层覆盖) 模式此包镜像,@happyvertical/smrt-languages, (中文(简体) ),@happyvertical/smrt-features