SuperAPI AI 工具集

agentic-ui-contract

智能体与模型

查看项目

更新于 10-16 08:05

技能介绍

用途:在构建或重构面向智能体(agentic)产品行为时使用该契约,让模型负责意图与决策,工具负责确定性执行,UI schema 负责受约束的渲染。

主要能力与架构:分为四层——规划层(LLM,负责意图理解、工具选择与排序)、工具层(确定性,负责类型化副作用与数据读取)、UI 契约层(类型化区块,受约束的渲染目录)、控制层(鉴权、护栏、追踪、评估、回退)。

规则:不允许模型直接写入持久化存储;不信任模型生成的指标,指标须确定性计算;工具接口应保持“深”(少而有用),避免工具碎片化;UI 区块须严格且可版本化;规划失败应视为可恢复,回退到确定性行为。

实现流程:先定义类型化区块 schema,再定义深层工具面,然后实现服务端规划器工具循环,客户端保持轻量(发送消息、渲染区块、应用客户端动作),在扩大范围前加入追踪与评估夹具。

就绪检查:工具参数经 schema 校验;工具输出确定且结构化;规划器不能绕过工具做数据声明;UI 只渲染白名单区块类型;每轮有规划器与工具追踪;存在确定性回退路径。

反模式:以正则解析器作为主要智能层;模型直接组合任意 UI 标记或组件;工具过度碎片化以镜像内部实现;允许模型叙述替代数据工具调用;缺少针对提示与工具回归的评估框架。

限制:资料未提供具体安装命令、代码示例、收费或平台信息。