agenticorg

AgenticOrg

AgenticOrg 是一个企业级 AI Agent 平台，可用于构建、运行和治理覆盖财务、人力资源、营销、运营、后台、通信以及有边界的 Agent 商务场景的 Agent 工作流。该平台依据 Orchestrum Personal Use License 1.0 提供源代码；仅限个人免费使用，任何组织均需与 Orchestrum Technologies LLP 签署协议；SDK 和 MCP 服务采用 Apache-2.0 开源许可（请参阅许可）。

所有权： AgenticOrg 归 Orchestrum Technologies LLP 所有。

发明者／所有者： Sanjeev Kumar

联系方式： [email protected] | [email protected]

网站演示和试用线索通知默认发送至 [email protected]。 可自托管的运营方可以通过 AGENTICORG_DEMO_NOTIFY_TO 选择一个自定义营销收件箱。此设置不会重定向请求者确认邮件、 工作区通知或账户恢复邮件，也不能替代 SMTP 配置。

请参阅规范的所有权和联系方式声明及 NOTICE。

网站 | 应用 | 演练场 | 用户手册 | 技术文档 | 当前产品状态 | 安全政策

从可衡量的试点项目开始：银行服务案例、 金融科技／API 集成，或 商家与外部买家工作流。 可视化部署检查清单介绍 源配置、审核、外部确认和扩展。请通过 [email protected]讨论您的任务和 系统；请勿在公开咨询中发送凭据或客户数据。

许可证

AgenticOrg 平台以源代码可见的形式，根据 Orchestrum Personal Use License 1.0 提供。 仅个人将其用于自身个人用途时，方可免费使用。任何组织 （公司、商号、个体经营企业、慈善机构、学校、大学、研究机构和政府）如需以任何方式使用，均须事先与 Orchestrum Technologies LLP 签署协议并取得书面许可，包括评估、测试、试点、内部使用、托管、转售或嵌入，无论是否收费。

AgenticOrg SDK（sdk/、sdk-ts/）和 MCP 服务（mcp-server/）采用 Apache License 2.0 开源， 可免费用于任何用途，包括商业用途。

目录	许可证
sdk/（Python SDK）	Apache License 2.0：开源，可免费用于任何用途，包括商业用途
sdk-ts/（TypeScript SDK）	Apache License 2.0：开源，可免费用于任何用途，包括商业用途
mcp-server/（MCP 服务）	Apache License 2.0：开源，可免费用于任何用途，包括商业用途
tests/fixtures/ucp/、core/commerce/acp/schemas/（引入的协议架构）	Apache License 2.0（第三方内容，未作修改）
其他所有内容：AgenticOrg 平台（api/、core/、auth/、connectors/、ui/ 以及网站、工作进程、docs/、scripts/、migrations/、测试）	Orchestrum Personal Use License 1.0：仅供个人使用；任何组织均须与 Orchestrum Technologies LLP 签署协议

• **免费（平台）：**仅限个人用于自身个人用途。分发该平台也需要书面协议。
• **商业许可证：**请参阅 COMMERCIAL-LICENSE.md，并发送邮件至 [email protected]。
• **现有用户：**这些条款适用于 2026 年 10 月 21 日及之后发布的所有版本，包括所有更新。该日期之前发布的版本仍可依据其发布时采用的 Apache License 2.0 使用。现有用户和新用户 均须签署协议，方可由组织或代表组织使用 2026 年 10 月 21 日及之后发布的版本。
• 商标：“AgenticOrg”和“Grantex”是 Orchestrum Technologies LLP 的商标；商业使用这些名称、标志、托管服务或品牌，均须事先获得书面许可，适用于任何版本。请参阅 TRADEMARKS.md。

信息来源

实时产品总数和已部署的产品版本由公开的产品事实接口发布：

GET https://app.agenticorg.ai/api/v1/product-facts

响应包含 version、agent_count、connector_count 和 tool_count。请勿将这些值复制到文档、页面文案或测试中：这些值根据运行时注册表计算，可能独立于文档发布而发生变化。源代码构建所声明的版本见 pyproject.toml。

计费限额和标价见 core/billing/catalog.py。生产环境的部署行为见 scripts/deploy_cloud_run.sh。

当前版本速览

自带渠道和 AI 凭据

新建 Agent 默认使用 gemini-3.5-flash-lite；显式选择的模型保持不变。请将 Google 或其他提供商的密钥保存在受保护的 AI 凭据设置中。模型选择、回退和公司范围仍可配置。 对于此模型，Agent Configuration > Gemini thinking 提供可选的中等配置，用于多步推理。现有 Agent 和通用调用仍使用提供商默认设置；不会更改全局标志或默认值。对应的 API 设置为 llm.thinking_level="medium"；将其设为 null 即可恢复提供商默认设置。两个运行时客户端都会遵循显式配置。思考过程按输出 token 计费；请在现有限制内为额外的 token 用量和响应时间预留预算。这并不保证结果正确。旧版模型设置和所有功能标志均保持不变。请参阅推理验收。

