Agoragentic Mcp

Agoragentic

保留现有框架，增加管控与证明。

**Agoragentic 是面向已部署 Agent 和 Agent 集群的 Triptych OS（Agent OS）。此仓库是其开放的集成、治理和证据入口。**它帮助开发者限定 Agent 可以执行的操作，保留可供检查的操作证据，并仅在需要时将 Agent 接入托管运行或 Agent 商务功能。

可将其与现有的 Agent、MCP 服务、编码工作流或工具调用应用搭配使用。Agoragentic 并非要求重写代码的另一种编排框架。

your agent or tool
        ↓
Agoragentic policy and approval boundary
        ↓
your existing runtime
        ↓
lifecycle evidence + receipt
        ↓
optional Agent OS, Router / Marketplace, or Interchange

适用对象

Agoragentic 面向已经拥有 AI Agent 或由 Agent 驱动的产品，并需要回答以下问题的开发者和平台团队：

• Agent 获准执行哪些操作？
• 在执行重大操作之前，适用了哪项策略？
• 是否需要所有者批准？
• 有哪些证据支持记录的结果？
• 还有哪些事项被阻止或仍不明确？
• 日后能否运行同一个受治理的 Agent、向其付款，或将其接入其他网络？

精选集成路径

以下是进入 Agoragentic 技术栈的最短受支持路径。

需求	从这里开始	结果
在本地治理操作	Harness Core	策略决策、审批记录、生命周期事件、本地证明，以及明确标注的本地回执
治理项目上下文	Micro ECF 或 ECF Core	允许和禁止的来源边界、来源溯源、上下文产物以及本地 MCP
运行以证据为先的 Codex 工作流	Fable-5	审计、审查、事实核查、架构分析、受限子 Agent，以及如实呈现的工作流轨迹
运维已部署的 Agent	Agent OS	任务授权、预算、审批、停止控制、运行时状态、回执和对账
路由或购买 Agent 工作	Node SDK 或 Python SDK	任务匹配、受限执行、最新的提供方元数据以及托管回执
检查 MCP / Agent Client Protocol 边界	MCP 源码 和 ACP 元数据	未发布的协议／参考源码及本地自有元数据；若没有单独通过资格验证的主机边界，远程发现和调用将安全失败
离线检查 ARD 发现元数据	ARD v0.91 源配置	固定版本的 schema 和上下文、确定性的兼容性生成器，以及安全失败的规范化器；不提供已部署的 well-known 端点、网络解引用、执行、支付、信任或发布权限
审查先分叉再承担风险的合约	Risk Fork	实验性纯源码分类、生命周期、污染、E2B 和 PostgreSQL 权限合约；不支持实时遏制、托管拦截、部署，也不声称已达到生产就绪状态
在本地演示先分叉再承担风险	Risk Fork hackathon 演示	命名的合成夹具、确定性分类、生命周期重放、清理证据和本地回执；明确不代表隔离或实时防护
连接市场或网络	Interchange	跨市场发现、任务授权执行、回执验证和对账

五分钟内在本地启动

此路径无需 Agoragentic 账户、钱包、支付、托管运行时或外部模型提供商。 规范源码、schema、示例和发行版本位于独立的 Harness Core 仓库；旧版 harness-core/ 路径是一个长期保留的迁移指引。

npx agoragentic-harness-core@latest init
npx agoragentic-harness-core@latest validate
npx agoragentic-harness-core@latest run \
  --profile local_no_spend \
  --task "Create an evidence-backed readiness summary"

检查本地产物：

agent.yaml
policy.yaml
.agoragentic/
├── local-proof.json
├── local-receipt.json
└── runs/<run_id>/
    ├── state.json
    ├── events.jsonl
    ├── local-proof.json
    ├── local-receipt.json
    ├── agent-os-harness.json
    └── summary.md

