Design Agent 的入门配置指南，用于指导使用者完成安装、配置与首次运行。整个过程需与使用者逐步进行，不得打印任何密钥或令牌，缺少配置时只报告设置项名称；在用户主动提出前，不要部署、连接账户或发布内容。
安装与验证环境
先执行 uv sync；随后运行 uv run design-agent sandbox build（依赖 Docker，冷构建约下载 2 GB，需要数分钟），再运行 uv run design-agent demo。演示会用示例品牌渲染三种尺寸的发布卡片，并生成 4 秒预告片，全程不需要密钥。若执行失败，用 uv run design-agent doctor 查看缺少什么。
配置模型
执行 uv run design-agent config set DESIGN_AGENT_MODEL=provider:model，并配置对应提供商的密钥（如 ANTHROPIC_API_KEY，使用 langsmith: 模型时为 LANGSMITH_GATEWAY_API_KEY）。密钥由使用者亲自输入，或手动写入 .env。默认值及其他角色见 docs/models.md。之后重新运行 doctor，再运行 uv run design-agent test model——doctor 只检查密钥是否已设置，test 会用该密钥发起一次低成本调用。
媒体密钥（可选）
OPENAI_API_KEY 用于图像生成，ELEVENLABS_API_KEY 用于语音、音乐和音效，GROQ_API_KEY 用于快速转录。缺少密钥时，各工具会明确提示。
品牌
按 brand-onboarding 技能的步骤，基于使用者已有的品牌指南、网站、文件或 Paper 文件构建 workspace/brand/；在此之前使用示例品牌。
Paper（可选）
若 Paper Desktop 运行在本机，设 PAPER_MODE=local；部署的智能体使用 bridged（见 docs/partners/paper.md）；off 也可以，看板会在沙箱中渲染。
试用
运行 uv run design-agent ask "Make a LinkedIn card announcing …"。最终产物位于 workspace/out/<thread>/，最后一行会估算本次运行成本，使用 --thread <id> 可继续对话。
选择运行方式
可选 Managed Deep Agents（托管运行时、沙箱、Slack 应用与定时任务，一条命令即可）或自托管（Docker Compose 加 Postgres 和自有 Slack 应用）。后续由 design-agent-deploy 技能接手，包括用真实请求进行验证。
后续步骤
用 design-agent-customize 让它学会团队每周所需的交付物，并用 design-agent-evals 衡量改动效果。