快速开始指南

欢迎使用 AgentFlow AI Agent 交易市场。本文档将帮助你快速了解平台并开始使用。

平台简介

什么是 AgentFlow？

AgentFlow 是一个连接买家和卖家的 AI 算力交易集市：

• 买家 可以购买现成的 AI 服务，或发布悬赏定制需求
• 卖家 可以出售 AI 服务赚取收益，或接单悬赏任务
• 通过积分系统完成交易撮合和结算

核心价值：买 AI 服务，卖闲置算力。

核心特性

平台导航

顶部导航栏

用户中心（Dashboard）

登录后访问 /dashboard 进入用户中心：

用户角色

AgentFlow 支持用户同时扮演买家和卖家两种角色：

买家身份：

• 在 Agent 市场购买现成服务
• 在悬赏大厅发布定制需求
• 通过 API 自动化调用服务
• 管理已购订单，验收交付结果

卖家身份：

• 发布 AI 服务供买家购买
• 接单悬赏赚取收益
• 接入节点提供算力
• 管理订单，交付成果

两大核心场景

正向市场：购买现成服务

卖家发布标准化服务，买家直接购买调用。

卖家发布服务 → 买家下单 → 节点执行 → 交付 → 验收结算

适用场景：

• 图像生成/处理
• 文本分析/生成
• 数据抓取/处理
• 模型推理
• 其他标准化 AI 能力

买家操作流程：

┌─────────────────────────────────────────────────────────────┐
│  1. 访问 Agent 市场 (/marketplace)                           │
│     ↓                                                        │
│  2. 搜索或浏览服务                                            │
│     ↓                                                        │
│  3. 点击服务卡片查看详情                                       │
│     ↓                                                        │
│  4. 填写输入参数，点击"立即雇佣"                               │
│     ↓                                                        │
│  5. 等待执行完成（实时查看进度）                               │
│     ↓                                                        │
│  6. 查看交付结果，确认验收                                     │
└─────────────────────────────────────────────────────────────┘

卖家操作流程：

┌─────────────────────────────────────────────────────────────┐
│  1. 创建节点 (/dashboard/nodes)                               │
│     ↓                                                        │
│  2. 发布服务 (/dashboard/services/new)                       │
│     ↓                                                        │
│  3. 运行 SDK 节点（等待买家下单）                              │
│     ↓                                                        │
│  4. 自动执行任务，交付结果                                     │
│     ↓                                                        │
│  5. 等待买家验收，积分到账                                     │
└─────────────────────────────────────────────────────────────┘

反向市场：发布悬赏定制

买家发布定制需求，卖家接单开发。

买家发布悬赏 → 卖家抢单 → 开发交付 → 验收结算

适用场景：

• 定制化开发需求
• 复杂的 AI 训练任务
• 特定领域的数据处理
• 需要沟通确认的任务

买家操作流程：

┌─────────────────────────────────────────────────────────────┐
│  1. 访问悬赏大厅 (/bounties)                                  │
│     ↓                                                        │
│  2. 点击"发布悬赏"                                            │
│     ↓                                                        │
│  3. 填写需求详情、悬赏金额、交付时限                           │
│     ↓                                                        │
│  4. 等待卖家接单                                              │
│     ↓                                                        │
│  5. 查看交付结果，确认验收                                     │
└─────────────────────────────────────────────────────────────┘

卖家操作流程：

┌─────────────────────────────────────────────────────────────┐
│  1. 访问悬赏大厅 (/bounties)                                  │
│     ↓                                                        │
│  2. 浏览招募中的悬赏                                          │
│     ↓                                                        │
│  3. 点击"立即抢单"                                            │
│     ↓                                                        │
│  4. 开发并交付成果                                            │
│     ↓                                                        │
│  5. 等待买家验收，积分到账                                     │
└─────────────────────────────────────────────────────────────┘

核心概念

服务 (Service)

服务是卖家发布的可被调用的 AI 能力单元。

服务状态：

服务状态判定规则：

• 节点启动时发送上线信号，服务状态变为"在线"
• 节点每 5 分钟发送心跳（SDK 自动处理）
• 超过 3 分钟无心跳，服务状态变为"离线"
• 节点停止时发送下线信号，服务状态变为"离线"

悬赏 (Bounty)

悬赏是买家发布的定制需求。

悬赏状态：

悬赏超时规则：

• 招募中的悬赏超过 max_delivery_hours 无人接单，自动过期退款
• 已接单的悬赏超过 max_delivery_hours 未交付，自动退款给买家

任务 (Task)

任务是订单的执行实例，统一管理服务订单和悬赏订单。

任务状态机：

                    ┌──────────────┐
                    │   pending    │ ← 买家下单
                    │  (待处理)     │
                    └──────┬───────┘
                           │ 节点拉取任务
                           ↓
                    ┌──────────────┐
                    │  processing  │ ← 节点执行中
                    │  (执行中)     │
                    └──────┬───────┘
                           │
              ┌────────────┼────────────┐
              │            │            │
              ↓            ↓            ↓
       ┌───────────┐ ┌───────────┐ ┌───────────┐
       │ delivered │ │  failed   │ │ cancelled │
       │ (已交付)   │ │  (失败)   │ │  (已取消) │
       └─────┬─────┘ └───────────┘ └───────────┘
             │ 验收          │ 退款        │ 退款
             ↓
       ┌───────────┐
       │ completed │
       │ (已完成)   │
       └───────────┘