Channels 仪表板可将你自己的 WhatsApp Cloud API、Meta Messenger、Telegram、Viber、入站 Mailgun 邮件或签名网关连接到 Agent 或工作流。凭据经过加密，回调经过身份验证，未关联的消息需要审核，私密发送者关联仅委派你当前拥有的权限。现有的 Twilio 语音／通话设置和远程 MCP 工具发现仍是独立集成。 原生渠道回复默认仅发送可选状态通知。Telegram Agent 连接可在 Channels > Reply content 中选择启用受限的最终答案回复，仅发给已关联的私密发送者。跟踪记录和工具调用记录保留在 AgenticOrg 中；审批、发送者授权和租户控制仍然适用。加密接入流程会在服务之间传递经过身份验证的发送者身份；缺少该证明的旧回执仍会被拦截，即使 Agent 已完成任务也不例外。 对于处于此选择启用模式、无流量拆分且不使用工具的 Telegram Agent，后续对话可在 30 分钟内使用来自同一已关联私密发送者及 Agent／公司范围的最多四组近期已确认问答。这是有界的文本上下文，不是持久记忆，也不代表可以重复执行操作。在隐私扫描前，印地语及其他 Unicode 模型输入仍可读；现有的脱敏措施仍然适用。启用 AGENTICORG_PII_HINDI_GRAMMAR_ENABLED=true（默认关闭）后，针对性的印地语语法检查可以区分指代性的人名／颜色提问与具体命名值。这不是通用的印地语实体识别模型；引用的人名、未知词语和结构化标识符仍会进行隐私扫描。

请参阅渠道账号与工作流指南，了解账号创建、回调注册、发送者关联和验证方法。本地线协议测试不能证明真实提供商账号能够成功投递。对于已连接的机器人，请复用现有 Telegram 连接；第二个连接不得覆盖其 webhook。只有在获得授权且没有任务排队或运行时，才能通过 Save settings 更改其目标地址。 请将真实模型推理与仅验证传输的工作流分开验证；除非一次投递同时证明两者均正常，否则不要声称 Telegram 到 Gemini 的完整流程已打通。

验收检查会验证实际答案以及最终状态。即使模型运行已完成且置信度很高，结果仍可能有误；请独立核对数值结果，并在诊断问题时保留 PII 保护措施。请参阅有界生产验收操作手册。

当前生产平台包括受治理的 Agent／工作流执行、含扫描文档 OCR 的文档导入、由提供商管理 STT／TTS 的签名 Twilio 语音、租户范围内的浏览器 RPA、Python 和 TypeScript SDK、MCP／A2A 接口，以及受限的 Shopify 到 OACP 商务运行时。有关已发布、依赖配置以及尚未发布内容的准确边界，请参阅当前产品状态。 外部操作始终需要明确授权。只有当目标租户具备所需凭据、权限范围、配置和提供方批准时，才能使用语音提供方、连接器、浏览器脚本、买家渠道、支付通道、商户系统或 POS 流程。

受治理的业务案例

此代码库包含一套受租户门控的业务入驻案例工作流，涵盖只读式提供方调查、附带引文的备忘录、确定性策略评分、筛查处置、人工审核和可审计的交接。只有在当前角色 Agent、已注册工具、准确的本地案例用途和委派授权均允许调用时，才会执行提供方调用。即使通用工具强制执行模式设为 off 或 warn，此案例专属检查仍会严格执行。

AgenticOrg 固定使用 grantex==0.7.1，并在调用其强制执行检查时传入授权令牌、连接器、工具以及任何数值金额。它不会传入案例 ID 或案例用途，因此此路径不会检查令牌的案例用途和每案例上限。角色的 case_purposes 列表是 AgenticOrg 本地控制项，池化授权不会绑定到某个案例。决策和分析师操作仍须由已登录的人类执行；API 密钥、Agent 令牌和 MCP 工具不能代替该人类操作。除非启用并完成配置，否则租户的案例运行时处于关闭状态。此处的源代码说明并不表示某个特定托管部署已启用此工作流。请参阅案例生命周期与设置、授权强制执行手册和决策请求。

发布前，可通过基于 Docker 的本地多渠道模拟一并测试语音、电子邮件、OCR 和浏览器 RPA。它使用全新的 PostgreSQL、本地 Mailpit 投递、真实 Tesseract，以及可选的真实 Playwright Chromium，同时避免付费调用和生产环境变更。

知识上传状态会区分提取与可搜索索引。启用可选的上传恢复功能后，临时的原生嵌入失败会在现有工作线程上重试；替换成功前，之前可搜索的副本会保留。格式错误的 PDF/Office 文件会在替换前被拒绝。有关状态含义、引文和恢复限制，请参阅知识库与 OCR。对于仅推理的 Agent，请禁用建议工具，并将工具/连接器选择留空；这不会绕过租户预算。提供方费用和配额仍然适用。请使用结构化输出提供置信度，保留审核阈值，并在任何测试支出额度中计入解释调用和提供方重试。有关有界验收步骤和可选的直接运行解释历史记录，请参阅创建 Agent和运行与聊天。

