
从零到工单路由TypeSafe Agent Skills让AI做第一个可程序化决策的实战教程【免费下载链接】skillsAgent skills for building with TypeSafes System One API项目地址: https://gitcode.com/gh_mirrors/skills60/skillsTypeSafe Agent Skills 是一个为 AI 编程智能体Agent准备的能力技能包让 Claude Code 等 Agent 开箱即用地调用 TypeSafe 的 System One API把自然语言和应用状态转换成类型化判断typed judgments与概率让代码可以直接消费 AI 的结论。本文以客服工单按部门路由为实战场景带你从零安装这个 Agent 技能并理解如何把 AI 变成系统里第一个可程序化决策的节点。 TypeSafe Agent Skills 是什么把AI判断变成编程原语传统做法里LLM 输出的是文本你的代码还要再解析一遍才知道它说了什么——解析失败、格式漂移都是坑。TypeSafe 的System One 模型旗舰模型为Jev换了一种思路它不生成自由文本而是返回带类型的答案和概率。比如这张工单属于技术支持不是一个字符串而是一个可以比较、可以设阈值、可以和规则代码组合的结构化判断。一句话概括它的设计哲学代码拥有工作流模型提供可编程的常识programmable common sense。它适合出现在这些地方场景说明路由Routing请求来了选一个处理分支比如把工单分给对应部门排序Ranking对候选结果打分排序抽取Extraction从文本里挑出结构化信息校验Verification检查声明与证据是否一致不确定时升级人工技能的完整定义见 skills/typesafe-ai/SKILL.md它是 Agent 的操作手册。 两步安装教程让你的 Agent 获得 TypeSafe 技能方式一Claude Code 插件在终端执行claude plugin marketplace add typesafe-ai/skills claude plugin install typesafetypesafe-ai方式二其他 Agent通过 skills.sh 安装npx skills add typesafe-ai/skills --skill typesafe-ai按提示选择你的 Agent 即可。默认安装到当前项目project-local加-g可全局安装。安装后在 Claude Code 中可以用/typesafe:typesafe-ai显式调用该技能。 实战用AI工单路由实现第一个可程序化决策想象一个客服系统新工单进来希望 AI 先判断它该去哪个部门。你可以直接对 Agent 下这样一条指令来自项目 README.md 的官方示例Use TypeSafe to route incoming support tickets by department, with human review for uncertain decisions. 用 TypeSafe 按部门路由传入的支持工单不确定的决策交人工复核。这句话里藏着 System One 的三个关键概念State状态给模型足够的上下文——工单正文、客户身份、部门定义、路由规则。上下文有多部分时推荐用带名字的 JSON 字段引用嵌套字段可用反引号路径如ticket.messages[0].text。Choice 原语路由是从定义好的集合中选一个对应 TypeSafe 的 Choice 判断。它会同时给出竞争选项的概率分布——这正是做路由最需要的信息。Confidence置信度每个判断附带概率与置信度。高置信 → 自动路由低置信 → 转人工复核。阈值不该拍脑袋要拿你自己的数据和业务后果去评估。这样做的好处是可程序化AI 的判断是类型化的你的代码可以放心地写if 概率 阈值: 自动路由 else: 进人工队列而不是去解析一段随时可能变形的自然语言。 三种判断原语怎么选Choice、Noul 与 ScoreSKILL.md 按答案的含义给出了选型表这是新手最实用的速查你的需求原语关键区别从一个定义好的集合里选一个Choice选一个选项其概率分布用于比较竞争选项某个条件是否成立Noul返回是的概率无单独置信度多个条件可能同时成立时每个单独建一个沿某个维度评估程度Score在有序等级上的概率加权位置适合分级排序另外两条实战建议一问一判断每个问题只问一个窄而连贯的判断独立有用的维度拆开问。独立的多个问题可以放在一起并行跑。留好不匹配出口当没有任何选项合适时把无匹配也作为候选结果之一。 仓库关键文件路径清单这个仓库很轻核心内容一眼就能看完README.md安装方式与技能用途总览skills/typesafe-ai/SKILL.md技能主文件教 Agent 阅读 TypeSafe 实时文档、设计判断、组合与验证结果——其中先读实时文档再动手是它的核心工作方式LICENSEMIT 开源协议可自由商用如需本地浏览完整源码可执行git clone https://gitcode.com/gh_mirrors/skills60/skills✅ 小结TypeSafe Agent Skills 把AI 决策从一段需要解析的文本变成了代码可直接消费的类型化判断和概率。从安装到工单路由你只需要三步装技能、描述业务目标、用概率与置信度决定自动执行还是人工复核。这就是让 AI 成为系统第一个可程序化决策节点的最小路径也是后续做排序、抽取、校验等更多模式的地基。【免费下载链接】skillsAgent skills for building with TypeSafes System One API项目地址: https://gitcode.com/gh_mirrors/skills60/skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考