快速开始

5 分钟上手指南

本指南将带你快速了解 AgentHR 的核心功能和使用流程。

1. 浏览 Agent 目录

访问 Agent 目录，你可以通过以下维度筛选 Agent：

• 角色 — 按岗位分类（如 Coding、Research & Analysis、Documentation 等）
• 行业 — 按行业分类（如 Finance、Healthcare、Manufacturing 等）
• 工具 — 按使用的工具平台（如 Cursor、Coze、MCP 等）
• 风险等级 — 按 R0-R4 风险等级筛选

点击任意 Agent 卡片进入详情页，查看其完整能力描述、风险等级和工具链。

2. 搜索 Agent

在目录页面使用搜索框输入关键词，支持按名称、描述和标签进行模糊搜索。

你也可以直接调用搜索 API：

GET /api/v1/agents/search?q=data&role=data-analyst&page=1&limit=20

详见 API 文档。

3. 上传 Agent 包

准备好你的 Agent 包后，访问 提交页面 上传：

1. 按照 Agent Package 规范 准备包文件
2. 确保包含必填文件：agent.yaml、README.md、system_prompt.md、risk_card.md
3. 上传 zip 包（最大 5 MB）
4. 系统自动校验包结构和元数据

详细的提交指南见 上传指南。

4. 审核流程

Agent 提交后进入审核流程：

1. 自动校验 — 系统检查包结构、必填字段、风险等级标注
2. 人工审核 — 审核员检查内容质量、安全性和合规性
3. 上架/驳回 — 通过后上架目录，驳回时附带修改建议

审核标准见 风险等级体系 中的审核要求。

5. Mock Checkout

在 pre-cloud 阶段，checkout 流程为模拟演示：

1. 在 Agent 详情页点击"获取 Agent"或"购买"按钮
2. 进入 mock checkout 页面，确认订单信息
3. 选择支付方式（mock 支付宝沙箱）
4. 完成模拟支付，获得下载授权

注意：当前版本不涉及真实资金交易。所有支付为 mock 模拟。

6. 获取 API Key

调用 AgentHR API 需要 API Key：

1. 访问 API 密钥页面
2. 复制 Demo Runtime Key：aghr_mock_demo_key
3. 在请求头中携带：Authorization: Bearer aghr_mock_demo_key

Demo key 始终可用，无需数据库 seed。完整 API 文档见 开发者文档。

7. 查看用量

访问 用量页面 查看 API 调用统计：

• 总调用次数、成功/失败次数
• 最近调用记录（时间、Agent、状态、费用）
• 余额和月度配额

用量数据在 pre-cloud 阶段为 mock 演示数据。

下一步

• 阅读 什么是 AgentHR 了解完整的产品定位
• 查看 风险等级体系 了解 Agent 安全分级
• 参考 Agent Package 规范 准备你自己的 Agent