仪表板的近期活动会查询审计记录。单独的内部实时动态流管道会在事件发布时按租户持久化事件，并可在 WebSocket 中断后按序列重放这些事件。该管道唯一的写入方是对话监管控制台（默认关闭，由 AGENTICORG_CONVERSATION_V2_ENABLED 控制）；它会在对话屏幕上发布对话变更通知，但不包含消息文本。其他运维事件写入方未接入该管道。其浏览器组件会显示连接/追赶状态，但不展示原始载荷；它并未作为仪表板的实时流挂载。代理重连、有界套接字扇出和定期凭据重新验证均由本地测试覆盖。生产环境的延迟、吞吐量和可用性尚未测量。活动投递指南说明了这一边界。规模与韧性评估跟踪尚待完成的连接规模、负载和恢复工作；恢复指南则区分了计划目标与已验证的生产控制措施。

AI 支出智能分析

AI 支出智能分析会根据组织自身的架构，以卢比衡量 AI 支出。此功能默认关闭，由 AGENTICORG_SPEND_INTELLIGENCE_ENABLED 控制：关闭时，GET /api/v1/spend/status 返回 enabled: false，其他所有支出路由均返回 404，且不会计量任何数据。第一阶段仅提供 API；应用尚无支出界面。

部署启用此功能后，管理员会维护用于衡量支出的基准数据：组织树、来源映射、模型别名、按生效日期管理的费率卡（合同卡的优先级高于列表卡，包含缓存输入价格、用量阶梯和已存储但第一阶段尚未应用的批量折扣）、将所有价格换算为 INR 的汇率，以及承诺用量。每次计量的模型调用都会作为使用记录写入，并在服务端进行归属，按计费日期生效的费率卡定价（模型令牌则按部署的列表价格定价）；嵌入、OCR 页数、语音分钟数、按价格计费的工具调用、存储 GB-天数以及自有 GPU 节点小时数也会如此处理。每日汇总、包含未归属份额的覆盖率、计量缺口和经过审计的维护任务均基于这些记录。供应商发票按计费月份导入并核对，匹配容差为 1%；差异须由发票导入者以外的管理员提供原因后方可接受。GET /api/v1/spend/gate 会报告某个月的 Gate 1 状态：至少 98% 的 INR 支出归属于业务部门、部门、团队或成本中心，且不存在未定价、未换算或待处理汇率的记录；每家供应商的账目均须在 1% 以内完成核对。

flowchart TD
  flag{"AGENTICORG_SPEND_INTELLIGENCE_ENABLED"}
  flag -->|"off, the default"| off["Only GET /api/v1/spend/status answers, other spend routes are 404"]
  flag -->|"on"| ref["Reference data: organisation tree, source mappings, model aliases, rate cards, FX to INR, commitments"]
  usage["Model calls, embeddings, OCR pages, speech minutes, priced tool calls, storage GB-days, GPU node hours"] --> meter["Meter and writer: server-side attribution and pricing"]
  ref --> meter
  meter --> records["Usage records"]
  records --> rollups["Daily rollups, coverage and the unattributed share"]
  invoices["Imported provider invoices"] --> recon["Reconciliation per provider and billing month"]
  records --> recon
  recon -->|"outside the 1% match tolerance"| accept["Acceptance with a reason by a second administrator"]
  rollups --> gate(["Gate 1 status: at least 98% attributed and every provider within 1%"])
  recon --> gate

费率卡、承诺用量、价格、发票、核对结果和 Gate 仅向人工管理员或审计员开放。其他查看者只能查看按 Agent 可见性筛选后的使用数据，无法查看租户范围内的汇总数据。支出仪表板、预算、支出提醒、预测、报表和月结将在后续阶段推出。请参阅用户指南、功能参考和发布运行手册。

此存储库包含的内容

领域	当前实现
Agent 运行时	基于 FastAPI 和 LangGraph 的运行时，支持模型路由、工具调用、置信度处理、重试策略和持久化执行状态
Agent 编写	内置 Agent 定义、自定义 Agent、提示词模板、组织架构和无代码 UI
工作流	工作流定义、运行、计划、条件、审批和审计事件
治理	租户和角色边界、限定范围的工具、人工介入队列、影子评估、策略检查和紧急停用模式
集成	原生连接器注册表以及可选的集成网关；实际可用性取决于凭据、权限范围、提供商访问权限和租户配置
知识与渠道	原生及 OCR 文档摄取/搜索、报告、通知、经签名的 Twilio 语音通话、RPA 和其他已配置渠道
开发者访问	REST API、Python SDK 和 CLI、TypeScript SDK、MCP 服务、旧版 A2A 形态的任务 API，以及源代码实现的 A2A v1 HTTP+JSON 同步文本
商务	按商家范围限定的 Shopify 只读同步、OACP 制品接收/缓存、对买家安全的回答、公开目录界面、已准备的提供商或 POS 交接，以及由功能标志控制的 UCP 和 ACP 界面（ACP Feed、结账会话和订单事件）
运维	PostgreSQL、Redis、对象存储、可观测性钩子、迁移、安全检查和 Cloud Run 部署工具
AI 支出分析	默认关闭；仅限 API 的组织树、来源映射、费率卡、兑换为 INR 的汇率、承诺、模型调用及非 Token 使用的归属使用记录、每日汇总、覆盖率、发票对账、制作者-审核者验收流程，以及 Gate 1 状态

