用途
Design Agent Deploy 是 Design Agent 的部署技能，目标是让团队真正能在 Slack 中使用该智能体。它提供两条路径：部署到 Managed Deep Agents（推荐）或用 Docker Compose 自托管。
前置条件
部署前先完成设置：uv run design-agent doctor 应通过，品牌包应通过校验（涉及 design-agent-onboarding、brand-onboarding）。文档强调，在执行 mda deploy、连接 Slack 以及任何产生账单的操作（发布快照、托管）之前都应先征得确认，且绝不要打印密钥，缺失的设置要明确指出。
托管方式（Managed Deep Agents）
运行者：LangSmith 负责运行时、沙箱、Slack 应用和调度；需要 LangSmith Cloud 账号（MDA 处于公开测试阶段）和具备部署能力的 LANGSMITH_API_KEY。费用为托管费加模型与媒体消耗。
流程要点：先发布一次计算机镜像，uv run design-agent sandbox build && uv run design-agent sandbox test 在本地验证配方，uv run design-agent sandbox publish --fs-gib 16 在工作区构建快照（沙箱时间计费）；sandbox/setup.sh 变更后需重新发布。检查 .env 中的键名，mda deploy 会把除 LangSmith 外的每个 .env 键作为部署密钥转发，应只保留部署智能体真正使用的键（模型、媒体、DESIGN_AGENT_、PAPER_），自托管用的键（SLACK_*、DATABASE_URL、DESIGN_AGENT_API_TOKENS）不应出现；workspace/out/ 中的渲染产物也会一起发布并计入 MDA 200 MB 归档上限。可先用 uv run mda deploy --name design-agent-test 试部署副本，不影响团队智能体。确认后执行 uv run mda deploy，首次部署会创建 Slack 应用，需本人在 Slack 工作区授权；没有 LANGSMITH_API_KEY 时 mda deploy 会提供浏览器登录。
验证：用真实请求测试，先一张静图，再一段简短分镜预告片；Slack 中应看到实时进度、渲染期间的签到以及结束时附上的文件。无 Slack 时可调用部署的 API（docs/deploy-mda.md 有示例），文件会附加到该次运行的 LangSmith trace。uv run mda logs 可追踪部署日志。更新时先改、部署测试副本、再 uv run mda deploy；重新部署会停止正在运行的辅助任务，受影响的线程会提供从已保存记录恢复的选项。
自托管方式
运行者需自行承担 API、Postgres 和 Docker 主机；要求 Docker Compose v2.24+。配置：uv run design-agent config set DESIGN_AGENT_MODEL=…（由本人输入密钥或写入 .env），再 uv run design-agent config generate DESIGN_AGENT_API_TOKENS POSTGRES_PASSWORD。启动：docker compose -f deploy/self-host/compose.yaml up -d --build，随后 curl -s http://127.0.0.1:8080/health 检查健康状态。
Slack（可选）：从 config/slack-manifest.example.yaml 创建应用，设置 SLACK_BOT_TOKEN 和 SLACK_APP_TOKEN，然后在 compose 命令中加 --profile slack。验证：用 Authorization: Bearer <token> 向 POST /threads/{id}/messages 发消息，再轮询 GET /threads/{id}/updates 获取后台工作结果。
安全提示：API 通过 Docker socket 启动沙箱，等同于 root 权限；应使用专用主机，或改用 LangSmith 沙箱（DESIGN_AGENT_SANDBOX=langsmith）而不挂载该 socket。本地预检不能证明部署成功，只有真实请求才能验证。
适用场景与限制
适用于需要把 Design Agent 接入团队 Slack、并对部署密钥和计费操作保持谨慎的团队。托管方式依赖 LangSmith Cloud（公开测试）且托管收费；自托管需要自行维护主机、数据库与 Docker 环境。具体模型与媒体费用、沙箱计费细节暂未提供。