内容
BD 桌面
一个端到端的商业发展渠道，基于 **[Claude Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview)** 构建 —
线索来源、公司研究、外联草稿、每周提醒和一个可部署的轻量级 CRM 来运行它。
一个规则在任何地方都适用：**系统研究和草拟；人类始终发送。**
每个自动化路径都在草稿处停止，渠道状态永远不会由机器写入。
<sub>所有显示的公司都是示例品牌包中的虚拟演示数据。</sub>
大多数托管代理示例一次演示一个基本功能。这个仓库将它们全部组合成一个工作系统：
| 基本功能 | 在此处使用 |
|---|---|
| 代理 / 环境 / 会话 / 四个研究代理 +驱动脚本 |
| **分** (`user.define_outcome`) | 每次研究运行都评分标准；平台对进行评分，并将代理修订 |
| **离线 与固定基准 | ` eval` — 平台评分 确定性检查，与固定差异 |
| **技能包括捆绑的可） | 输出格式 + 扫描协议按需加载；的 `validate_blocks.py代理在其草稿上| **MCP 消费** | 代理使用允许列表的工具集调用 CRM 的自己的 MCP 服务器 |
| **保险库**出口处重新发送密钥 持有者注入代理永远不会看到机密 |
| **多代理** (`` 协调器)达将每个赞助委托给锁定子代理的线程 |
| ** （cron + 按需运行） | 每周雷达扫描周摘要；随时使用-fire` / `digest 运行 |
| **内存存储** | 雷达的跨列表（PE 赞助商的 BFS 前沿） |
梦境** *(研究 | `npm run dream` 巩固内存存储 + 转录的存储 |
| API** | 交付成果写入 `/mnt/session/outputs/deliverable.md` 并原样获取 |
## 系统
```
┌──────────────────────────────────────────────┐
│ brand/brand-pack.yaml （您的定位） │
│ 由 `npm run brand-pack` 编译成每个 │
│ 代理提示 的外联草 │
└──────┘
│
周 cron ──►雷达 ───────┼─────────► CRM（Next.js on Vercel）
（分级扫描） 遍历 PE-赞助商 │ 看板 UI · REST · MCP 服务器
图谱通过赞助商 │ Vercel Blob 存储
映射子代理； │ ▲ │
将合格目标推至 └ │ │ 每夜 cron：
MCP │ │ 最终 → 研究
│ │ → 草拟 → 跟进
按钮 / CLI ──► 档案 / 赞助商资料 ─────────────┘ │
（分级运行） 研究实时网络，写入 ▼
deliverable.md + 机器可读 外联草拟
人/投资组合块 （人类发送）
每周 cron ──► 每周摘要 — 读取 MCP 上的渠道，发送创始人
本周要做的 2-3 件事（故意不分级：修订
循环可以重新发送电子```
**四个代理**/*.system.md`)：**档案** 编写七部分的通话简报；助商资料** 基金的投资组合 `→ ADD`
投资组合渠道）；**** 以 PE 赞的图谱遍历作为 ICP，协调锁定的 **赞助商映射** 子代理；**摘要**
每周提醒您。提示保持简短 — 身份 + 品牌规范 + 指向 **skills/`) 的技能承载了程序。
您需要：An 密钥（具有访问权限）、Verc帐户（CRM 托管），以及可选的 [](https://resend 密钥用于电子邮件。
**成本警告：** 研究 Claude Opus 数分钟档案/扫描/评估一个真正的多分钟代理bash
npm install 1. 您的品牌 — 所有内容的配置表面
brand-pack.example.yamlbrand-pack.yaml #; 编辑每个字段
cp .env.example .env 填写过程中
# 2. CRM（首先部署 —其 URL + MCP 端点）
cd crm &&
vercel link && blob add # 创建项目 + Blob 存储
cp .env.example .env.local # 填写；镜像到 Vercel 环境变量
vercel --prod
cd ..
# 3. 编译规范，配置所有内容（顺序很重要；所有幂等）
npm run brand-pack -- --local
npm run setup # 环境 + 档案代理
npm run setup-sponsor # 赞助商资料代理
npm run setup-radar # 内存存储 + 雷达代理
npm run setup-digest # 摘要代理（需要 CRM_URL/DIGEST_TO/EMAIL_FROM 在 .env 中）
npm run setup-vault # 保险库（需要 CRM_URL）
npm run setup-mcp # MCP 持有者进入保险库 + 将雷达/摘要指向 CRM 的 MCP 服务器
npm run setup-skills # 上传技能/ + 附加到代理
npm run setup-multiagent # 赞助商映射子代理 + 雷达协调器名单
npm run brand-pack # 现在也将规范推送到 CRM
# 4. Cron
npm run deploy-radar # 每周扫描（每周一 8am ET脚本中编辑）
npm-digest #摘要（需要 RESEND）
```
将 `.managed.json` 中的代理/环境 ID 添加到 CRM 的 V 环境变量（`DOS_ID`、`OR_AGENT_ID`、`_ID`）并重新部署一次。
## 每日使用
- **CRM** — Vercel URL 上的看板。研究按钮启动分级档案/赞助商会话；渠道的夜间 cron 最终完成研究，
研究有前途的未触及目标（上限），草拟缺失的外联，并显示到期跟进。评分者的裁决结果在每个目标上。
- **CLI** — `npm run dossier -- "Some Company"`，`npm run radar`，`npm run radar-fire`
（现在触发部署并尾随它，包括评分裁决）。
- **MCP** — CRM 是一个 MCP 服务器（`/api/mcp`，持有者 `MCP_TOKEN`）。将其连接到
Claude Code 并通过对话式驱动渠道（`crm_list_targets`、
`crm_research`、`crm_draft_outreach`，...）。代理本身使用相同服务器的允许列表子集。
## 评估驱动的迭代
在 `evals/tasks.json` 中填写 2-3 个来自您的 ICP 的真实公司（一个预期的 Strong，一个预期的 Skip，一个赞助商），然后：
```bash
npm run eval -- --baseline # 固定起点
# ...更改提示、技能、规范或模型...
npm run eval # 与固定基准的计分卡和增量
```
每个任务都运行真实代理，并被评分两次：由平台评分器针对相同的评分标准，生产中使用，
以及通过确定性检查（机器块解析，来源引用，禁止词缺失，预期拟合）。
这就是您在没有振动的情况下更改提示的方法。
## 平台注意事项（调试前阅读）
在构建过程中，我们遇到了一些问题，文档中没有明确说明：
1. **分级会话暂时空闲。** 使用 `user.define_outcome` 时，会话 在评估循环期间idle`，而 `outcome_evaluations[].result仍为
`/`evaluating`。 “完成”意味着：`terminated`，或 `idle` **且** 每个结果
评估都在终端状态（`satisfied` / `max_iterations_reached` / `failed`
/ `interrupted`）。天真的空闲意味着完成会抓取半成品交付成果。
2. **分级代理写入文件，而不是消息。** 在 `define_outcome` 下，代理将
交付成果放入 `/mnt/session/outputs/`，仅在消息中叙述。固定文件名
在启动时， 通过 `files.list({scope_id: sessionId})` +
`download` 获取（允许 ~1–3 秒索引延迟后 idle）。本仓库就是这样做的。
3. **事件流是进度，而不是真相。** 它在会话重新调度时下降
（例如模型过载重试），而会话在服务器端继续运行。在
流结束时，轮询 `sessions.retrieve` 到上述完成条件，并从
`events.list` 重新构建。
4. **部署就地更新；没有删除。** `deployments.update`
更改 `initial_events` / 固定的代理版本 / 资源在实时 cron 上 —
运行历史记录完好。部署在重复错误后也会 **自动暂停** ；如果
调度运行安静，请先检查 `deployment.status`。
5. **`agents.update` 可以添加但不能删除 `multiagent` 块** — 预先
注册版本保持可寻址，因此将协调器注册表作为单独的
版本提升。无操作更新不会提升版本。
6. **技能：** `SKILL.md` 描述拒绝 XML/角括号标签；`display_title`
是整个组织唯一的（在部分运行恢复期间，采用现有的 ID 通过
`skills.list()`）；代理固定 `version: "latest"` 会在没有代理版本提升的情况下拾取技能编辑。
7. **`allow_mcp_servers` 仅控制 `limited` 网络** — 无限制
环境通过环境更改访问 MCP 服务器，无需更改。
8. **梦境是受控的研究预览** — `/v1/dreams` 在您的组织选择加入之前返回 404。
`npm run dream` 准备就绪。
## 仓库布局
```
brand/ brand-pack.example.yaml — 复制到 brand-pack.yaml 并使其成为您自己的
agents/ 系统提示（+ 用于评估每次研究运行的 rubrics/）
skills/ 按需程序：格式、扫描协议、机器块
合同 + 代理在其草稿上运行的 validate_blocks.py
src/ 配置 + 运行脚本（setup*、deploy*、dossier、radar、eval、dream）
evals/ tasks.json（用您的公司填写）+ 固定基准 + 运行
crm/ Next.js CRM：看板 UI、REST API、MCP 服务器、夜间渠道、
Vercel Blob 存储、晨间简报电子邮件
```
## 状态
托管代理是测试版表面（`anthropic-beta: managed-agents-2026-04-01`）；
SDK 已固定，本仓库反映了 2026 年 7 月的 API。如
Anthropic 的 [cwc-workshops](https://github.com/anthropics/cwc-workshops) 中的模式构建的一系列实践代表；
本项目与Anthropic无关。
MIT — 见 [LICENSE](./LICENSE)。