源代码中的定义并不能证明特定租户已连接提供商或启用写入权限。Connectors 页面现在会区分已注册的连接器与已配置的凭据，并显示近期、过期、失败或缺失的运行状况检查。这些证据无法验证提供商权限范围、API 合约覆盖率、持续同步情况或错误预算。连接器操作仍需经过批准的凭据、权限范围、策略和提供商可用性检查。

功能状态

平台中已实现

• Agent 定义和由租户创建的 Agent
• 通过经过身份验证的 API 执行 Agent 和工作流
• 人工审批队列和可配置的升级条件
• 受治理运行时活动的审计记录
• 提示词模板、组织架构和基于角色的应用视图
• 原生连接器定义和范围受限的工具网关
• 公开的 A2A 和 MCP 发现，以及经过身份验证的执行路径
• Python 和 TypeScript 客户端包，以及 MCP 服务包
• 托管计费限额和结账集成
• OACP 商务配置、Shopify 只读同步、制品缓存、买家渠道和安全交接准备

依赖配置或受提供商限制

• LLM 调用需要配置受支持的模型提供方或本地模型运行时。
• 每个连接器都需要提供方凭据、租户授权和相关权限范围。请参阅连接器设置指南，了解原生注册表名称、凭据字段、健康检查以及受发布控制的目录预填充。注册了一条记录并不能证明已连接到正常运行的提供方。
• Composio 是可选的集成网关；其目录与原生连接器注册表并不相同。
• 生产镜像内置了 Tesseract、Poppler 和 LibreOffice，用于文档 OCR。请参阅知识摄取。
• 生产语音路径使用带签名的 Twilio Webhook、由提供方管理的 STT/TTS，以及加密的转录文本存储。请参阅语音运行时。
• Jev/System One 支持已实现为仅提供建议、可进入影子模式的集成，但 TypeSafe 目前不接受新用户注册。获得 TypeSafe 访问权限并批准经过测量的评估之前，生产环境仍保持 off。请参阅Jev 集成。
• 公开的评估页面提供只读的 Jev 影子计划：合成语料覆盖、有界采样和预算控制，以及明确的审查关卡。它不会调用 Jev，也不会启用主动路由。
• 经过测量的 Jev 影子运行器需显式在本地运行：python scripts/run_jev_shadow_evaluation.py --dry-run；--live 需要 TypeSafe 签发的 TYPESAFE_API_KEY、有界关卡以及经运营人员批准的输出路径。不要编造、提交或将密钥粘贴到代码库中。
• 浏览器自动化包含按租户限定范围的脚本、计划任务、持久化历史记录， 以及已批准域名的出站访问控制。运行仍是一项明确的外部 操作。请参阅 RPA 运行时。
• 出站通知和本地模型配置文件需要相应的支持服务。
• UCP 商业档案（/.well-known/ucp，UCP 2026-04-08 和 2026-08-25）默认关闭（AGENTICORG_UCP_PROFILE_ENABLED），包含目录搜索 和查询以及门店位置。只有在经过 DNS 证明的服务主机上，且商家选择加入、 Grantex 签发启用的 public_discovery_state 产物后，才会为该商家提供服务。请参阅 UCP 商业档案。
• UCP 结账会话、购物车和订单（/ucp/checkout-sessions、/ucp/carts、/ucp/orders、 AGENTICORG_UCP_CHECKOUT_ENABLED）默认关闭。启用标志后，Complete 需要商务仲裁器针对确切会话作出 allow 决策，并且需要已注册的执行器。只有在 PLURAL_PINE_LIVE_EXECUTION_ENABLED=true 时，才会注册 Plural 执行器 （扣款、退款、采用 RBI AFA 的 UPI AutoPay）；否则 Complete 会返回 executor_unavailable。来自 Grantex、经服务器验证的 Intent、Cart 和 Payment 授权需要启用 AGENTICORG_GRANTEX_MANDATES_ENABLED。请参阅 UCP 结账、购物车和订单、 Plural 执行器和授权。
• ACP 商品 Feed（AGENTICORG_ACP_FEED_ENABLED）和 ACP 结账会话 （AGENTICORG_ACP_CHECKOUT_ENABLED，API 版本 2026-04-17）默认关闭。Feed 仅由经过验证且仍有效的 OACP 产物构建；会话使用 UCP 会话表、仲裁器和执行器运行，并需要商家选择加入、 Grantex 的委托付款许可以及已注册的执行器（Plural 执行器默认关闭）。请参阅 ACP 商品 Feed 和结账会话。
• Agent 请求签名（RFC 9421、Visa Trusted Agent Protocol 和 Web Bot Auth 配置文件）默认以 log 模式在公开商务读取接口和 A2A 路由上验证 （AGENTICORG_HTTPSIG_VERIFY_MODE=enforce 会拒绝商务 API 接口上的无签名请求： 目录和商品 JSON，以及 A2A 路由，但绝不包括公开页面）；只有设置 AGENTICORG_HTTPSIG_SIGN_OUTBOUND 时，买方连接器才会使用租户 Agent 密钥为其请求签名。该库 （grantex-agent-httpsig 0.2.0，未发布到 PyPI）通过固定到特定提交的 Git 引用从 Grantex 代码库安装，因此安装需要 git。请参阅 Agent 请求签名。
• AI 支出智能功能默认关闭。在 API、worker 和 beat 服务上设置 AGENTICORG_SPEND_INTELLIGENCE_ENABLED 之前，不会计量任何内容。归因遵循组织树以及租户管理员填写的映射；价格来自租户费率卡，否则使用部署的模型 Token 标价， 并根据租户的外汇汇率换算为 INR。请遵循 发布与启用操作手册。
• 许多治理和 BFSI 服务已包含在源代码中，但默认关闭，每项服务均由各自的 AGENTICORG_* 设置控制：模型网关、护栏钩子与强制执行、操作员覆盖、 驻留地强制执行、审计链、追踪与合成检查、运行时限制与记忆、 可视化工作流构建器、提示词创建者审核与比较、评估数据集与晋级关卡、 Agent 注册表、治理清单与模型卡、FinOps 归因、阈值与预测、 对话服务、内容服务、文档处理、工作台、语音与 交易智能、数据沿袭与个性化。默认安装不会启用其中任何一项。 请参阅功能开关表和 默认关闭的界面指南。
• SSO、SCIM、企业支持和自定义 SLA 取决于套餐和部署配置。
• WhatsApp、Telegram、支付提供方、银行、POS 和商家系统工作流需要完成提供方设置，并配置经过验证的回调或适配器。
• WooCommerce、ERP、PIM、OMS、WMS、自定义商务 API 和其他支付渠道可以记录为适配器就绪配置，但在获得批准的适配器之前，不会标记为有效的执行路径。

