agntcy/oasf

Open Agentic Schema Framework (OASF)

定义 – OASF是一个社区驱动的开源模式系统，用于描述AI代理。它定义了一个基于JSON的数据模型（record对象），可以捕获代理的能力、技能、领域和可扩展的模块。该模式是版本化且不可变的，因此依赖特定版本的工具可以保持稳定。

重要性 – 现代AI代理生态系统（自主助手、使用工具的程序、RAG管道等）需要一种共同的语言来宣传它们能做什么并相互发现。OASF提供了这种通用语言，实现了跨服务、IDE插件和目录的互操作性。

主要组件

• 模式定义 – schema/下的JSON文件（例如record.json）以及技能和领域的分类。
• 模式服务器 – 一个HTTP服务器（server/），托管最新模式，提供用于浏览的UI，并通过REST API验证记录。
• 工具 – 使用Docker/Kind构建、测试和部署服务器的Taskfile驱动工作流。热重载支持让您可以在不重启整个堆栈的情况下迭代模式更改。
• MCP集成 – Directory MCP Server可以连接到LLM（例如Cursor），直接从代码生成、验证和转换OASF记录。

典型工作流程

1. 编写记录 – 创建一个描述代理的JSON记录，并用技能和领域进行注释。
2. 验证 – 将JSON发送到OASF服务器（/validate端点）或使用MCP服务器的LLM辅助命令。
3. 发布/发现 – 其他服务可以查询服务器以查找匹配技能或领域的记录，从而实现动态发现。

开始使用

# 克隆
https://github.com/agntcy/oasf.git 克隆并cd oasf

# 安装先决条件（Taskfile、Docker、Go、yq、curl、tar）
# 构建依赖和工件
task deps
task build

# 部署本地服务器（创建Kind集群，通过Helm安装服务）
IMAGE_TAG=latest task build:server
task up   # 然后打开 http://localhost:8080

# 用于模式更改的热重载
task reload

扩展模式 – 您可以添加私有扩展（新对象类型、额外字段）并托管自定义服务器实例。贡献指南解释了如何提议新的技能、领域或模块以及如何对它们进行版本控制。

更多信息

• 实时模式UI：https://schema.oasf.outshift.com
• AI代理技能分类：https://schema.oasf.outshift.com/skill_categories
• 协议缓冲区定义（用于生成语言SDK）：https://buf.build/agntcy/oasf
• MCP服务器集成：https://github.com/agntcy/dir/tree/main/mcp

适用人群

• 构建需要共享能力目录的自主代理群的团队。
• 提供AI代理市场的平台提供商。
• 希望获得LLM辅助代理元数据生成的IDE插件开发者。
• 标准化代理基准和可复现性的研究人员。

---

以上所有信息均直接来自仓库的README；未添加任何外部假设。