К основному содержанию
скилл CX Codex

langsmith-deployment — скилл для Claude Code: установка

Скилл для Claude Code помогает разворачивать и обслуживать агентные серверы в LangSmith Deployment. Подключается при настройке langgraph.json, создании ревизий или разборе проблем с запуском.

MIT ★ 106 обновлён 2026-11-11

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add soba-labs/langchain-agent-skills --skill langsmith-deployment -a claude-code
Открыть на GitHub

Что делает langsmith-deployment

Скилл проверяет langgraph.json, помогает выбрать Cloud, Hybrid/Self-hosted with control plane или Standalone, создать развёртывание и новую ревизию либо откатить её. В комплекте есть скрипты на Python и TypeScript для проверки конфигурации, работы через control-plane API и подготовки плана мониторинга. План создаётся в JSON; сами оповещения настраиваются в интерфейсе LangSmith.

Также скилл помогает связать CI/CD с control-plane API, настроить переменные окружения и секреты, а затем проверить состояние развёртывания, health endpoints, трассировки и метрики. Скрипты запускаются через uv run python. Для API в примерах используется LANGSMITH_API_KEY; в standalone-сервере нужны DATABASE_URI, REDIS_URI, ключ лицензии и ключи провайдеров приложения.

Какие задачи решает

  • проверить langgraph.json перед развёртыванием
  • выбрать модель размещения для LangGraph-приложения
  • создать ревизию или откатить неудачную
  • подготовить CI/CD и план мониторинга

Примеры запросов агенту

  • Проверь langgraph.json для Cloud и найди проблемы совместимости.
  • Создай новую ревизию развёртывания из ветки main.
  • Подготовь план мониторинга и оповещений для проекта my-agent-prod.

Как установить langsmith-deployment

1Через Skills CLI (Vercel)

npx skills add soba-labs/langchain-agent-skills --skill langsmith-deployment -a claude-code

2Вручную: положить файлы

~/.claude/skills/langsmith-deployment/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/langsmith-deployment/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о langsmith-deployment

Как установить langsmith-deployment в Claude Code?

Выполни npx skills add soba-labs/langchain-agent-skills --skill langsmith-deployment -a claude-code. Файл скилла находится по пути ~/.claude/skills/langsmith-deployment/SKILL.md.

Что делает langsmith-deployment?

Скилл помогает проверять конфигурацию LangGraph, развёртывать серверы в LangSmith Deployment, создавать и откатывать ревизии, а также настраивать мониторинг и автоматизацию CI/CD.

Что нужно для работы langsmith-deployment?

Скрипты запускаются командой uv run python, а для обращений к LangSmith API используется LANGSMITH_API_KEY. Для standalone-сервера нужны DATABASE_URI, REDIS_URI, ключ лицензии и ключи провайдеров приложения.

Исходный текст

SKILL.md · MIT
---
name: langsmith-deployment
description: "Deploy and operate production agent servers with LangSmith Deployment. Use when work involves choosing Cloud vs Hybrid/Self-hosted-with-control-plane vs Standalone, preparing/validating langgraph.json, creating deployments or revisions, rolling back revisions, wiring CI/CD to control-plane APIs, configuring environment variables and secrets, setting monitoring/alerts/webhooks, or troubleshooting deployment/runtime/scaling issues for LangChain/LangGraph applications."
---

# 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

1. Validate local deployment config.
2. Choose deployment model and endpoint strategy.
3. Create deployment or revision.
4. Configure environment variables and secrets correctly.
5. Configure monitoring and alerts.
6. Verify runtime behavior and keep rollback path ready.

## Script-First Commands

### 1) Validate `langgraph.json`

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

### 2) Create a Cloud deployment (US default)

```bash
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)

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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.

© soba-labs · MIT · soba-labs/langchain-agent-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
arize-migrate-langsmith arize Скилл arize-migrate-langsmith для Claude Code переносит исторические трейсы, датасеты и промпты из LangSmith в Arize AX. Запускается при смене платформы наблюдаемости LLM. CX Codex +1 416установок observability-langsmith Orchestra Research Скилл observability-langsmith для Claude Code отслеживает вызовы LLM и оценивает ответы на тестовых наборах. Проверяет качество AI-функций. CX Codex +1 56установок model-deployment secondsky Скилл model-deployment для Claude Code: FastAPI-сервер, Docker, Kubernetes, мониторинг и отлов дрейфа — весь путь от обученной модели до работающего пода. CX Codex +1 400установок langsmith-fetch langchain-ai Загружает трейсы LangSmith в агент — для отладки поведения, просмотра истории разговора и анализа вызовов инструментов. Запускается командой uv run langsmith-fetch с ключом LANGSMITH_API_KEY из .env. CX Codex +1 1 300установок langsmith-online-eval-engineering langchain-ai Скилл langsmith-online-eval-engineering для Claude Code проектирует, тестирует и подключает онлайн-эвалуаторы LangSmith к рабочим трейсами и диалогам. Фильтрует прогоны, настраивает сэмплирование и контроль качества. CX Codex +1 409установок langsmith akillness Маршрутизирует работу с LangSmith в одной цепочке — до SDK. Трассировка вызовов, офлайн-эвалюация, очереди ревью, синхронизация промптов в LLM-приложениях и агентах. CX Codex +1 328установок

Из того же набора9

langsmith-trace-analyzer Скилл langsmith-trace-analyzer для Claude Code скачивает и разбирает трассы LangSmith. Он включается при отладке агентов и оценке результатов по логам запусков. CX Codex +1 ★ 106звёзд репо langgraph-testing-evaluation Скилл langgraph-testing-evaluation для Claude Code проверяет и оценивает агентов LangGraph и LangChain. Он подключается к задачам с тестами узлов, оценкой траекторий и сравнением версий агента. CX Codex +1 ★ 106звёзд репо langgraph-state-management Скилл langgraph-state-management для Claude Code помогает проектировать состояние приложений LangGraph и разбирать проблемы с его обновлением. Включается при работе со схемами, редьюсерами и сохранением состояния. CX Codex +1 ★ 106звёзд репо langgraph-project-setup Скилл langgraph-project-setup для Claude Code помогает создать и настроить проект LangGraph. Он включается при настройке структуры, langgraph.json, переменных среды и зависимостей. CX Codex +1 ★ 106звёзд репо langgraph-error-handling Скилл langgraph-error-handling для Claude Code помогает настраивать обработку ошибок в LangGraph. Подключается, когда нужно добавить повторы, восстановление через LLM или передачу решения человеку. CX Codex +1 ★ 106звёзд репо langgraph-agent-patterns Скилл langgraph-agent-patterns для Claude Code помогает собирать схемы координации агентов в приложениях на LangGraph. Он включается при выборе паттерна или отладке взаимодействия агентов. CX Codex +1 ★ 106звёзд репо deepagents-setup-configuration Скилл deepagents-setup-configuration для Claude Code создаёт и проверяет проекты Deep Agents на Python или JavaScript. Помогает настроить субагентов, память и подтверждение действий человеком. CX Codex +1 ★ 106звёзд репо deepagents-planning-todos Скилл deepagents-planning-todos для Claude Code помогает планировать задачи в Deep Agents через список дел write_todos. Он включается, когда нужно разбить работу на этапы, следить за прогрессом или выяснить, почему пункт не завершается. CX Codex +1 ★ 106звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой