SuperAPI AI 工具集

agent-native

智能体与模型

查看项目

更新于 10-20 06:26

技能介绍

Agent-Native 是一个面向开发者与智能体的技能,用于构建、扩展、审查和调试基于 @agent-native/core 和 @agent-native/toolkit 的 Agent-Native 应用。其核心理念是:只构建一项能力,让人和智能体都能使用,并让校验、授权、数据与副作用保持在同一条 action 路径上。

用途 该技能适用于 Agent-Native 应用的开发全流程:新建应用、为已有应用添加功能、审查或调试既有实现。它强调在改动前先确认应用与其依赖版本,再仅加载当前任务所需的知识,最后按共享功能的各层面实现并验证行为。

主要能力

  1. 建立应用与版本基线:对已有应用,阅读其说明、包清单、锁文件、相关源码与本地技能,解析已安装的 Core 与 Toolkit 版本,区分包约束与解析后的版本;对新应用,依据官方 Getting Started 或模板指南选择起点,核实当前前置条件与 CLI 选项后再搭建脚手架,并保留生成的依赖锁定与约定。若缺少安装证据,需在回答中明确说明 API 兼容性未经验证。
  2. 按需解析知识:读取项目内相关技能(如 agent-native-docs、actions、storing-data、real-time-sync、context-awareness、agent-native-toolkit、customizing-agent-native 等,可用性因模板而异),并完整阅读选定参考资料,涵盖架构选择、Actions 与数据(定义 action、查询 SQL、变更、授权、共享 UI/智能体操作)、UI 与 Toolkit(聊天组件、控件、编辑器、协作、导航、设置、反馈及 UI 定制)、上下文与同步(导航、选择、智能体交接、过期屏幕、后台更新与重新获取抖动)以及文档查找等主题。
  3. 实现共享功能:按 UI、Action、指令、应用上下文四个适用领域推进,每个领域都有对应的完成证据要求。UI 需遵循既有应用约定并处理待定、空、失败与成功状态;Action 需让 UI 与智能体通过受支持的调用面到达同一带类型操作,并含服务端访问检查;指令需让新领域行为可通过 action 描述被发现;应用上下文需让智能体解析相关路由、记录或选择,并在需要时导航到结果。对不适用领域应说明理由,而非为每个操作虚构界面或技能。
  4. 验证行为:区分观察到的症状、疑似原因、已安装 API 证据与已执行行为;使用目标应用自身的脚本与测试,而非假定命令名;针对改动操作检查有效/无效输入、允许/拒绝调用方及相关归属或组织边界;对 UI 或上下文改动检查路由切换、选择清理、智能体交接及各入口的更新可见性;必要时测试第二个标签页或用户;检查改动交互组件的键盘与焦点行为。

使用方式 该技能以项目内技能与参考文档为指引,要求使用已安装的文档与公开类型/源码核实改动中每个非平凡 API;本地目录仅作为发现地图,不能证明目标版本中存在某导出;当来源冲突时以已安装契约为准并指出差异;不得以猜测签名替代缺失证据。实现时应保留应用自有的领域模型与工作流,在合适处采用共享 Toolkit 行为;需要工具、上下文、引导或多步骤的工作应使用 agent chat bridge;真正的文本输入/输出操作应查阅已安装组件 API 的服务端完成逃生通道,并通过 action 暴露面向用户的用法,提供商凭据保留在服务端。

适用场景 适用于需要人机共用同一能力路径的 Agent-Native 应用开发、功能扩展与代码审查,尤其是涉及共享 action、SQL 数据、智能体可见上下文、实时同步与 UI 协作的场景。

限制 资料强调安装证据缺失时 API 兼容性无法验证,本地文档目录不构成导出存在的证明;带模拟上下文或传输的处理程序测试不能验证框架分发、会话传播、聊天流式传输或浏览器同步;文档示例或拟议测试不等于已执行的集成测试。资料未提供具体收费、价格、支持平台或效果数据。