通用 Harness run 路径会验证配置和策略，并记录一个零支出证明边界。**任务字符串仅用于标记此次运行；它不能证明主机执行了该任务。**实时执行需要受支持的主机钩子，或围绕 Harness 中间件构建的主机集成。

当前可用的实时执行

主机	当前能力	声明范围限制
Claude Code	打包的 PreToolUse 允许／询问／拒绝钩子	执行工具调用前的策略决策；不能证明所有下游副作用都已正确完成
OpenCode	固定到精确主机合约夹具的实验性前后钩子适配器	源码候选方案，具备有限的本地证据；不代表普遍的端到端兼容性
LangGraph、CrewAI、Codex、MCP、Hermes、Rust 参考运行时及其他	映射示例和适配器合约	支持映射或示例不等同于在执行路径中实施管控

在解读集成状态之前，请阅读集成能力级别。生成的能力状态直接根据 integrations.json 展示选定记录及其证据边界。

选择一条路径

为现有 Agent 添加治理

保留现有框架或运行时。从 Harness Core 入手，用于围绕操作执行策略决策、审批、生命周期证据和本地收据。

LangGraph       ─┐
CrewAI          ─┤
OpenAI Agents   ─┤
Codex           ─┤
Claude Code     ─┤──→ Harness Core ─→ policy + evidence + receipt
MCP             ─┤
custom Python   ─┤
custom Node.js  ─┘

在 integrations.json 中浏览机器可读目录。目录条目并不自动代表已启用实时强制执行、已部署兼容性或已具备支付条件。

在此修订版本中，规范的 integrations.json 清单包含 112 个接入面。ecosystem.json 是计数依据；生成的公开文案应读取机器清单，而不是自行维护独立数字。

治理 Agent 可了解的内容

从 Micro ECF 入手：

npx agoragentic-micro-ecf@latest plan --dir .
# Review the proposed local writes.
npx agoragentic-micro-ecf@latest install --dir . --yes

当你需要更丰富的来源编译、代码索引、证据单元、上下文路由、落地评估或可自托管的本地 MCP 服务时，转向 ECF Core。

5 分钟买家快速入门

当 Agent 需要匹配当前能力或执行 Router 时，可选用此托管路径。

npm install agoragentic

const agoragentic = require("agoragentic");
const client = agoragentic(process.env.AGORAGENTIC_API_KEY);

const match = await client.match("summarize", { max_cost: 0.10 });
const result = await client.execute(
  "summarize",
  { text: "Governed agents need explicit authority and inspectable outcomes." },
  { max_cost: 0.10 }
);

console.log(match.providers?.[0]);
console.log(result.output);
console.log(result.receipt_id || result.invocation_id);

准备好使用托管 Router 后，再创建免费的买家身份：

curl -X POST https://agoragentic.com/api/quickstart \
  -H "Content-Type: application/json" \
  -d '{"name":"my-agent","intent":"buyer"}'

匹配结果只是预览。请从实时响应中读取当前可用性、定价、支付要求、重试指南和收据状态。将钱包凭据、最高支出、支付授权和重试权限置于模型控制的参数之外。

部署、运营、购买或销售

使用 Agent OS 执行零支出就绪检查、部署预览、采购检查、审批、收据检查和对账。使用 Router / Marketplace 匹配当前能力并执行。使用 Interchange 跨组织边界连接买家 Agent、卖家 Agent、市场或网络。

商业交易是可选的。使用开源本地层并不要求进行商业交易。

开源与托管服务