明确的非目标与边界

• OACP 工件不会创建订单、预留库存、创建付款授权、扣款、退款，也不能证明付款已完成。
• 没有任何请求字段会批准商务执行。执行需要消费确定性商务仲裁器给出的一次性 allow 决策，并且唯一的付款执行器（Plural）默认关闭。
• AgenticOrg 不会取代商家、银行、支付服务提供商、POS 或 SaaS 系统，成为其记录来源。
• 缓存的商务证据可用于回答问题或准备交接；由服务提供商负责的执行操作必须由该服务提供商确认。
• 在源代码中列出的连接器，并不能证明已与实际客户完成集成。
• 示例工作流和编辑内容不构成性能保证。
• 仓库中的安全控制并不意味着已获得第三方认证。

运行时的组成方式

浏览器或 SDK
    |
    v
React 19 应用 / FastAPI API
    |
    +-- 身份验证、租户上下文、角色和范围
    +-- Agent 注册表与 LangGraph 执行
    +-- 工作流引擎、计划任务和审批队列
    +-- 工具网关与连接器适配器
    +-- 审计、评估、可观测性和成本记录
    |
    +-- PostgreSQL / Cloud SQL
    +-- Redis
    +-- GCS 或兼容的对象存储
    +-- 已配置的大模型和外部服务提供商

托管生产路径在 Google Cloud Run 上运行独立的 API 和 UI 服务。Artifact Registry 镜像固定到提交版本，发布前可以运行迁移，并且流量切换是显式的。旧版 Kubernetes 资料不属于当前生产路径。

OACP 商务边界

AgenticOrg 负责 OACP 支持的商务流程中买家和卖家 Agent 的运行时。Grantex 负责信任权威、协议和策略治理、规范制品及其签名密钥，以及适配器授权。AgenticOrg 会先验证每个 Grantex 制品，再将其缓存。Shopify 和商家系统仍是运营记录的来源。Pine Labs Plural/P3P、银行、POS 系统和支付提供商负责各自的执行通道。

当前支持的来源路径如下：

1. 商家保存按租户、商家、店铺和卖家 Agent 限定范围的配置。
2. AgenticOrg 通过获批的保管路径存储 Shopify 凭据。
3. AgenticOrg 执行只读的 Shopify Admin GraphQL 同步。
4. 将可公开的安全证据提交至配置的 Grantex 权威路径。
5. 缓存每个已签发的 OACP 制品之前，都会对其进行验证：根据配置中固定的 Grantex JWKS 验证其 ES256 分离式 JWS、检查其范围和 TTL，并检查其 Token Status List 条目。在严格运行时中，任一项失败都会拒绝整个签发（AGENTICORG_OACP_VERIFY_STRICT，默认开启）；其他环境会将失败记录为异常，并在没有验证器引用的情况下缓存制品。严格验证要求 Grantex 环境以这种方式签署制品、发布一个 oacp- 密钥并提供其状态列表；截至 2026-10-20，Grantex 生产环境已完成这三项。请参阅 docs/oacp/artifact-cache-guide.md。
6. 买家界面依据有效制品作答，并披露来源和新鲜度。
7. 购买意向会转交给提供商、商家或 POS 执行，但不会触发实际执行；否则会被安全拒绝。确定性商务仲裁器会评估每次转交（授权、同意、Commerce Passport 限额、已验证且新鲜的制品、商家限额），并确定 allow 或 refuse；它不会等待人工处理。执行会使用与确切转交载荷绑定的单次 allow decision_id。每次商务写入都会在 audit_log 中留下 HMAC 签名的账本行；为租户启用审计链封存后，账本行还会通过哈希链链接（AGENTICORG_AUDIT_CHAIN_DEFAULT_ON，默认关闭）。在存在服务器验证的授权之前，严格运行时会拒绝调用方声称的买家权限（AGENTICORG_ARBITER_REQUIRE_VERIFIED_AUTHORITY）；只有 Grantex 共同签署后，allow 才可使用（AGENTICORG_ARBITER_REQUIRE_GRANTEX_GRANT）。租户管理员可通过 /api/v1/commerce/runtime/ledger 读取账本、为决策添加注释、存储审查清单和保留处置记录；scripts/verify_ledger.py 可离线验证账本导出。请参阅 docs/oacp/arbiter-ledger.md。
8. Agent 平台可使用商家的 UCP 商业资料、UCP 结账会话和 ACP 结账会话，这些会话均由通过 DNS 证明的服务主机提供，且各自有独立的功能标志（默认关闭）。它们共用同一个会话表、相同的仲裁器 session_complete 决策和同一个执行器。
9. 只有经过验证的提供商或商家回调才能确认外部结果。

