Agent Skills › langchain-ai/design-agent › design-agent-deploy

design-agent-deploy

GitHub

指导部署 Design Agent,支持 Managed Deep Agents 托管或 Docker Compose 自托管。涵盖环境检查、密钥配置、沙箱发布及 Slack 集成验证,确保团队安全运行代理。

.agents/skills/design-agent-deploy/SKILL.md langchain-ai/design-agent

Trigger Scenarios

用户询问如何部署 Design Agent 需要初始化 Slack 应用或配置 LangSmith 环境 执行 sandbox publish 或 mda deploy 命令前

Install

npx skills add langchain-ai/design-agent --skill design-agent-deploy -g -y
More Options

Non-standard path

npx skills add https://github.com/langchain-ai/design-agent/tree/main/.agents/skills/design-agent-deploy -g -y

Use without installing

npx skills use langchain-ai/design-agent@design-agent-deploy

指定 Agent (Claude Code)

npx skills add langchain-ai/design-agent --skill design-agent-deploy -a claude-code -g -y

安装 repo 全部 skill

npx skills add langchain-ai/design-agent --all -g -y

预览 repo 内 skill

npx skills add langchain-ai/design-agent --list

SKILL.md

Frontmatter
{
    "name": "design-agent-deploy",
    "description": "Put Design Agent in a team's Slack. Deploy it to Managed Deep Agents (one command, managed Slack app) or self-host it with Docker Compose, verify it with a real request, ship updates, and keep a separate test copy. Use when someone wants the agent running for their team."
}

Deploy Design Agent

A deployment is what the team uses. Ask before mda deploy, before connecting Slack, and before anything that bills (publishing a snapshot, hosting). Never print a key; name missing settings. Setup comes first: uv run design-agent doctor should show no FAIL line and the brand pack should validate (design-agent-onboarding, brand-onboarding). A first deploy can use the sample brand and needs no local Docker; doctor's mda-deploy line lists what the deploy still needs.

Managed Deep Agents (recommended) Self-hosted
Who runs it LangSmith: runtime, sandboxes, Slack app, schedules the person: API, Postgres, Docker host
Needs a LangSmith Cloud account (MDA is in public beta) and a deployment-capable LANGSMITH_API_KEY Docker with Compose v2.24+
Cost hosting is paid, plus model and media spend their machine, plus model and media spend

Managed Deep Agents

Ask first, in one message: do they have a LangSmith Cloud account with Managed Deep Agents (US, public beta), which model (Anthropic by default, or the LangSmith Gateway), whether to start with the sample brand (fine for a first deploy) or theirs, and whether to deploy a test copy first. Say what bills: the snapshot build, hosting and model spend (pricing).

