ANX 协议 4 类标准形式与关键特征
ANX 协议采用一核多体、各司其职、相互配合的设计思路,转为AI Agent理解与执行优化,并非只使用单一结构。其中 ANX Config 形式为协议核心,承载最完整的结构定义与配置信息,是构建 ANX 应用、SOP、小程序等场景的基础与关键。
围绕这一核心,协议延伸出四类标准形式,分别面向不同环节协同工作:CLI 形式负责运行时指令执行,Config 形式负责应用与流程配置,Markdown 块形式用于人与 Agent 对话中的可视化交互,Card 节点形式则用于向 AI 清晰呈现应用当前状态与页面结构。
多形式设计的目的,是让协议在构建配置、运行执行、可视化对话、AI 理解等全流程中都能自然适配、各司其职,既保证底层逻辑统一,又能在不同场景下高效可用。
以下为 ANX 协议 4 类标准形式与关键特征。
1、ANX Config 形式
用于 AI 原生应用、SOP、小程序的配置描述。
在 JSON 结构中,kind、kinds 或 autoSet 是 ANX 配置的关键字段,常见于 ANX APP、SOP 等场景,使用格式如下:
// Markdown 中出现以下结构,表示定义了一个 form 配置,需要进行可视化渲染
{
"kind": "form",
"kinds": [],
"autoSet": {}
}
协议标准与完整用法,以 ANX 协议官方开源仓库为准:
https://github.com/mountorc/anx-protocol
2、ANX Markdown 块形式
用于在 Markdown 中进行模块声明、渲染展示与可视化交互。
在 Markdown 里,通过 :::anx 声明一个 ANX 可视化块,由 Marked-ANX 负责解析、渲染与交互,使用格式如下:
// Markdown 中出现以下结构,表示定义了一个 form 配置,需要进行可视化渲染
:::anx
{
"kind": "form"
}
:::
开源项目 marked-anx 插件已完整实现 :::anx 的解析与可视化渲染逻辑,详细说明与源码:
https://github.com/mountorc/marked-anx
3、ANX Card 节点形式
用于在任意文本中标记可交互节点,标识一个 ANX 执行单元。
在 Markdown 或页面中,<x> 是 ANX 标签的标志性标记,出现 <x> 即代表使用 ANX 协议声明节点结构。
同时,cardKey 字段是 ANX 节点的重要标准,也是区分 ANX Config 与 ANX Card 的关键标识。
使用格式如下:
// Markdown 中基础结构
<x kind cardKey>
内容区域
</x>
// 示例:一个 kind 为 form、cardKey 为 card_1234 的表单节点
<x form card_1234>
表单区域
</x>
4、ANX CLI 形式
用于在 ANX 应用运行环境中执行命令、进行交互控制。
在生产与执行环境中,以 anx 开头的命令即为 ANX CLI 命令,遵循 ANX 协议 CLI 命令集定义,使用格式如下:
// 通用格式
anx <cardKey> <action> params
// 示例:获取指定 card 的表单信息
anx card_1234 get_form
// 示例:为指定 card 的表单写入数据
anx card_1234 set_form '{"username":"kevin"}'
ANX CLI 命令集以 anx-protocol 开源仓库中的 CLI 模块定义为准;anx-core 项目已集成 ANX CLI 命令的解析与执行模块:
- https://github.com/mountorc/anx-protocol
- https://github.com/mountorc/anx-core
随着 ANX 协议的持续普及,希望能帮助你更好地在相关场景中协作,或主动使用 ANX 协议更高效地完成任务。
更多形式与场景化能力正在持续迭代中,欢迎关注与共建,感谢您的支持!
ANX协议官方开源地址:https://github.com/mountorc/anx-protocol
更多推荐
所有评论(0)