调用公开商务读取接口和 A2A 路由的 Agent 可根据 Visa Trusted Agent Protocol 或 RFC 9421 的 Web Bot Auth 配置文件对请求签名；AgenticOrg 会验证这些签名，记录已验证的 Agent 身份（写入时记录在商务账本中），并在设置 AGENTICORG_HTTPSIG_VERIFY_MODE=enforce 时，拒绝商务 API 界面上未经签名的请求（公开 HTML 页面、站点地图和 llms.txt 仍可公开访问）。请参阅 docs/oacp/agent-request-signing.md。

截至 2026-10-20，所有这些内容都已合入 main，AgenticOrg 生产环境的部署将紧随其后；依赖这些功能之前，请先检查已部署的提交。请从 docs/oacp/README.md 和 运行时发布闭环 PRD 开始。

要求

• Python 3.12 或更高版本
• Node.js 22.22 或更高版本（UI 的路由器需要此版本；CI 使用 22.22.0）
• Docker 和 Docker Compose，用于在本地运行 PostgreSQL 和 Redis
• 至少一个受支持的 LLM 提供商密钥，或已配置的本地模型运行时，以执行依赖模型的任务

UI 目前使用 React 19。依赖项版本在 pyproject.toml 和 ui/package.json 中声明。

本地开发

克隆并配置代码仓库：

git clone https://github.com/mishrasanjeev/agentic-org.git
cd agentic-org
cp .env.example .env

安装平台和开发附加依赖：

python -m venv .venv
python -m pip install -e ".[v4,dev]"
python -m pip install --no-deps --require-hashes -r requirements-fastembed.txt

第二条命令会安装本地嵌入运行时 fastembed，但不安装其依赖元数据；其中的原因见 requirements-fastembed.txt。

启动本地依赖服务：

docker compose up -d postgres redis minio

运行迁移并启动 API。AGENTICORG_ENV 必须设置在 shell 环境中，而不能只设置在 .env 中：凭据保险库会读取进程环境；如果运行环境不是 local、dev、development、test 或 CI，它会在未配置真实保险库密钥时拒绝启动。

export AGENTICORG_ENV=development
python scripts/alembic_migrate.py
uvicorn api.main:app --host 0.0.0.0 --port 8000 --reload

在另一个终端中安装并运行 UI：

cd ui
npm ci
npm run dev

不要在预发布或生产环境中使用示例密钥。请通过经批准的密钥管理方式配置真实密钥。

可选的 Compose 配置文件包含本地 CPU/GPU 模型运行时，以及支持 RAG 或语音的服务。启用配置文件前，请查看 docker-compose.yml，因为不同功能对硬件、镜像和凭据的要求各不相同。

公共 API 和协议

除标准根 A2A Agent Card 发现路径外，应用 API 路由均挂载在 /api/v1 下方。

