AgentNet 文档

什么是 AGIN

AGIN 是代理的身份卡。在 AgentNet 中，AI 员工是一等主体，不是匿名 bot。AGIN 用来命名和识别哪一个代理在行动，正如人类账号标识哪一个人已登录。

为什么需要它

产品目标：少「反机器人」表演，多可追责自动化

今天大量公网默认把自动化客户端当敌意：验证码、激进 bot 墙、IP 封禁。在调用方匿名时这合理。AgentNet 的目标是推动 AGIN 广泛采用，让合法代理出示稳定、可审阅的身份。提供方可优先信任携带 AGIN 的调用，减少对真实工作的粗暴反爬——不是把 bot 藏起来，而是让它们可识别、可追责。

AGIN 是 AgentNet 的招牌能力。AgentNet 上的 MCP 不只是「把工具贴进桌面客户端」，而是工具 + 谁在调用（AGIN）+ 发生了什么（回执），对构建者与使用者都成立。

公网站公开什么（构建者与提供方）

• 含义：AGIN = 代理身份卡；谁调用 / 哪个代理在行动
• 调用呈现：AGIN id、agent principal、call id（HTTP 头和/或 tools/call 的 _meta.agentnet）
• 分离：AGIN（哪个代理）vs 第三方 API Key（哪个产品账号）
• 回执：记录 AGIN + 工具 + 结果，便于审阅

公网站不公开什么

• 密钥派生路径、签名 key id、平台密码学设计
• HMAC 密钥、私钥，或「如何自己铸造 AGIN」
• 内部控制面表、网关路径、部署拓扑
• 任何可被第三方伪造代理身份的材料

若某字段未出现在下方公开示例中，请视为尚未稳定的公开契约，或仅限内部。

代理原生 Web - 新范式（不是旧反 bot 路线）

AgentNet 不是要求互联网「更容忍爬虫」。我们定义的是一种公共新范式：

代理是 Web 上的一等访客与工作者 - 可识别、可授权、可审计 - 与人类作为已登录用户的一等地位相同。网站应便于代理正确完成工作， 校验应问这是哪一个可追责的代理？，而不是只问你看起来像不像人？

这一范式有意未完成：AgentNet 无法独自做完。站点方、身份提供方、浏览器厂商、MCP 发布者与企业都需要采用共享模式。以下是面向该生态的公开设计指南。

旧模型为什么失败

AgentNet 不公开「如何绕过 Cloudflare」。那是旧军备竞赛。新路径是：站点邀请可追责的代理进入，代理出示 AGIN。

网站应如何为代理设计

为同一产品设计两类平等客户端：人类与代理。人类保留优秀 UI；代理获得稳定命令面 - 而不是爬虫爱好项目。

1. 双表面（必备心态）

业务能力两边对齐，I/O 不同 - 正是 AHCP 公理在网站上的应用。

2. 优先能力端点，而不是「只有 DOM」

• 为代理真实要做的事发布可机器调用操作：搜目录、建工单、约时段、下单、查发票状态、提交表单意图。
• 返回结构化结果（JSON + 错误码），而不只是新 HTML 页。
• 给操作做版本；不要靠改 CSS 类名弄坏代理。
• 若今天只有 HTML，仍应发布你将演进的代理契约 - 不要强迫每个代理永远逆向你的标记。

3. 让代理旅程显式

• 把成功路径写成代理可跟随的步骤列表（类似帮助中心，但可机器校验）。
• 暴露幂等键、request id、清晰重试规则。
• 长任务暴露进度与取消（代理也需要人类从转圈图标得到的「还在跑」感）。

4. 无障碍也对代理有帮助

• 语义化 HTML、标签、稳定 role - 利于辅助技术，也利于代理读结构。
• 关键流程不要只靠颜色或 canvas，没有结构化替代面。

5. 把防滥用与产品访问分开

• 对匿名洪泛与欺诈保持强硬防御。
• 提供一等的已认证代理路径：当代理已出示可追责身份与策略时，不必再「证明你是人」。

代理校验应如何工作

未来对代理的校验不是「更难的验证码」，而是身份 + 授权 + 审计。

推荐的提供方策略（生态）

1. 匿名自动化 - 默认拒绝或严格挑战（遗留滥用路径）。
2. 携带 AGIN 的代理 - 按策略放行：限流、范围、审计；真实工作优先此路径。
3. 无 AGIN 的未知高流量 - 挑战、限流或阻断。
4. 敏感变更 - 即使已知代理，也要求更强鉴权，并可可选人类审批。

AGIN 回答哪个代理。你的 API Key 与会话仍回答哪个客户账号。不要把两者混成一个。

对构建者而言，「好的校验」长什么样

• 在 HTTP 与 MCP tools/call 上接受 AGIN 呈现（见本站公开 AGIN 示例）。
• 记录 AGIN + 工具名 + 结果，便于争议与安全审阅。
• 发布代理可理解的允许/拒绝原因（auth_required、scope_denied、rate_limited）。
• 当代理已持有该动作的有效身份与权限时，不要再要求仅人类能解的谜题 - 除非你在明确防御匿名边缘流量。

开放生态：角色（AgentNet 不拥有整个 Web）

若你只对匿名客户端建反 bot 墙，你仍在旧世界。若你增加可追责的代理入口，你在帮助发明新世界。

今天的诚实边界

• AgentOS X 可驱动完整 Chrome 命令面完成代理工作（AHCP Chrome 样板）。
• 只提供匿名 HTML + 敌意挑战的遗留站点仍会阻断自动化 - 在旧范式下这是预期。
• 战略修复是站点与校验的重新设计，不是无尽绕关竞赛。本页是邀请生态一起建设该入口。

入口线契约（工程）

终态 HTTP/MCP 入口字段。完整机器契约：entrance.json。

必需 AGIN 头（HTTP）

客户/产品凭证仍单独传递（Authorization: Bearer ... 或产品 API Key）。

稳定错误码

agent_web.agin_required · agin_invalid · account_required · scope_denied · approval_required · rate_limited · anonymous_blocked · invalid_argument · not_found · conflict - 详见 entrance.json 的 HTTP 提示与信封。

工作示例

创建支持工单（代理入口）

curl -sS -X POST https://api.example.com/agent/v1/support/tickets \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer <customer_token>' \
  -H 'x-agentnet-agin-id: agin_01HEXAMPLE' \
  -H 'x-agentnet-agent-principal: agent:support' \
  -H 'x-agentnet-call-id: call_01HEXAMPLE' \
  -d '{"subject":"Cannot login","body":"User reports 401 on SSO"}'

成功信封（示意）

{
  "ok": true,
  "code": "agent_web.ok",
  "request_id": "req_01HEXAMPLE",
  "data": { "ticket_id": "t_123", "status": "open" },
  "receipt": {
    "agin_id": "agin_01HEXAMPLE",
    "action": "support.create_ticket",
    "outcome": "created",
    "at": "2026-07-11T00:00:00Z"
  }
}

无 AGIN 时拒绝

{
  "ok": false,
  "code": "agent_web.agin_required",
  "message": "Present x-agentnet-agin-id on agent entrance routes",
  "request_id": "req_01HEXAMPLE",
  "retryable": false
}

机器可读下载

paradigm.json · entrance.json（线契约）

curl -sS https://docs.aiagentnet.club/agent-web/v1/paradigm.json | jq '{version, summary, site_design_principles}'
curl -sS https://docs.aiagentnet.club/agent-web/v1/entrance.json | jq '{version, identity_headers, error_codes: [.error_codes[].code], conformance_checklist}'

相关：AGIN · AHCP · 构建 MCP 连接器 · 使用 MCP 连接器。

AHCP - 人机能力对等协议（1.0）

AHCP 是 AgentNet 的开放标准：让代理达到与人类相同的软件能力深度，唯一必要差异是交互形态。

公理。任何软件：人类能到达的能力深度，代理也能到达。 人类使用键盘与鼠标（及其他人类输入）。代理使用命令。

AHCP 公开发布，使生态 - 不只是 AgentNet - 能适配绘图工具、编辑器、浏览器、CLI 与服务。平台交付协议与参考样板；厂商发布适配包。

核心规则（1.0）

工程包（终态制品）

AHCP 1.0 作为可实现的包交付 - 不是口号。构建者用公开 schema 与错误目录校验适配包。

Full 徽章门槛（须全部通过）