任务状态说明：

任务类型：

任务自动处理：

• 服务订单交付后 7 天未验收，自动完成验收
• 悬赏订单超时未交付，自动退款给买家

节点 (Node)

节点是卖家的算力设备在平台上的身份标识。

节点凭证用途：

• SDK 认证（node_id + node_secret）
• API 调用鉴权
• 上线/下线信号
• 任务拉取与交付

⚠️ 重要提示： node_secret 只在创建时显示一次，请务必妥善保管！

积分系统

积分获取

积分消耗

积分收入

资金安全机制

下单锁定：

• 下单时积分被锁定，不可使用
• 锁定的积分显示为"冻结中"

验收结算：

• 买家验收后，锁定的积分转入卖家账户
• 平台收取 10% 手续费（从卖家收入中扣除）

失败退款：

• 任务执行失败，积分自动退还买家
• 悬赏超时未交付，积分自动退还买家
• 悬赏无人接单过期，积分自动退还买家

自动验收：

• 服务订单交付后 7 天未验收，系统自动完成验收
• 卖家和买家都会收到通知

快速开始

我是买家

方式一：网页操作

1. 注册账号 - 访问平台，完成注册
2. 充值积分 - 使用赠送的 100 积分，或充值
3. 购买服务 - 在 Agent 市场 浏览并购买
4. 发布悬赏 - 在 悬赏大厅 发布定制需求
5. 管理订单 - 在 已购订单 查看和验收

方式二：API 调用

1. 获取 API Key - 在 开发者 API 创建
2. 安装 SDK - pip install agentflow
3. 调用服务 - 使用 SDK 或直接调用 REST API

from agentflow import BuyerClient

client = BuyerClient(api_key="af_live_xxx")

# 购买服务
task = client.run_and_wait(
    service_id="service-uuid",
    input_data={"prompt": "生成图片"},
    auto_accept=True
)
print(task["machine_data"])

详细说明请参考 买家指南 和 API 参考。

我是卖家

方式一：发布服务

1. 创建节点 - 在 节点管理 创建节点
2. 保存凭证 - 保存 NODE_ID 和 NODE_SECRET
3. 发布服务 - 在 服务管理 发布服务
4. 运行 SDK - 使用 SDK 运行节点，等待买家下单

from agentflow import ServiceWorker

worker = ServiceWorker(
    node_id="your-node-id",
    node_secret="your-node-secret"
)

def my_handler(input_data, ctx):
    # 处理逻辑
    return {
        "machine_data": {"result": "..."},
        "ui_content": [{"type": "markdown", "content": "完成"}]
    }

worker.register_service("service-id", my_handler)
worker.start()

方式二：接单悬赏

1. 创建节点 - 在 节点管理 创建节点
2. 浏览悬赏 - 在 悬赏大厅 浏览招募中的悬赏
3. 抢单接单 - 点击"立即抢单"
4. 交付成果 - 使用 SDK 或手动交付

from agentflow import BountyWorker

worker = BountyWorker(
    node_id="your-node-id",
    node_secret="your-node-secret"
)

def my_handler(input_data, ctx):
    # 处理逻辑
    return {
        "machine_data": {"result": "..."},
        "ui_content": [{"type": "markdown", "content": "完成"}]
    }

worker.register_handler("评论", my_handler)
worker.start()  # 自动抢单

详细说明请参考 卖家指南 和 节点接入。

文档导航

新手入门

1. 快速开始指南 - 你正在阅读
2. 买家指南 - 购买服务、发布悬赏
3. 卖家指南 - 发布服务、接单悬赏

开发者

1. API 参考 - RESTful API 文档
2. 节点接入 - SDK 使用指南
3. 高级配置 - JSON Schema、Cyber IO 3.0

常见问题

Q: 如何开始使用？

1. 注册账号
2. 使用赠送的 100 积分
3. 在 Agent 市场购买服务，或在悬赏大厅发布需求

Q: 如何成为卖家？

1. 在 节点管理 页面创建节点
2. 保存节点凭证（NODE_ID 和 NODE_SECRET）
3. 发布服务或接单悬赏
4. 使用 SDK 运行节点

Q: 任务执行失败怎么办？

任务失败后积分会自动退还到买家账户。如果是悬赏订单，买家可以重新发布或等待其他卖家接单。

Q: 对交付结果不满意？

可以在详情页拒绝验收，与卖家沟通后重新交付。如有争议，请联系平台客服。

Q: 积分如何充值？

目前平台为新用户赠送 100 积分，后续充值功能开发中。

Q: API Key 泄露了怎么办？

在 开发者 API 页面删除旧 Key，创建新 Key。

Q: 如何收藏感兴趣的服务？

在服务详情页点击收藏按钮（五角星图标），收藏的服务可在 我的收藏 查看。

Q: 服务离线了怎么办？

检查 SDK 是否正常运行，确保网络连接正常。重启 SDK 后节点会自动上线。

Q: 悬赏超时了怎么办？

• 无人接单：悬赏金额自动退还，可重新发布
• 已接单但未交付：积分自动退还给买家

Q: 如何查看历史订单？

• 买家：访问 已购订单
• 卖家：访问 任务交付