跳转到主要内容

所需的文件夹结构

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 模型的 Rubric
  • reward_rubric_anthropic.py - 使用 Anthropic 模型的 Rubric

pyproject.toml - 依赖配置

定义你的 Python 包依赖:
[project]
name = "my-osmosis-repo"
version = "0.1.0"
requires-python = ">=3.10"
dependencies = [
    "osmosis-ai>=0.2.13",
    "fastmcp>=0.1.0",
]

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

可选目录

你还可以包含:
  • tests/ - 组件的单元测试
  • .github/workflows/ - CI/CD 自动化
  • docs/ - 额外的文档

下一步