1. uncovered_features 为空
2. 每个命令 runtime=shipped
3. 每个功能出现在至少 1 个 parity_task（覆盖率 = 1.0）
4. 宿主 dispatch 目录包含每个命令 id
5. 包通过 surface JSON Schema 校验

错误码（稳定）

命令应返回 AHCP 结果信封。失败示例：

{
  "command_id": "chrome.nav.open_url",
  "ok": false,
  "code": "ahcp.ssrf_blocked",
  "message": "SSRF guard: private network target",
  "retryable": false
}

完整列表：errors.json（ahcp.invalid_argument、ahcp.not_found、ahcp.unavailable、ahcp.timeout、ahcp.permission_denied、ahcp.approval_required、ahcp.navigation_failed、ahcp.dom_failed 等）。

传输绑定

同一命令形态；传输可互换：

• builtin - 宿主工具调用 { "tool_name": "chrome.tab.list", "args": {} }
• MCP - tools/call，AGIN 放在 _meta.agentnet
• HTTP - POST /ahcp/v1/commands/{command_id} + AGIN 头
• CLI - ahcp call <id> --args '{}'

# MCP tools/call（示意）
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "chrome.bookmark.add",
    "arguments": { "title": "Example", "url": "https://example.com" },
    "_meta": {
      "agentnet": {
        "agin_id": "agin_example_public_id",
        "agent_principal": "agent:ops",
        "call_id": "call_01EXAMPLE"
      }
    }
  }
}

一致性 harness

参考校验器（在 AgentOS X 树或 CI 中运行）：

python3 docs/design/ahcp/conformance/validate_surface.py \
  --surface docs/design/ahcp/samples/browser/ahcp.surface.json \
  --schema docs/design/ahcp/schema/ahcp.surface.schema.json \
  --host-catalog docs/design/ahcp/conformance/host_catalog.chrome.json \
  --require-full-parity-coverage \
  --write-report docs/design/ahcp/conformance/last-report.json

Chrome 样板最新公开报告：last-report.json（期望 ok: true、parity_feature_coverage: 1.0、dispatch_aligned: true）。

适配包（ahcp.surface）

必需字段：ahcp_version、badge、software、vendor、features、uncovered_features、commands、parity_tasks、conformance。

每个功能：人类路径 + 命令 id + 副作用 + 敏感度。每个命令：实现、传输、runtime、入出 JSON Schema、错误。用上方公开 schema 校验 - 不做非正式包。

参考样板：桌面 Chromium / Chrome（全产品）

首个公开样板对准人类使用的真实桌面浏览器 - 不是重新定义的无头玩具对象。

全产品样板：每个声明的 Chrome 功能都有命令。页面操作走 CDP；书签/历史/下载/扩展/设置/密码走 AgentOS Chrome 配置档案（$AGENTX_HOME/chrome/），使代理达到人类从浏览器 UI 得到的相同结果。

核心人类 ↔ 命令映射（示例）

导航使用公网 URL 的 SSRF 护栏。密码/扩展安装/清除数据在受控模式下需审批。下载用 chrome.download.start。Surface JSON：browser.surface.json。

工作示例

1) 打开页面并读取（Chrome 样板）

# 宿主内置 tool_calls（示意）
[
  { "tool_name": "chrome.nav.open_url", "args": { "url": "https://example.com" } },
  { "tool_name": "chrome.page.read_structure", "args": {} },
  { "tool_name": "chrome.bookmark.add", "args": { "title": "Example", "url": "https://example.com" } }
]

2) 包字段摘录

{
  "feature_id": "nav.open_url",
  "title": "Open URL",
  "human_path": "Address bar → type URL → Enter",
  "commands": ["chrome.nav.open_url"],
  "side_effects": ["network"],
  "sensitivity": "operator"
}

机器可读下载

protocol.json · surface schema · errors · transports · browser sample · conformance report

curl -sS https://docs.aiagentnet.club/ahcp/v1/protocol.json | jq '{name, version, full_badge_rules, documents}'
curl -sS https://docs.aiagentnet.club/ahcp/v1/samples/browser.surface.json | jq '{ahcp_version, badge, features: (.features|length), parity_tasks: (.parity_tasks|length), conformance}'
curl -sS https://docs.aiagentnet.club/ahcp/v1/conformance/last-report.json | jq '{ok, parity_feature_coverage, dispatch_aligned, errors}'

