SuperAPI AI 工具集

langsmith-deployment

部署与运维

查看项目

更新于 10-16 03:40

技能介绍

用途:在 LangSmith Deployment 中部署、修订、监控和排查基于 LangGraph 的智能体服务器。适用场景包括向 LangSmith Cloud 部署新智能体、由 Git 或环境变更创建新部署修订、为失败修订提供回滚指导、选择部署模式、用控制平面 API 做 CI/CD 自动化、配置监控告警、校验 langgraph.json 与部署兼容性。

部署模式:Cloud(由 LangSmith 运营基础设施,源为 GitHub 仓库,经控制平面管理);Hybrid/Self-hosted with control plane(私有数据平面加集中式部署 UI/API,容器镜像加控制平面,基础设施由用户运营);Standalone server(直接托管 Agent Server,无控制平面,容器化服务器,由用户运营)。

核心流程:校验本地部署配置;选择部署模式与端点策略;创建部署或修订;正确配置环境变量与密钥;配置监控与告警;验证运行时行为并保持可回滚。

必要用法(命令保持原样): 校验配置:uv run python skills/langsmith-deployment/scripts/validate_deployment.py --config langgraph.json --target cloud 创建 Cloud 部署(美国):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 创建 Cloud 部署(欧洲)加 --region eu;自托管控制平面加 --control-plane-url https://<your-langsmith-host>/api-host;为已有部署创建修订加 --deployment-id <deployment-id>。 回滚:uv run python skills/langsmith-deployment/scripts/rollback_deployment.py --deployment-id <deployment-id> --list-revisions(列出),再去掉 --list-revisions 执行回滚。 监控计划:uv run python skills/langsmith-deployment/scripts/setup_monitoring.py --project my-agent-prod --output-json /tmp/monitoring-plan.json(仅生成计划/模板,告警需在 LangSmith UI 按项目配置)。

配置规则:langgraph.json 中 graphs 必填;Python 项目 dependencies 必填;JS 项目(存在 node_version)由 package.json 管理依赖;env 可为 env 文件路径或内联对象;python_version 为 3.11、3.12、3.13;pip_installer 为 auto、pip、uv;LangGraph.js 的 node_version 文档为 20。

端点:美国控制平面 API 默认 https://api.host.langchain.com,欧洲 https://eu.api.host.langchain.com,自托管通常 https://<host>/api-host。组织级 API 密钥需带工作区/租户 id(X-Tenant-Id,脚本参数 --tenant-id)。

密钥:禁止在 langgraph.json 或源码中硬编码;优先从部署 UI、Kubernetes Secrets 或云密钥管理器注入;尽量用 LANGSMITH_API_KEY 环境变量而非命令行参数;控制平面流与 standalone 的追踪认证环境变量处理不同;standalone 需 DATABASE_URI、REDIS_URI、许可证密钥及应用提供方密钥。

部署后验证:在 LangSmith Deployments UI 查看部署/修订状态;从运行时验证服务器 API 与健康端点;对助手/图执行冒烟调用;在监控看板确认追踪、延迟与错误指标。

技能附带 references(deployment-guide、cicd-integration、environment-management、monitoring-alerts、scaling-configuration、troubleshooting-deployment)、脚本映射(validate_deployment.py、deploy_to_langsmith.py、deploy_to_langsmith.ts、rollback_deployment.py、setup_monitoring.py)及 assets 模板(langgraph-cloud.json、github-actions-deploy.yml、kubernetes-deployment.yaml、.env.example)。具体收费、价格与平台支持范围资料暂未提供。