Keys never pass through you. Name the keys (LANGSMITH_API_KEY, needs deployment permission, and the model's key) and have the person run uv run design-agent config set LANGSMITH_API_KEY ANTHROPIC_API_KEY in their own terminal: each value is typed hidden. Without a terminal the command refuses rather than asking you for the value. Never ask for a key in chat.

Long and interactive steps. sandbox publish takes 10 to 15 minutes and asks to confirm: after their yes, run sandbox publish --yes in the background. The first mda deploy sets up the Slack app and waits for a person: a browser sign-in (no LANGSMITH_API_KEY in .env), an authorization link, and Enter in a real terminal. Have the person run it in their own terminal. Later deploys need no Slack step; run them after a yes (--yes overwrites same-name resources).

  1. Publish the computer once. uv run design-agent sandbox build && uv run design-agent sandbox test proves the recipe locally; uv run design-agent sandbox publish builds the 16 GiB snapshot in their workspace (sandbox time is billed). Publish again whenever sandbox/setup.sh changes.
  2. Check the keys. mda deploy forwards every .env key except LangSmith's as a deployment secret. List the key names in .env and confirm they are only what the deployed agent uses (model, media, DESIGN_AGENT_*, PAPER_*); self-hosting keys (SLACK_*, DATABASE_URL, DESIGN_AGENT_API_TOKENS) must not be there. Renders in workspace/out/ ship too and count toward MDA's 200 MB archive limit. uv run design-agent doctor names all of this (mda-deploy), and uv run mda build compiles what would ship into .mda/build/.
  3. Try a copy first. uv run mda deploy --name design-agent-test is a separate deployment; the team's agent is untouched.
  4. Deploy with uv run mda deploy after a yes. The first deploy provisions the Slack app (its name is DESIGN_AGENT_SLACK_NAME in .env). If LangSmith isn't authorized for their Slack workspace, the CLI prints an HTTPS link: they open it, pick the workspace and approve (a workspace admin may have to), then press Enter. Rerun the deploy if the link was missed. Without a LANGSMITH_API_KEY, mda deploy offers a browser sign-in. The Slack app is managed: there is no manifest or SLACK_* key to set, whatever a generic MDA skill says.
  5. Verify with real requests. Once live, the agent DMs the person who deployed; they reply, or /invite it to a channel and mention it. Start with a quick still, then a short storyboarded teaser. In Slack you should see live progress, a check-in while it renders, and files attached at the end. Without Slack, call the deployment's API (docs/deploy-mda.md has the snippet); files attach to the run's LangSmith trace. uv run mda logs tails the deployment.
  6. Updates: change, deploy the test copy, then uv run mda deploy. A redeploy stops running helpers; each affected thread offers to resume from its saved transcript.

Self-hosted

  1. uv run design-agent config set DESIGN_AGENT_MODEL=… (the person types the key or sets it in .env), then uv run design-agent config generate DESIGN_AGENT_API_TOKENS POSTGRES_PASSWORD.
  2. docker compose -f deploy/self-host/compose.yaml up -d --build, then curl -s http://127.0.0.1:8080/health.
  3. Slack (optional): create an app from config/slack-manifest.example.yaml, set SLACK_BOT_TOKEN and SLACK_APP_TOKEN, then add --profile slack to the compose command.
  4. Verify: POST /threads/{id}/messages with Authorization: Bearer <token>, then poll GET /threads/{id}/updates for background work.
  5. Security: the API starts sandboxes through the Docker socket, which is root-equivalent. Use a dedicated host, or LangSmith sandboxes (DESIGN_AGENT_SANDBOX=langsmith) without the socket.

A local preflight does not prove a deployment: only a real request does. Details: Deploy with MDA, Self-hosting.

Version History

  • 8134d7c Current 2026-11-20 21:39

Same Skill Collection

.agents/skills/brand-onboarding/SKILL.md
.agents/skills/deep-agents-core/SKILL.md
.agents/skills/deep-agents-memory/SKILL.md
.agents/skills/deep-agents-orchestration/SKILL.md
.agents/skills/design-agent-customize/SKILL.md
.agents/skills/design-agent-evals/SKILL.md
.agents/skills/design-agent-onboarding/SKILL.md
.agents/skills/design-agent-troubleshoot/SKILL.md
.agents/skills/design-agent-update/SKILL.md
.agents/skills/langsmith-evaluator/SKILL.md
.agents/skills/vendor-sync/SKILL.md
skills/brand-design/SKILL.md
skills/content-brief/SKILL.md
skills/data-viz/SKILL.md
skills/design-wiki/SKILL.md
skills/faceless-explainer/SKILL.md
skills/film-breakdown/SKILL.md
skills/general-video/SKILL.md
skills/gif-edit/SKILL.md
skills/hyperframes-core/SKILL.md
skills/hyperframes-creative/SKILL.md
skills/hyperframes-keyframes/SKILL.md
skills/image-generation/SKILL.md
skills/image-ops/SKILL.md
skills/launch-film/SKILL.md
skills/media-production/SKILL.md
skills/motion-direction/SKILL.md
skills/music-to-video/SKILL.md
skills/paper-design/SKILL.md
skills/pr-to-video/SKILL.md
skills/reference-study/SKILL.md
skills/remotion-to-hyperframes/SKILL.md
skills/slideshow/SKILL.md
skills/sound/SKILL.md
skills/stills/SKILL.md
skills/storyboard/SKILL.md
skills/thumbnails/SKILL.md
skills/visual-verify/SKILL.md
.agents/skills/managed-deep-agents/SKILL.md
skills/embedded-captions/SKILL.md
skills/hyperframes-animation/SKILL.md
skills/hyperframes-audio/SKILL.md
skills/hyperframes-cli/SKILL.md
skills/hyperframes-registry/SKILL.md
skills/hyperframes/SKILL.md
skills/media-use/SKILL.md
skills/motion-graphics/SKILL.md

Metadata

Files
0
Version
8134d7c
Hash
cf7124e4
Indexed
2026-11-20 21:39

Accueil - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-20 22:33
浙ICP备14020137号-1