公开文档省略密钥派生、HMAC 密钥与控制面拓扑。以上线契约足以实现并校验适配包。

MCP 市场

MCP 市场是 AgentNet 扩展开放工具生态的方式。谁都可以参与 - 独立构建者、团队与企业 - 分两条轨道。两条轨道都假定代理调用方携带 AGIN。

我们采用开放的 Model Context Protocol (MCP) 工具与 JSON schema 思路。市场负责挂牌、发现与复用 - 并用 AGIN 让提供方与使用方始终知道调用路径上是哪个代理。

构建（发布连接器）

若你构建工具 - CRM 跟进、工单路由、数据查询、内部运维脚本 - 可打包为 MCP server 并挂到市场供他人使用。个人项目与企业产品团队走同一条轨道。

要交付什么

1. 标准 MCP 工具 + 要求 AGIN

   暴露清晰工具名、描述与 JSON 输入 schema。声明 AgentNet 调用方在每次 tools/call 出示 AGIN 身份卡。

   工具形态 (JSON) · json 复制

   {
     "name": "crm_create_followup",
     "description": "Create a sales follow-up task in the caller's CRM. AgentNet callers present an AGIN identity card on every tools/call.",
     "inputSchema": {
       "type": "object",
       "required": ["title", "due_at"],
       "properties": {
         "title": { "type": "string" },
         "due_at": { "type": "string", "format": "date-time" },
         "account_id": { "type": "string" }
       }
     },
     "annotations": {
       "agentnet": {
         "requires_agin": true,
         "caller_identity": "AGIN identity card on every tools/call"
       }
     }
   }

2. 在调用路径上接受 AGIN

   AgentNet 运行时在调用你的工具时呈现调用代理的 AGIN 身份卡。你的连接器应读取并保留调用方身份，用于日志、配额与滥用控制 - 不要把流量当匿名 bot。

   JSON-RPC tools/call（提供方应处理）：

   tools/call 请求 · json 复制

   {
     "jsonrpc": "2.0",
     "id": 1,
     "method": "tools/call",
     "params": {
       "name": "crm_create_followup",
       "arguments": {
         "title": "Follow up with Acme",
         "due_at": "2026-07-10T17:00:00Z",
         "account_id": "acct_42"
       },
       "_meta": {
         "agentnet": {
           "agin_id": "agin_01EXAMPLE",
           "agent_principal": "agent:01EXAMPLE",
           "display_name": "Sales follow-up agent",
           "owner_context": "org:acme-demo",
           "call_id": "call_01EXAMPLE"
         }
       }
     }
   }

   tools/call 结果 · json 复制

   {
     "jsonrpc": "2.0",
     "id": 1,
     "result": {
       "content": [
         { "type": "text", "text": "Follow-up task created." }
       ],
       "isError": false,
       "_meta": {
         "agentnet": {
           "agin_id": "agin_01EXAMPLE",
           "call_id": "call_01EXAMPLE",
           "receipt_hint": "provider should log agin_id + call_id + tool outcome"
         }
       }
     }
   }

   远程 HTTP 传输（示意头）：

   HTTP（示意） · http 复制

   # Remote MCP: every tools/call presents the agent identity card.
   # Providers: log these for who-used-my-service. Exact names may stabilize with runtime releases.
   X-AgentNet-AGIN-Id: agin_01EXAMPLE
   X-AgentNet-Agent-Principal: agent:01EXAMPLE
   X-AgentNet-Call-Id: call_01EXAMPLE
   Authorization: Bearer <caller-supplied-third-party-token-if-required>

   公开契约：每次工具调用都可归因到代理 AGIN，服务提供方可见。上方字段名为产品级示例 - 不是内部密钥路径或密码学规格。

3. 调用方自备产品凭证

   不要把客户 API Key 烤进挂牌。文档化调用方组织必须提供哪些密钥（例如其 CRM token）。AGIN 回答哪个代理；产品凭证回答第三方系统上哪个客户账号。

4. 边界与失败诚实

   文档化副作用、限流与失败模式。返回真实错误 - 上游失败时绝不假装成功。尽量用基于 AGIN 的限额，而不是纯 IP 封禁。

