Langsmith Deployment Agent Skill

LangSmith Deployment

Use this skill to deploy, revise, monitor, and troubleshoot LangGraph-based agents in LangSmith Deployment.

Use This Skill When

• You need to deploy a new agent to LangSmith Cloud.
• You need to create a new deployment revision from Git changes or env changes.
• You need rollback guidance for a failing revision.
• You need to choose deployment model: Cloud, Hybrid/Self-hosted with control plane, or Standalone server.
• You need CI/CD automation using LangSmith Deployment control-plane APIs.
• You need monitoring and alert setup aligned with current LangSmith alert model.
• You need langgraph.json validation and deployment compatibility checks.

Deployment Model Selection

| Model | Use when | Build/Source | Operates infra |

|---|---|---|---|

| Cloud | Fastest managed production path | GitHub repo via control plane | LangSmith |

| Hybrid/Self-hosted with control plane | You need private data plane + centralized deployment UI/API | Container image + control plane | You |

| Standalone server | You want direct Agent Server hosting without control plane | Containerized server | You |

Core Workflow

• Validate local deployment config.
• Choose deployment model and endpoint strategy.
• Create deployment or revision.
• Configure environment variables and secrets correctly.
• Configure monitoring and alerts.
• Verify runtime behavior and keep rollback path ready.

Script-First Commands

1) Validate langgraph.json

uv run python skills/langsmith-deployment/scripts/validate_deployment.py --config langgraph.json --target cloud

2) Create a Cloud deployment (US default)

uv run python skills/langsmith-deployment/scripts/deploy_to_langsmith.py \
  --name "my-agent-prod" \
  --owner my-org \
  --repo my-agent-repo \
  --branch main \
  --config langgraph.json

3) Create a Cloud deployment (EU)

uv run python skills/langsmith-deployment/scripts/deploy_to_langsmith.py \
  --name "my-agent-prod" \
  --owner my-org \
  --repo my-agent-repo \
  --region eu

4) Use a self-hosted control plane

uv run python skills/langsmith-deployment/scripts/deploy_to_langsmith.py \
  --name "my-agent-prod" \
  --owner my-org \
  --repo my-agent-repo \
  --control-plane-url https://<your-langsmith-host>/api-host

5) Create a revision for an existing deployment

uv run python skills/langsmith-deployment/scripts/deploy_to_langsmith.py \
  --name "my-agent-prod" \
  --owner my-org \
  --repo my-agent-repo \
  --deployment-id <deployment-id> \
  --branch main

6) Roll back deployment revision

uv run python skills/langsmith-deployment/scripts/rollback_deployment.py \
  --deployment-id <deployment-id> \
  --list-revisions

uv run python skills/langsmith-deployment/scripts/rollback_deployment.py \
  --deployment-id <deployment-id>

7) Generate monitoring + alert setup plan

uv run python skills/langsmith-deployment/scripts/setup_monitoring.py \
  --project my-agent-prod \
  --output-json /tmp/monitoring-plan.json

Note: setup_monitoring.py generates a docs-aligned setup plan/templates. Alerts are configured in LangSmith UI per project.

Configuration Rules To Enforce

• graphs is required in langgraph.json.
• For Python projects, dependencies is required.
• For JS projects (node_version present), dependencies may be handled via package.json.
• env may be either a string path to an env file or an inline object map.
• python_version should be one of 3.11, 3.12, 3.13 when set.
• pip_installer should be one of auto, pip, uv when set.
• node_version currently documented for LangGraph.js as 20.

API/Endpoint Notes

• LangSmith Deployment control-plane API defaults are:
• US: https://api.host.langchain.com.
• EU: https://eu.api.host.langchain.com.
• Self-hosted control-plane base URL is typically https://<host>/api-host.
• For org-scoped API keys, include workspace/tenant id (X-Tenant-Id), exposed by scripts as --tenant-id.

Secrets And Environment Guidance

• Never hardcode secrets in langgraph.json or source code.
• Prefer environment injection from deployment UI, Kubernetes Secrets, or cloud secret managers.
• Avoid passing secrets in shell arguments when possible; prefer LANGSMITH_API_KEY env var.
• In control-plane deployment flows, tracing auth env handling differs from standalone; rely on deployment model docs before overriding tracing/auth vars.
• For standalone server, ensure required runtime vars are present (DATABASE_URI, REDIS_URI, license key, and any app provider keys).

Verification After Deploy

• Check deployment/revision status in LangSmith Deployments UI.
• Verify server API and health endpoints from deployment runtime (/docs etc.).
• Run a smoke invocation against your assistant/graph.
• Confirm traces, latency, and error metrics in Monitoring dashboards.

References To Load By Task

• references/deployment-guide.md: Deployment model choice and end-to-end execution.
• references/cicd-integration.md: CI/CD stages, control-plane automation patterns, preview/prod strategy.
• references/environment-management.md: Env var sources, secrets patterns, standalone required vars.
• references/monitoring-alerts.md: Dashboards, alert model, webhook payload guidance.
• references/scaling-configuration.md: Scaling responsibilities by model and tuning knobs.
• references/troubleshooting-deployment.md: Failure triage and rollback strategy.

Script Map

• scripts/validate_deployment.py: Validate langgraph.json and deployment readiness.
• scripts/deploy_to_langsmith.py: Create deployment or revision via control-plane API.
• scripts/deploy_to_langsmith.ts: TypeScript equivalent deploy/revision script.
• scripts/rollback_deployment.py: List and rollback revisions.
• scripts/setup_monitoring.py: Generate alert/dashboard/webhook setup plan.

Assets

• assets/templates/langgraph-cloud.json: Cloud-oriented starter config.
• assets/templates/github-actions-deploy.yml: CI/CD template for deployment automation.
• assets/templates/kubernetes-deployment.yaml: Kubernetes template for self-managed environments.
• assets/templates/.env.example: Env var template for safe sharing.