接入面	提供内容	不授予
Harness Core	本地策略与审批记录、生命周期证据、证明、收据、Agent OS 预览导出	提供商调度、钱包控制、结算、托管部署、市场发布
Micro ECF / ECF Core	本地来源与上下文治理、来源追溯、构件、本地 MCP	托管记忆、部署、支出、信任或排名变更
Fable-5	证据优先的 Codex 工程工作流	独立认证、部署、支出或所有者授权
SDKs	用于 Router、Agent OS、能力、收据和控制项的客户端	私有路由、信任、欺诈处理或自动支付授权
MCP / ACP 源代码候选方案	自有的本地元数据，以及经过测试的故障关闭式主机强制执行契约	已认证的托管强制执行、凭据传输、实时隔离、生产流量或已达到包注册表发布条件
Risk Fork	仅源代码的风险前分叉协议，以及范围受限的本地／一次性测试证据	实时提供商遏制、托管拦截、托管 PostgreSQL 运维、部署、发布、支出或生产就绪状态
Agent OS	托管式治理运营、预算、审批、运行时状态、收据、对账	所有者授权范围之外的权限
Router / Marketplace / Interchange	发现、匹配、执行契约、可选支付、跨市场对账	声称目录中的每个条目当前都可调用或已验证

收据能证明什么

收据类别	支持的内容	本身无法证明的内容
本地 Harness 收据	记录的配置、策略决策、工件引用和权限边界	主机执行、提供方输出或结算
主机观察到的收据	适配器观察到的有界主机操作及捕获的证据	除非另行验证，否则无法证明所有外部副作用
托管执行收据	Router 或 Agent OS 调用及返回的执行元数据	独立认证或所有平台外后果
结算收据	针对确切交易所支持的支付状态	已交付工作的质量或正确性

缺失的证据仍然缺失。文档、配置、模型响应或本地收据都无法凭空产生已部署、提供方、支付或人工证明。

协议名称

• Agent Commerce Interchange 是 Agoragentic 用于连接买方 Agent、卖方 Agent、市场和网络的治理与证据契约。
• Agent Client Protocol (ACP) 是在构建此源代码检出版本后，通过 node mcp/dist/mcp-server.cjs --acp 选择的仓库本地 stdio 模式。未发布的 2.0.0 候选版本提供自有的本地元数据；若没有单独通过资格认证的主机边界，则会在远程发现或工具执行前安全失败；它不是商业网络。
• Agoragentic Commerce Draft 0.1 是保留在 specs/ACP-SPEC.md 中的历史文档。其曾用名称 Agent Commerce Protocol 和 acp_spec 标识符是兼容性别名，并不代表生产环境符合规范。
• 其他同样名为 ACP 的外部商业协议需要使用单独命名的适配器；不得暗示它们属于任何一个 Agoragentic 表面。

软件包

需求	安装或入口点
本地操作治理	npx agoragentic-harness-core@latest init
轻量级上下文边界	npx agoragentic-micro-ecf@latest plan --dir .
可自托管的上下文治理	npx agoragentic-ecf-core@latest init .
Node.js 客户端	npm install agoragentic
Python 客户端	pip install agoragentic
MCP 协议／参考源代码	在此检出版本中运行 npm --prefix mcp ci && npm --prefix mcp run build；不要解析旧版 npm 中继
Agent Client Protocol 参考模式	在构建源代码后运行 node mcp/dist/mcp-server.cjs --acp；若没有通过资格认证的主机强制执行机制，远程调用仍会被阻止
Risk Fork 本地演示	npm --prefix risk-fork ci --ignore-scripts --no-audit --no-fund，然后在此检出版本中运行 node risk-fork/hackathon/bin/risk-fork-demo.mjs doctor；仅为本地合成协议模拟器
Agent OS CLI	npx agoragentic-os@latest doctor
可自托管的参考运行时	Agoragentic Rust Framework HTTP Runtime
n8n 节点	npm install n8n-nodes-agoragentic
Fable-5	安装 Fable-5
发布前事前复盘	npx agoragentic-premortem-golden-loop@latest audit --repo .

实验性集成和仅提供源代码的集成仍受各自 README 中所述限制的约束。将其纳入此仓库并不能证明其已发布或兼容。

MCP / ACP 生产状态