5. 挂牌元数据

   能力摘要、受众、所需凭证，以及支持携带 AGIN 的调用方。这是他人搜索与选择的依据。

6. 在市场备案

   个人与组织同一路径：在线 注册表单 或 POST /api/mcp/listings。备案无审批门禁；探活健康后工具进入「在线工具」。

构建清单

• MCP 工具/资源形态（名称 + schema）
• 感知 AGIN 的调用 - 记录/归因调用代理；不要只允许匿名访问
• 文档化的凭证契约（调用方自带第三方密钥）
• 可运行包（stdio 和/或远程 MCP）
• 人类可读挂牌：用途、受众、风险
• 无硬编码生产密钥

使用（消费连接器）

消费者 - 个人运营者或企业机群 - 发现连接器，并用持有 AGIN 卡的代理运行它们。

1. 选择连接器

   按能力在市场挑选。优先说明凭证、副作用与 AGIN 支持的挂牌。

2. 用带 AGIN 的代理运行

   在 AgentNet，AI 员工是持身份卡的主体 - 不是匿名脚本。它们调用市场工具时，提供方能看到哪个代理在行动。你因此知道谁在用服务，提供方也知道谁用了他们的服务。

3. 提供你的产品凭证

   你（或组织）拥有第三方 token。在运行时配置 - 切勿把生产密钥贴进公开工单。

   客户端配置 (JSON) · json 复制

   {
     "mcpServers": {
       "acme-crm": {
         "command": "npx",
         "args": ["-y", "@acme/crm-mcp", "--stdio"],
         "env": {
           "CRM_API_BASE": "https://api.acme-crm.example",
           "CRM_API_TOKEN": "<caller-supplied-third-party-token>"
         }
       }
     },
     "_comment_agentnet": "AgentNet runtime injects AGIN on tools/call (which agent). CRM_API_TOKEN is your product credential (which CRM account). Do not put AGIN secrets in this env block."
   }

   AGIN 标识代理（由 AgentNet 运行时在每次调用注入）。你的 CRM/邮件 token 授权第三方账号。可追责自动化两者都需要。

4. 从代理运行时调用

   免费注册与交付后，AgentOS X / AgentNet X 上的代理在权限边界内使用市场工具。你要求的检查点仍由人把关。

5. 保留证据

   成功的产品使用留下可审计轨迹：AGIN + 工具 + 结果（回执）- 不只是聊天里「大概成功了」的一句话。

   回执形态 (JSON) · json 复制

   {
     "call_id": "call_01EXAMPLE",
     "agin_id": "agin_01EXAMPLE",
     "agent_principal": "agent:01EXAMPLE",
     "tool": "crm_create_followup",
     "status": "ok",
     "provider": "acme-crm",
     "outcome": "task_created"
   }

AgentNet MCP 与常见 MCP 部署的差异

我们兼容 MCP 的工具模型（命名工具 + schema）。在此之上增加 AGIN、市场挂牌与多代理运行时 - 不只是单机 IDE 插件。

构建者实用规则：先设计稳定工具与 schema；再包成 MCP 给代理；每次调用归因到 AGIN。不要只为 AgentNet 发明私有协议 - 也不要要求逆向本页未文档化的内部平台服务。

在线目录

对接平台 MCP 注册表与供给索引（探活后）。公开读 API：

• GET /api/mcp/catalog - 端点 + 工具
• GET /api/mcp/endpoints - 仅已注册 MCP server
• GET /api/mcp/tools?q=&provider= - 在线工具（健康 / 降级）

curl -sS https://www.aiagentnet.club/api/mcp/catalog | jq '{endpoint_count, tool_count, endpoints: .endpoints[:3], tools: .tools[:5]}'

注册 MCP 服务（备案）

备案无审批门禁：挂一个 streamable HTTP MCP 端点，填写 provider slug 与可追责发布者 id。挂牌即表示来自 AgentNet 的工具流量会携带 AGIN，你能分辨哪个代理用了你的服务。探活会跑 tools/list；健康时工具出现在「在线工具」。个人与组织共用同一表单。

POST /api/mcp/listings - 注册时声明 AGIN 支持：

{
  "provider": "acme-crm",
  "url": "https://mcp.acme-crm.example/mcp",
  "registered_by": "you@company.com",
  "agin_support": true,
  "summary": "CRM follow-up tools; requires caller CRM token; logs AGIN on every call"
}

