financial-services CMA部署FAQAPI密钥、MCP URL环境变量与beta头问题完整指南【免费下载链接】financial-services项目地址: https://gitcode.com/GitHub_Trending/fi/financial-servicesfinancial-services是 Claude 官方的金融服务智能体仓库为投资银行、股票研究、私募股权和财富管理提供即装即用的 Agent。其中Claude Managed AgentsCMA部署常让人卡在三个地方ANTHROPIC_API_KEY怎么配、GL_MCP_URL这类 MCP URL 环境变量是干什么的、以及请求头里的anthropic-beta为什么有两种值。本文以 FAQ 形式带你快速解决 CMA 部署中的全部高频问题。部署前须知3 个前置条件CMA 部署统一由scripts/deploy-managed-agent.sh完成它会自动解析 manifest、上传技能、创建子智能体最后POST /v1/agents。开始前请确认条件说明bash 环境脚本以set -euo pipefail运行任何一步失败都会立即退出jqpython3pyyaml用于把 YAML manifest 转成 API payload缺失会直接报错正确的 agent slug如gl-reconciler对应managed-agent-cookbooks/下的目录git clone https://gitcode.com/GitHub_Trending/fi/financial-servicesFAQ 1API 密钥 ANTHROPIC_API_KEY 应该怎么设置A部署前用环境变量导出即可脚本会在每次请求中以x-api-key请求头带上它export ANTHROPIC_API_KEYsk-ant-...注意两点未设置会直接报错退出脚本第 22 行有硬性校验会提示ANTHROPIC_API_KEY must be set。可以切换 API 入口脚本通过ANTHROPIC_API_BASE控制请求地址默认为 Anthropic 官方 API如果你的机构走内部 LLM 网关只需export ANTHROPIC_API_BASE网关地址无需改脚本。⚠️ 密钥只应存在于环境变量或 CI/CD 的 Secret 中不要写进仓库文件——仓库是纯 markdown/YAML 的引用模板没有任何配置入口来存储密钥。FAQ 2GL_MCP_URL 这类 MCP URL 环境变量是干什么的这是新手最容易困惑的地方。它不是 Anthropic 的密钥而是你司数据源的 MCP 服务器地址总账、子账、CapIQ、Daloopa 等。A原理在部署脚本的yaml2json()函数中manifestagent.yaml里可以写${GL_MCP_URL}这样的占位符脚本在发送前会把环境变量值替换进去。以 GL Reconciler 为例见managed-agent-cookbooks/gl-reconciler/README.mdexport ANTHROPIC_API_KEYsk-ant-... export GL_MCP_URL... # 只读总账 MCP export SUBLEDGER_MCP_URL... # 只读子账 MCP scripts/deploy-managed-agent.sh gl-reconciler各 Agent 需要的 MCP URL 环境变量示例Agent需导出的 MCP URL 环境变量用途gl-reconcilerGL_MCP_URL、SUBLEDGER_MCP_URL总账/子账对账model-builderCAPIQ_MCP_URL、DALOOPA_MCP_URL拉取财务建模数据两个容易踩的坑环境变量值只允许安全字符[A-Za-z0-9._/:-]。如果你的 MCP 地址带?、、#比如 query 参数替换会被脚本拒绝——这是防止注入的保护建议用网关转一层或用无 query 的地址。占位符不会自动消失没设置的变量会原样保留在 payload 里Agent 上线后连数据源会失败。部署前可先用--dry-run见 FAQ 4检查。各数据供应商的标准 MCP URL 汇总在plugins/vertical-plugins/financial-analysis/.mcp.json可直接参考。FAQ 3请求头里的 anthropic-beta 为什么有两种值A因为 CMA 涉及两个不同的 beta 端点各自要求不同的 beta 头脚本已替你处理好见scripts/deploy-managed-agent.sh第 33-36 行和第 76-81 行端点beta 头说明POST /v1/agentsanthropic-beta: managed-agents-2026-04-01创建/更新托管 AgentJSON 请求体POST /v1/skillsanthropic-beta: skills-2025-10-02上传技能包multipart/form-data 格式常见问题为什么不能只带一个头两个端点的 beta 协议版本独立演进互相不兼容必须分别携带。为什么官方 SDK 里找不到这些方法CMA 目前是Research Preview研究预览能力SDK 类型定义尚未覆盖/v1/agents相关调用需要在代码里容忍类型缺失参考scripts/orchestrate.py的用法。手动调用时别漏了版本头除anthropic-beta外还需固定带上anthropic-version: 2023-06-01。FAQ 4部署报错怎么办先跑 --dry-runA部署脚本内置干跑模式不发任何请求、不要求 API 密钥只会打印出最终会提交的 payload子智能体在前编排者最后scripts/deploy-managed-agent.sh gl-reconciler --dry-run用它能一次性排查manifest 的system.file路径是否可达、skills路径是否存在、${MCP_URL}占位符是否被正确替换、callable_agents是否解析成功。其他高频报错速查报错原因与解法no manifest at .../agent.yamlslug 拼错目录必须在managed-agent-cookbooks/下requires jq/requires python3 pyyaml缺少依赖安装后重试skill path not foundmanifest 中的path相对路径解析不到检查是否移动过目录cannot derive REPO_SLUG在非 git 检出目录运行时手动export REPO_SLUG你的仓库名FAQ 5如何验证部署成功并驱动 AgentA部署成功后脚本会输出三样东西agent id后续 steering 事件要用cookbook标签仓库/agent-slug用于溯源console 链接在控制台中直接查看该 Agent拿到 id 后按各 cookbook 的steering-examples.json发送 steering 事件即可开工例如 gl-reconciler 的事件格式是Reconcile GL vs subledger, trade date D, classes: list。多个 Agent 之间不直接互相调用——源 Agent 在输出中发出handoff_request由你自己的工作流引擎Temporal/Airflow 等路由过去仓库提供的scripts/orchestrate.py是可替换的参考实现内置了目标白名单和 payload schema 校验。FAQ 6callable_agents 子智能体有什么限制A目前子智能体委派只支持一层编排者可以调用 workerworker 不能再调子智能体。且安全设计上只允许一个 worker 持有Write工具各 Agent 的 README 中有完整安全分层表部署时不必也不应该自行放宽。总结一张表记住 3 个核心点问题关键答案API 密钥export ANTHROPIC_API_KEYsk-ant-...可加ANTHROPIC_API_BASE切网关只放环境变量MCP URL 环境变量是数据源地址GL_MCP_URL等脚本自动替换进 manifest值只能含安全字符beta 头/v1/agents用managed-agents-2026-04-01/v1/skills用skills-2025-10-02脚本已自动携带配好这三项后一条scripts/deploy-managed-agent.sh slug即可把参考模板部署到你自己的工作流引擎后面——同一个 Agent同一套技能跑在哪里由你决定。更多 Agent 清单见仓库主文档 README.md。【免费下载链接】financial-services项目地址: https://gitcode.com/GitHub_Trending/fi/financial-services创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 financial-services CMA部署FAQ：API密钥、MCP URL环境变量与beta头问题完整指南
financial-services CMA部署FAQAPI密钥、MCP URL环境变量与beta头问题完整指南【免费下载链接】financial-services项目地址: https://gitcode.com/GitHub_Trending/fi/financial-servicesfinancial-services是 Claude 官方的金融服务智能体仓库为投资银行、股票研究、私募股权和财富管理提供即装即用的 Agent。其中Claude Managed AgentsCMA部署常让人卡在三个地方ANTHROPIC_API_KEY怎么配、GL_MCP_URL这类 MCP URL 环境变量是干什么的、以及请求头里的anthropic-beta为什么有两种值。本文以 FAQ 形式带你快速解决 CMA 部署中的全部高频问题。部署前须知3 个前置条件CMA 部署统一由scripts/deploy-managed-agent.sh完成它会自动解析 manifest、上传技能、创建子智能体最后POST /v1/agents。开始前请确认条件说明bash 环境脚本以set -euo pipefail运行任何一步失败都会立即退出jqpython3pyyaml用于把 YAML manifest 转成 API payload缺失会直接报错正确的 agent slug如gl-reconciler对应managed-agent-cookbooks/下的目录git clone https://gitcode.com/GitHub_Trending/fi/financial-servicesFAQ 1API 密钥 ANTHROPIC_API_KEY 应该怎么设置A部署前用环境变量导出即可脚本会在每次请求中以x-api-key请求头带上它export ANTHROPIC_API_KEYsk-ant-...注意两点未设置会直接报错退出脚本第 22 行有硬性校验会提示ANTHROPIC_API_KEY must be set。可以切换 API 入口脚本通过ANTHROPIC_API_BASE控制请求地址默认为 Anthropic 官方 API如果你的机构走内部 LLM 网关只需export ANTHROPIC_API_BASE网关地址无需改脚本。⚠️ 密钥只应存在于环境变量或 CI/CD 的 Secret 中不要写进仓库文件——仓库是纯 markdown/YAML 的引用模板没有任何配置入口来存储密钥。FAQ 2GL_MCP_URL 这类 MCP URL 环境变量是干什么的这是新手最容易困惑的地方。它不是 Anthropic 的密钥而是你司数据源的 MCP 服务器地址总账、子账、CapIQ、Daloopa 等。A原理在部署脚本的yaml2json()函数中manifestagent.yaml里可以写${GL_MCP_URL}这样的占位符脚本在发送前会把环境变量值替换进去。以 GL Reconciler 为例见managed-agent-cookbooks/gl-reconciler/README.mdexport ANTHROPIC_API_KEYsk-ant-... export GL_MCP_URL... # 只读总账 MCP export SUBLEDGER_MCP_URL... # 只读子账 MCP scripts/deploy-managed-agent.sh gl-reconciler各 Agent 需要的 MCP URL 环境变量示例Agent需导出的 MCP URL 环境变量用途gl-reconcilerGL_MCP_URL、SUBLEDGER_MCP_URL总账/子账对账model-builderCAPIQ_MCP_URL、DALOOPA_MCP_URL拉取财务建模数据两个容易踩的坑环境变量值只允许安全字符[A-Za-z0-9._/:-]。如果你的 MCP 地址带?、、#比如 query 参数替换会被脚本拒绝——这是防止注入的保护建议用网关转一层或用无 query 的地址。占位符不会自动消失没设置的变量会原样保留在 payload 里Agent 上线后连数据源会失败。部署前可先用--dry-run见 FAQ 4检查。各数据供应商的标准 MCP URL 汇总在plugins/vertical-plugins/financial-analysis/.mcp.json可直接参考。FAQ 3请求头里的 anthropic-beta 为什么有两种值A因为 CMA 涉及两个不同的 beta 端点各自要求不同的 beta 头脚本已替你处理好见scripts/deploy-managed-agent.sh第 33-36 行和第 76-81 行端点beta 头说明POST /v1/agentsanthropic-beta: managed-agents-2026-04-01创建/更新托管 AgentJSON 请求体POST /v1/skillsanthropic-beta: skills-2025-10-02上传技能包multipart/form-data 格式常见问题为什么不能只带一个头两个端点的 beta 协议版本独立演进互相不兼容必须分别携带。为什么官方 SDK 里找不到这些方法CMA 目前是Research Preview研究预览能力SDK 类型定义尚未覆盖/v1/agents相关调用需要在代码里容忍类型缺失参考scripts/orchestrate.py的用法。手动调用时别漏了版本头除anthropic-beta外还需固定带上anthropic-version: 2023-06-01。FAQ 4部署报错怎么办先跑 --dry-runA部署脚本内置干跑模式不发任何请求、不要求 API 密钥只会打印出最终会提交的 payload子智能体在前编排者最后scripts/deploy-managed-agent.sh gl-reconciler --dry-run用它能一次性排查manifest 的system.file路径是否可达、skills路径是否存在、${MCP_URL}占位符是否被正确替换、callable_agents是否解析成功。其他高频报错速查报错原因与解法no manifest at .../agent.yamlslug 拼错目录必须在managed-agent-cookbooks/下requires jq/requires python3 pyyaml缺少依赖安装后重试skill path not foundmanifest 中的path相对路径解析不到检查是否移动过目录cannot derive REPO_SLUG在非 git 检出目录运行时手动export REPO_SLUG你的仓库名FAQ 5如何验证部署成功并驱动 AgentA部署成功后脚本会输出三样东西agent id后续 steering 事件要用cookbook标签仓库/agent-slug用于溯源console 链接在控制台中直接查看该 Agent拿到 id 后按各 cookbook 的steering-examples.json发送 steering 事件即可开工例如 gl-reconciler 的事件格式是Reconcile GL vs subledger, trade date D, classes: list。多个 Agent 之间不直接互相调用——源 Agent 在输出中发出handoff_request由你自己的工作流引擎Temporal/Airflow 等路由过去仓库提供的scripts/orchestrate.py是可替换的参考实现内置了目标白名单和 payload schema 校验。FAQ 6callable_agents 子智能体有什么限制A目前子智能体委派只支持一层编排者可以调用 workerworker 不能再调子智能体。且安全设计上只允许一个 worker 持有Write工具各 Agent 的 README 中有完整安全分层表部署时不必也不应该自行放宽。总结一张表记住 3 个核心点问题关键答案API 密钥export ANTHROPIC_API_KEYsk-ant-...可加ANTHROPIC_API_BASE切网关只放环境变量MCP URL 环境变量是数据源地址GL_MCP_URL等脚本自动替换进 manifest值只能含安全字符beta 头/v1/agents用managed-agents-2026-04-01/v1/skills用skills-2025-10-02脚本已自动携带配好这三项后一条scripts/deploy-managed-agent.sh slug即可把参考模板部署到你自己的工作流引擎后面——同一个 Agent同一套技能跑在哪里由你决定。更多 Agent 清单见仓库主文档 README.md。【免费下载链接】financial-services项目地址: https://gitcode.com/GitHub_Trending/fi/financial-services创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考