请勿从 npm 安装 agoragentic-mcp，也不要向其中注入 AGORAGENTIC_API_KEY：该注册表名称指向一个旧版直接中继，而本仓库中故障时默认拒绝的 2.0.0 实现尚未发布，无法安装。该源代码候选版本不拥有任何上游网络或凭据传输；除非由经过单独认证的主机强制执行边界嵌入，否则它会拒绝远程发现和工具调用。server/discover 前的托管拦截、提供商认证、恶意协议金丝雀测试，以及回滚／紧急停用开关证据仍未完成；目前受支持的 Router 调用请使用 Node 或 Python SDK 和有文档说明的 REST API。

单独的 Risk Fork 黑客松演示从源代码检出运行时，需要安装此锁定依赖：

npm --prefix risk-fork ci --ignore-scripts --no-audit --no-fund

随后，它会使用固定的本地入口点 node risk-fork/hackathon/bin/risk-fork-demo.mjs，并调用命名的合成测试夹具。经过验证的离线套件已包含完整依赖；解压套件后请勿运行 npm install 或 npm ci。这两种方式都不会使用 npm 中继，也不会建立托管拦截、提供商隔离、生产就绪能力或实时保护。

机器可读发现

界面	用途
integrations.json	权威的集成与软件包清单
生成的集成能力状态	根据权威清单整理的人类可读能力与证据表
仓库重命名前置检查	人类可读的依赖、推出与回滚资料包；未授权任何重命名
repository-rename-preflight.json	确定性的逐文件重命名依赖清单
ecosystem.json	持久的产品图谱与公开入口
ARD v0.91 源配置	固定的提案产物、本地扩展词汇、确定性的仓库候选项，以及离线故障关闭验证；不是实时发现途径
Harness Core 当前版本证据	当前 0.4.2 版本、npm 完整性、受保护的发布、来源证明、洁净环境导出，以及仅观察者模式的 AHP 证明
Harness Core 独立切换证据	不可变的历史 0.3.1 仓库切换记录
Interchange 研究记录	受证据范围约束的生产研究索引与发布状态
Interchange 生产证据台账	机器可读的实验、发现、权威来源与声明边界记录
Interchange 发布证据缺口	明确列出的未解决阻碍与不受支持的声明
Interchange 研究参考资料	研究记录使用的公开来源与证据参考资料
Risk Fork 黑客松能力卡	机器可读的本地演示入口、限制、存储、清理、提供方与声明边界
Risk Fork 黑客松演示状态	机器可读的源代码／演示真实性标记；生产、实时、npm 和托管状态均为 false
OpenAPI	托管 HTTP 契约
MCP 服务卡	MCP 发现元数据
A2A Agent 卡	Agent 间发现元数据
能力目录	当前公开能力元数据
公开证明	已发布的证明状态与声明标签
llms.txt 和 AGENTS.md	面向机器和编码 Agent 的入门说明

实时机器接口是当前可用状态的权威来源。仓库文档不能凌驾于所有者控制、预算、付款要求、验证状态、重试指导、撤销状态或部署就绪状态之上。

构建集成

1. 阅读 integrations.json 和 integrations.schema.json。
2. 选择要实现的确切能力类别。
3. 从适配器模板开始。
4. 将支出、付款授权、重试权限、机密和审批置于模型控制的参数之外。
5. 添加特定于框架的测试和范围明确的证据参考。
6. 运行：

node scripts/adapter-conformance-agent.mjs --adapter your-integration-id
node scripts/verify-integrations-json.js
node scripts/sync-integration-counts.mjs --check
node scripts/generate-repository-rename-preflight.mjs --check

请参阅 CONTRIBUTING.md、分发状态和社区测试。

安全与许可证

切勿提交 API 密钥、钱包材料、授权标头、Cookie、私有提示词、原始工具输出、私有 ECF 负载或客户证据。请通过 SECURITY.md 报告疑似漏洞。

本仓库采用 MIT 许可证，除非某个子目录或供应商组件另有说明。请参阅 LICENSE。