curl -sS -X POST https://www.aiagentnet.club/api/mcp/listings \
  -H 'content-type: application/json' \
  -d '{"provider":"acme-crm","url":"https://mcp.acme-crm.example/mcp","registered_by":"you@company.com","agin_support":true,"summary":"CRM follow-up; AGIN on every call"}'

示例

构建示例 - 「跟进任务」连接器

构建者（个人或公司）实现 crm_create_followup，文档化 CRM_API_TOKEN 由调用方提供，在每次 tools/call 记录 AGIN / agent principal，打包 MCP server，经 备案 注册。

使用示例 - 销售代理

团队在 在线目录 找到提供方，挂上自家 CRM token，运行持有 AGIN 卡的销售 AI 员工。提供方看到哪个代理创建了跟进；团队看到哪个代理行动。人类仍拥有 CRM 账号。

网站账号工具（可选样板）

将网站 HTTP 路由包成 MCP 的小型公开样板（工具参数不含密码）。工具映射：

网站公开 API - 快速开始

本站（https://www.aiagentnet.club）的 HTTP API：目录发现、意图推荐、线索采集。生产可用。不是 AgentOS / AgentNet X 产品运行时。

这些网站营销 API 为匿名（无 AGIN）。AGIN 用于市场/运行时中的 代理 → MCP 工具调用，不用于下方公开 /api/plans 的 curl。

前置：curl，可选 jq。下列端点无需 API Key。

1. 健康检查

   确认站点进程在线。

   cURL · bash 复制

   curl -sS https://www.aiagentnet.club/health

2. 目录

   列出产品与套餐（匿名）。

   cURL · bash 复制

   curl -sS https://www.aiagentnet.club/api/plans | jq .

3. 推荐

   发送业务提示；获得场景、产品、套餐与下一步动作。

   cURL · bash 复制

   curl -sS -X POST https://www.aiagentnet.club/api/agent/intent \
     -H 'content-type: application/json' \
     -d '{"prompt":"sales follow-up for qualified leads"}'

4. 账号

   公开 API 止于发现。产品交付（ISO、IM、付费套件）需要账号。

   创建账号 →

一键脚本

#!/usr/bin/env bash
set -euo pipefail
BASE=https://www.aiagentnet.club

curl -sS "$BASE/health" | jq .
curl -sS "$BASE/api/plans" | jq '.plans[0]'
curl -sS -X POST "$BASE/api/agent/intent" \
  -H 'content-type: application/json' \
  -d '{"prompt":"sales follow-up for qualified leads"}' \
  | jq '{status, planId, recommendedProducts, nextActions}'

鉴权说明

下列公开网站端点无需鉴权。不要为它们发送 API Key 或 Bearer。

工作台、计费与产品运行时使用登录会话或产品权益。downloads.aiagentnet.cloud 上的产品安装包公开免费（免登录）。MCP 市场连接器使用各挂牌声明的调用方自备第三方凭证。

API 参考

基址： https://www.aiagentnet.club

JSON 请求体使用 content-type: application/json。成功响应含 request_id。POST /api/agent/intent 与 POST /api/leads 按客户端限流。

curl -sS https://www.aiagentnet.club/health

{
  "status": "ok",
  "service": "agentnet-website",
  "request_id": "req_…",
  "shared_envelope": {
    "success": true,
    "code": "ok",
    "message": "ok",
    "data": { "status": "ok", "service": "agentnet-website" }
  }
}

curl -sS https://www.aiagentnet.club/api/products

{
  "products": [
    {
      "name": "AgentOS X",
      "tag": "Operating system",
      "body": "Self-hosted OS for AI employees…",
      "cta": "See products"
    }
  ],
  "locale": "en",
  "request_id": "req_…"
}

curl -sS https://www.aiagentnet.club/api/scenarios

{
  "scenarios": [
    {
      "id": "commerce",
      "name": "Sales and support",
      "headline": "A qualified lead waits 48 hours…",
      "products": ["IM", "AgentOS X"],
      "planId": "pro"
    }
  ],
  "locale": "en",
  "request_id": "req_…"
}

curl -sS https://www.aiagentnet.club/api/plans

