所需的文件夹结构
Osmosis 通过约定优于配置的方式自动发现组件。按照以下目录结构设置,每次git push 都会将工具、reward 函数和 rubric 同步到平台。
示例仓库可以在这里找到:https://github.com/Osmosis-AI/osmosis-git-sync-example
目录详解
mcp/ - MCP 工具目录
包含你的 Model Context Protocol 工具,用于扩展 AI 智能体的能力。
关键文件:
main.py- FastMCP 服务器的入口文件server/mcp_server.py- FastMCP 服务器配置tools/- 包含各个工具模块的目录
reward_fn/ - 奖励函数目录
包含使用 @osmosis_reward 装饰器的确定性奖励函数。
示例:
compute_reward.py- 你的奖励函数实现
reward_rubric/ - Reward Rubrics 目录
包含使用 @osmosis_rubric 装饰器的基于 LLM 的评估函数。
示例:
reward_rubric_openai.py- 使用 OpenAI 模型的 Rubricreward_rubric_anthropic.py- 使用 Anthropic 模型的 Rubric
pyproject.toml - 依赖配置
定义你的 Python 包依赖:
可选目录
你还可以包含:tests/- 组件的单元测试.github/workflows/- CI/CD 自动化docs/- 额外的文档