接口	用途	身份验证方式
GET /api/v1/health	服务运行状况	公开
GET /api/v1/product-facts	实时版本和注册表总数	公开
GET /.well-known/agent-card.json	A2A v1 通用 Agent Card（发布并配置入口后）	公开
GET /.well-known/ucp, POST /ucp/catalog/search, /ucp/catalog/lookup, /ucp/locations/*	商家已验证服务主机上的 UCP 商家资料、目录和位置（默认关闭）	公开，绑定主机
POST /ucp/checkout-sessions, GET/PUT /ucp/checkout-sessions/{id}, /complete, /cancel; /ucp/carts; GET /ucp/orders/{id}	商家已验证服务主机上的 UCP 结账、购物车和订单（默认关闭）	发放给 Agent 平台的租户 API 密钥（ucp:read / ucp:write）
POST /acp/checkout_sessions, GET/POST /acp/checkout_sessions/{id}, /complete, /cancel	商家已验证服务主机上的 ACP 结账会话（默认关闭）	发放给 Agent 平台的租户 API 密钥（acp:read / acp:write）
GET /api/v1/a2a/extendedAgentCard	商家专属卖家卡片	商家发放的买家凭证；验证 Agent 的 RFC 9421 签名（记录日志，或在 enforce 模式下设为必需）
POST /api/v1/a2a/message:send	A2A v1 同步文本请求	用于卖家问答的买家凭证，或用于非电商 Agent 的限定范围租户凭证；验证 Agent 的 RFC 9421 签名（记录日志，或在 enforce 模式下设为必需）
GET /api/v1/public/commerce/sellers/{merchant_id}/...	面向买家公开且安全的卖家页面、目录、产品、schema.org、站点地图和 llms.txt（需商家选择启用）	公开；验证 Agent 的 RFC 9421 签名（记录日志，或在 enforce 模式下设为必需）
GET /api/v1/a2a/agent-card	旧版 AgenticOrg 发现卡片；不是 A2A v1	公开
GET /api/v1/a2a/.well-known/agent.json	旧版发现别名；不是 A2A v1	公开
GET /api/v1/mcp/tools	兼容 MCP 的 Agent 发现	公开
Agent、工作流、工具、计费和电商相关变更操作	租户操作	需通过身份验证并限定范围

部署启用后，可通过 API 服务访问交互式 OpenAPI 文档。详细路由清单见 docs/route_inventory.json，API 说明文档见 docs/api-reference.md。

外部买家 Agent 无需运行在 AgenticOrg 上。商家可以向任何 A2A v1 HTTP+JSON 客户端发放可撤销、限定范围的买家凭证，而卖家答复仍不具约束力，且来源于 OACP 缓存。关于确切的身份限制、SDK 调用、迁移／入口要求以及不支持的传输方式，请参阅 A2A 互操作指南。本仓库中的实现并不表示任何具名买家平台已安装或认可 AgenticOrg。

Python SDK 和 CLI

请参阅 sdk/README.md。

pip install agenticorg
agenticorg agents list
agenticorg a2a card

SDK 0.4.0 涵盖 Agent、工作流、连接器诊断、知识／OCR、语音、RPA、本地桥接和卖家电商运行时。外部操作方法（例如外呼、RPA 运行、连接器同步和桥接路由）仍需显式调用，并且仍需经过租户授权。服务器功能可能需要比已安装客户端更新的部署版本，因此使用者应查看软件包和服务器的发行说明。

TypeScript SDK

请参阅 sdk-ts/README.md。

npm install agenticorg-sdk

TypeScript 0.4.0 的资源范围与 Python 运行时覆盖范围一致，包括知识／OCR、语音、RPA、桥接和电商准备 API。

MCP 服务

请参阅 mcp-server/README.md。

npx agenticorg-mcp-server

MCP 软件包提供受治理的 AgenticOrg Agent 和商业发现界面。它不会授予 MCP 客户端对所有连接器操作的无限制访问权限。

对于反向流程，连接器 > 远程 MCP 会注册一个由租户拥有的 HTTPS Streamable HTTP 服务，并使用加密的 bearer 凭证，发现其工具， 再与 Agent 选择和运行时分发共享持久化目录。 经过审核的读取工具可在授权和操作策略约束下执行；写入操作则仍受到限制。发现结果并不能证明上游提供商具备所有能力。 请参阅连接、审核、探测和 Agent 运行工作流。

定价和限额

托管计划的事实来源是 core/billing/catalog.py 中的类型化 PUBLIC_PLAN_CATALOG。core/billing/limits.py 中的兼容视图由该目录派生。

计划	USD 标价	INR 标价	Agent 数量	运行次数	存储空间
Free	$0/month	INR 0/month	3	1,000/month	1 GB
Pro	$99/month	INR 9,999/month	15	10,000/month	50 GB
Enterprise	$499/month	INR 49,999/month	Unlimited	Unlimited	Unlimited

本平台采用 Orchestrum Personal Use License 1.0 授权；任何组织自行托管或为其托管都需要与 Orchestrum Technologies LLP 签署协议（请参阅许可证）。基础设施、模型提供商、外部 API、支付提供商和支持服务的费用均不包含在软件许可费用中。

安全与治理

代码库包含：

• 针对受保护 API 操作的租户、角色和范围检查
• 可配置的人工审批以及置信度或策略门控
• 有范围限制的连接器工具和集中式工具网关
• 连接器和云凭证的密钥引用模式
• 在模型调用前及日志中的可配置 PII 脱敏
• 通过 PyJWT 进行 JWT 验证，并提供加密支持
• 速率限制、安全标头和身份验证状态控制
• 依赖项、静态分析、容器和回归安全检查
• 受治理操作的审计和可观测性记录
• 失败时关闭的 OACP 新鲜度、撤销和提供商边界检查

生产环境的安全性取决于正确的部署配置、密钥保管、提供商设置、租户策略和运维监控。请通过 SECURITY.md 报告漏洞；如果怀疑存在漏洞，请勿创建公开 issue。

测试

要完整地在本地通过 Docker 重放，请依次运行 make dev、make check、make test、 make seed、make seed-cases，然后运行 AGENTICORG_E2E_REQUIRE_GOVERNED_CASES=true make e2e。工具镜像使用与运行时相同的 Python 3.14；两个浏览器运行器都必须与锁定的 Playwright 版本一致。请参阅 本地快速入门，了解隔离的测试数据库、合成提供商测试固件和决策授权浏览器检查。

后端：

pytest

可按目录或文件运行针对性的后端检查：

pytest tests/unit
pytest tests/regression
pytest tests/connector_harness

前端：

cd ui
npm ci
npm run lint
npm run typecheck
npm test
npm run build

浏览器测试：

cd ui
npx playwright test

Playwright 测试套件需要目标应用，以及任何有文档说明的测试凭证或测试固件。CI 工作流文件 在 .github/workflows 下 是各事件运行哪些测试套件的事实来源；README 并未声称每次推送都会运行所有 E2E 测试套件。

生产部署

当前的托管式部署助手面向 Google Cloud Run：

bash scripts/deploy_cloud_run.sh --sha <commit-sha> --yes

常用模式包括：

bash scripts/deploy_cloud_run.sh --sha <commit-sha> --skip-build --with-migrations --yes
bash scripts/deploy_cloud_run.sh --sha <commit-sha> --skip-build --traffic preserve --yes
bash scripts/deploy_cloud_run.sh --sha <commit-sha> --dry-run

该助手要求检出状态干净，且 SHA 与部署 SHA 完全一致；它会暂存特定版本的镜像、验证镜像和提交元数据、支持优先执行迁移的部署、探测运行状况，并根据所选模式切换流量。使用生产凭据前，请阅读脚本帮助信息和 docs/deployment.md。

脚本默认将 Cloud Run 服务部署到 asia-southeast1，并将 Artifact Registry 部署到 asia-south1。两者均可配置。较早的 Kubernetes 资料仅为历史参考或替代部署场景而保留。

仓库目录结构

api/                 FastAPI 应用和版本化路由
auth/                身份验证和授权中间件
core/                Agent 运行时、模型、计费、商务和编排
connectors/          原生连接器实现和框架
workflows/           工作流定义和运行时辅助工具
sdk/                 Python SDK 和命令行
sdk-ts/              TypeScript SDK
mcp-server/          MCP 服务包
ui/                  React 19 应用和公共 Web 资源
migrations/          数据库迁移
observability/       指标、跟踪和日志记录辅助工具
tests/               后端单元、回归、安全和集成测试
ui/e2e/              Playwright 浏览器测试
docs/                产品、架构、运维和协议文档
scripts/             验证、迁移、发布和部署辅助脚本

搜索和问答引擎资源

公共网站包含常见的搜索和问答引擎发现资源：

• robots.txt
• sitemap.xml
• llms.txt
• llms-full.txt
• 各路由的标题、描述、规范链接、社交元数据和结构化数据
• 可抓取的博客、资源、产品、协议、解决方案、信任和法律页面

这两个 llms 文件由 ui/scripts/generate-llms.mjs 生成。它们是补充性的机器可读导航文档，不能替代可抓取的 HTML、准确的结构化数据、robots 控制或站点地图。

要刷新已跟踪的站点地图和 llms 副本，以及路由 JSON-LD CSP 哈希：

cd ui
npm run seo:sync
npm run seo:verify

文档

• 最终用户手册：首个 Agent、日常操作和 BFSI 操作手册。界面会在 agenticorg.ai/docs 展示相同的 Markdown 内容，并提供全文搜索、可视化流程、便于打印的指南和移动端导航。docs.agenticorg.ai 别名已配置 Cloud DNS 和托管 HTTPS；托管和验证说明见文档运维手册。
• BFSI 功能覆盖范围和未解决问题说明已实现、部分实现或不可用的内容，并提供验证场景和产品边界。
• 公开的 BFSI 能力状态以通俗易懂的语言概述了同一评估结果，包括尚未完成的工作。
• 文档、对话、通话和工作台介绍了默认关闭的服务所对应的控制台界面，以及启用各项服务所需的设置。
• 文档站点发布和子域名运维手册
• 营销咨询交付、SMTP 设置和受保护的模型支出 还介绍了默认关闭的 Grantex 联系表单转交流程，不涉及销售 Agent 执行。
• 文档主页
• 当前产品状态
• 架构
• API 参考
• 部署
• AI 支出智能用户指南、功能参考和推出与启用运维手册
• 知识导入和 OCR
• 本地语音、电子邮件、RPA 和 OCR 模拟
• 语音运行时
• RPA 运行时
• OACP 运行时文档
• 外部 A2A 买家和卖家访问
• 本地合成卖家和独立 A2A 买家演示
• 商家与外部买家之间的 A2A 商务引导流程
• 生产环境冒烟测试运维手册
• 测试指南
• Python SDK
• TypeScript SDK
• MCP 服务
• 变更日志
• 路线图

文档主页会标明当前、依赖配置、历史和目标设计内容。带日期的审计、旧版 PRD 和增量实现报告仍有参考价值，但不能取代当前代码、OpenAPI、运维手册、留存的发布证据或实时产品事实。

贡献

请阅读 CONTRIBUTING.md 和 CODE_OF_CONDUCT.md。请让拉取请求聚焦于特定内容，为行为变更添加测试，并在事实来源字段发生变化时更新生成的公开文档。

许可和商标

平台：Orchestrum Personal Use License 1.0（LICENSE）。仅个人使用免费；任何组织都需要与 Orchestrum Technologies LLP 签署协议（COMMERCIAL-LICENSE.md、[email protected]）。 SDK（sdk/、sdk-ts/）和 MCP 服务（mcp-server/）：Apache License 2.0，可免费用于任何用途。 商标：TRADEMARKS.md。概述、变更日期和第三方材料： LICENSING.md 以及上文的许可部分。