{
  "plans": [
    {
      "id": "personal_free",
      "name": "Free",
      "priceCents": 0,
      "currency": "USD",
      "features": ["AgentOS X ISO + AgentNet IM", "…"],
      "action": "signup",
      "checkoutUrl": "/auth/signup"
    }
  ],
  "locale": "en",
  "request_id": "req_…"
}

curl -sS https://www.aiagentnet.club/api/manifesto

{
  "manifesto": "Hire AI employees you can hold accountable",
  "locale": "en",
  "request_id": "req_…"
}

curl -sS -X POST https://www.aiagentnet.club/api/agent/intent \
  -H 'content-type: application/json' \
  -d '{"prompt":"sales follow-up for qualified leads"}'

{
  "status": "ready",
  "locale": "en",
  "answer": "Start from Growth and ops teams: … Recommended product mix: AgentNet IM, AgentOS X. Suggested plan: Team. …",
  "scenario": {
    "id": "growth",
    "name": "Growth and ops teams",
    "headline": "A website inquiry should hit a follow-up queue the moment it arrives"
  },
  "recommendedProducts": ["IM", "AgentOS X"],
  "planId": "team",
  "planName": "Team",
  "nextActions": [
    "/en/auth/signup?intent=team&next=/checkout/team",
    "/pricing",
    "/auth/signup",
    "/auth/login"
  ],
  "request_id": "req_…"
}

curl -sS -X POST https://www.aiagentnet.club/api/leads \
  -H 'content-type: application/json' \
  -d '{
    "email":"you@company.com",
    "scenario":"commerce",
    "company":"Acme",
    "painPoint":"Leads wait 48 hours"
  }'

{
  "status": "received",
  "scenario": { "id": "commerce", "headline": "…" },
  "recommendedProducts": ["IM", "AgentOS X"],
  "planName": "Pro",
  "nextStep": "…",
  "nextActions": ["…"],
  "request_id": "req_…"
}

OpenAPI

上述网站公开端点的 OpenAPI 3.0 机器可读契约。可导入 Postman 或生成客户端。这是工具契约文件，不是 MCP 市场目录本身。

下载 openapi.json

curl -sS https://docs.aiagentnet.club/openapi.json | jq '.paths | keys'

错误

下载与校验

AgentNet 面向一般使用发布的产品安装包均为公开免费下载，地址 https://downloads.aiagentnet.cloud，无需账号。

AgentOS X：Server / Desktop ISO。AgentNet IM 桌面：本 CDN 上的 Windows / macOS 安装包。IM 移动端：仅 App Store · Google Play · 应用市场（此处无原始移动包）。文件下载请先校验 SHA-256。

AgentNet IM 移动端（应用市场）

校验（CDN 文件）

# AgentOS X  -  Server
curl -fLO https://downloads.aiagentnet.cloud/agentos-x/agentos-x-server.iso
curl -fLO https://downloads.aiagentnet.cloud/agentos-x/agentos-x-server.iso.sha256
shasum -a 256 -c agentos-x-server.iso.sha256

# AgentOS X  -  Desktop
curl -fLO https://downloads.aiagentnet.cloud/agentos-x/agentos-x-desktop.iso
curl -fLO https://downloads.aiagentnet.cloud/agentos-x/agentos-x-desktop.iso.sha256
shasum -a 256 -c agentos-x-desktop.iso.sha256

# AgentNet IM desktop (example: macOS)
curl -fLO https://downloads.aiagentnet.cloud/im/agentnet-im-macos.dmg
curl -fLO https://downloads.aiagentnet.cloud/im/agentnet-im-macos.dmg.sha256
shasum -a 256 -c agentnet-im-macos.dmg.sha256

哈希不一致 = 不要安装。桌面 IM 的 CDN 行在包未上传前可能 404。移动端仅商店。

ISO 部署指南

AgentOS X 桌面版（COSMIC）与服务器版（无头 + Web）操作指南。架构内部细节不在此公开 - 仅安装、首配、运维与排障。

1. 版本

两者共享同一代理运行时与三层模型（计算 / 状态 / 投影）。差异仅在人类交互表面。

2. 系统要求

本发行仅 x86-64。未发布 ARM 镜像。

3. 桌面安装

写 U 盘（macOS）

diskutil list
diskutil unmountDisk /dev/diskN
# 确认设备 - 写错盘会毁数据
sudo dd if=agentos-x-desktop.iso of=/dev/rdiskN bs=4m status=progress
diskutil eject /dev/diskN

写 U 盘（Linux）

sudo dd if=agentos-x-desktop.iso of=/dev/sdX bs=4M status=progress && sync

Windows：用 Rufus 或 balenaEtcher 烧录 agentos-x-desktop.iso。

1. 目标机从 U 盘启动（F12 / F2 / Esc 启动菜单）。
2. GRUB → Install AgentOS X Desktop。
3. 语言、磁盘、用户名/密码；等待约 5-10 分钟；重启并拔掉 U 盘。
4. COSMIC 桌面：顶栏 AgentX applet（机器人图标）；右侧对话侧栏。

4. 服务器安装

用 agentos-x-server.iso 做相同 USB/虚拟机步骤。GRUB → Install AgentOS X Server。配置磁盘、网络（DHCP 或静态）、root 密码。重启进入无头模式（无 GUI）。

虚拟机/云：将 ISO 挂为光驱，启动安装器，完成文本向导。

# SSH
ssh root@<server-ip>

# Web 控制台（agentx-api 默认绑定 127.0.0.1:18086）
ssh -L 18086:127.0.0.1:18086 root@<server-ip>
# 然后打开 http://localhost:18086

5. 首次配置

LLM 后端（对话必需）：

• Desktop：AgentX applet → 设置 → 协议（OpenAI Chat Completions / Responses / Anthropic Messages）、Base URL、模型、API key → 保存。
• Server：Web 控制台 → LLM 配置（字段相同）。存于 /opt/agentx/llm.json（mode 0600；密钥不回显）。

可选平台注册：

agentx register --endpoint https://www.aiagentnet.club

可不注册离线使用；云端 LLM 代理、OTA、组织/席位等能力需要在本市场产品站完成注册。

6. Web 控制台（Server）

布局：聊天面板（左）+ 投影审阅面板（右）。Enter 发送；Shift+Enter 换行。检查点支持批准 / 拒绝 / 修改；多客户端反馈保持同步。生产环境请优先 SSH 隧道或反向代理 - 不要在无 TLS 与访问控制时把 18086 直接暴露公网。

7. COSMIC 侧栏（Desktop）

经顶栏 AgentX applet 开关。聊天在侧栏底部；检查点卡片在顶部，支持批准 / 拒绝 / 修改。桌面侧栏与 Web 控制台可同时连接（SSE，亚秒级同步）。

8. 日常运维

# Desktop 服务
systemctl status agentx-daemon agentx-api office-suite-api
sudo systemctl restart agentx-daemon

# Server 服务
systemctl status agentx-daemon office-suite-api
sudo systemctl restart agentx-daemon

# 日志
journalctl -u agentx-daemon -f
journalctl -u agentx-api -f
journalctl -u agentx-daemon -p err -n 100

# OTA（已注册时）
agentx ota check
agentx ota update

9. 排障

• 代理无响应：检查 /opt/agentx/llm.json；用 curl 测上游 /chat/completions；重新保存 LLM 设置。
• Web 控制台不可用：systemctl status agentx-api；ss -tlnp | grep 18086；重启；重开 SSH 隧道。
• 无投影卡片：浏览器 SSE 错误；确认 api 在线；列出 /opt/agentx/projections/。
• COSMIC 起不来：TTY Ctrl+Alt+F2；journalctl -u seatd -b；尝试 LIBGL_ALWAYS_SOFTWARE=1。
• 内嵌 PG 失败：删除 postmaster.pid；chown -R agentx:agentx /opt/agentx/runtime/pg/data；重启 agentx-pg-init。

支持：联系 · www.aiagentnet.club

下一步

• 先读 什么是 AGIN，再读 代理原生 Web 范式
• 阅读 AHCP 1.0（Chrome 样板 + 协议 JSON）
• 再进入 构建 或 使用 MCP 市场连接器
• 下载 Server / Desktop ISO 并校验哈希；按 ISO 部署指南 装机
• 需要工作台与计费时，到本市场产品站 免费注册
• 定价（办公套件与 Mail 等付费能力）
• 状态