可观测性
我无法在 UI 中创建 API 密钥或管理用户，这是怎么回事？
- 您可能在未设置 SSO 的情况下部署了 LangSmith。LangSmith 需要 SSO 才能管理用户和 API 密钥。有关设置 SSO 的更多信息，请参阅配置部分。
负载均衡/入口是如何工作的?
- 您需要将前端容器/服务暴露给您的应用程序/用户。这将处理到所有下游服务的路由。
- 您需要在入口级别终止 SSL。我们建议使用 AWS ALB、GCP 负载均衡器或 Nginx 等托管服务。
我们如何对应用程序进行身份验证？
- 目前，我们的自托管解决方案支持 OAuth2.0 和 OIDC 作为身份验证解决方案的 SSO。请注意，我们确实提供无身份验证解决方案，但强烈建议在投入生产之前设置 OAuth。
我可以使用外部存储服务吗？
- 您可以将 LangSmith 配置为使用所有存储服务的外部版本。在生产环境中，我们强烈建议使用外部存储服务。有关更多信息，请查阅配置部分。
我的应用程序需要出站才能正常运行吗？
我们的部署仅需要少量出站流量（其中大部分可以驻留在您的 VPC 内）- 获取图像（如果镜像您的图像，则可能不需要）
- 与任何 LLM 端点通信
- 与您可能配置的任何外部存储服务通信
- 获取 OAuth 信息
-
订阅指标和操作元数据（如果未在离线模式下运行）
- 需要出站到
https://beacon.langchain.com - 有关更多信息，请参阅出站
- 需要出站到
X-Organization-Id 和 X-Tenant-Id 标头传递给后端服务。这些标头用于确定请求所属的组织和工作区（以前称为“租户”）。
应用程序的资源要求？
- 在 Kubernetes 中，我们建议使用最小 Helm 配置，可在此处找到。对于 Docker，我们建议至少 16GB RAM 和 4 个 CPU。
- 对于 Postgres，我们建议至少 8GB RAM 和 2 个 CPU。
- 对于 Redis，我们建议 4GB RAM 和 2 个 CPU。
- 对于 Clickhouse，我们建议 32GB RAM 和 8 个 CPU。
SAML SSO 常见问题解答
如何更改 SAML SSO 用户的电子邮件地址？
有些身份提供商会在电子邮件更改后保留原始用户 ID，而有些则不会，因此我们建议您遵循以下步骤以避免 LangSmith 中出现重复用户
- 从组织中移除用户（参见此处）
- 在 IdP 中更改其电子邮件地址
- 让他们通过 SAML SSO 再次登录 LangSmith - 这将触发使用其新电子邮件地址的常规即时 (JIT) 预置流程
如何修复“405 method not allowed”？
确保您使用的是正确的 ACS URL：https://auth.langchain.com/auth/v1/sso/saml/acsSCIM 常见问题解答
我可以在没有 SAML SSO 的情况下使用 SCIM 吗？
- 云端：否，云端部署中的 SCIM 需要 SAML SSO
- 自托管：是，SCIM 适用于带有客户端密钥身份验证模式的 OAuth
如果我同时启用了 JIT 预置和 SCIM 会发生什么？
JIT 预置和 SCIM 可能会相互冲突。我们建议在启用 SCIM 之前禁用 JIT 预置，以确保一致的用户预置行为。如何更改用户的角色或工作区访问权限？
在您的 IdP 中更新用户的组成员资格。更改将根据角色优先级规则同步到 LangSmith。当用户从所有组中移除时会发生什么？
用户将根据您的 IdP 的取消预置设置从您的 LangSmith 组织中取消预置。我可以使用自定义组名吗？
是的。如果您的身份提供商支持将替代字段同步到 `displayName` 组属性，您可以将替代属性（例如 `description`）用作 LangSmith 中的 `displayName`，并保留身份提供商组名的完全可定制性。否则，组必须遵循组命名约定部分中描述的特定命名约定，才能正确映射到 LangSmith 角色和工作区。为什么我的 Okta 集成不起作用？
请参阅 Okta 的故障排除指南：https://help.okta.com/en-us/content/topics/users-groups-profiles/usgp-group-push-troubleshoot.htm。部署
我需要使用 LangChain 才能使用 LangGraph 吗？有什么区别？
不是。LangGraph 是一个用于复杂代理系统的编排框架，它比 LangChain 代理更底层、更可控。LangChain 提供了一个标准接口来与模型和其他组件交互，适用于直接的链和检索流。LangGraph 与其他代理框架有何不同？
其他代理框架可以处理简单、通用的任务，但对于公司特有的复杂任务却力不从心。LangGraph 提供了一个更具表达力的框架来处理公司独特的任务，而不会将用户限制在单一的黑盒认知架构中。LangGraph 会影响我的应用程序性能吗？
LangGraph 不会给您的代码增加任何开销，并且是专门为流式工作流设计的。LangGraph 是开源的吗？它是免费的吗？
是的。LangGraph 是一个采用 MIT 许可证的开源库，可免费使用。LangGraph 和 LangSmith 有何不同？
LangGraph 是一个有状态的编排框架，为代理工作流带来了额外的控制。LangSmith 是一种用于部署和扩展代理应用程序的服务，具有用于构建代理 UX 的特定 API，以及集成的开发人员 UI。| 特性 | LangGraph (开源) | LangSmith |
|---|---|---|
| 描述 | 代理应用程序的有状态编排框架 | 用于部署 LangGraph 应用程序的可扩展基础设施 |
| SDK | Python 和 JavaScript | Python 和 JavaScript |
| HTTP API | 无 | 是——对于检索和更新状态或长期记忆，或创建可配置的助手很有用 |
| 流式处理 | 基本 | 用于逐令牌消息的专用模式 |
| 检查点 | 社区贡献 | 开箱即用支持 |
| 持久层 | 自我管理 | 带有高效存储的托管 Postgres |
| 部署 | 自我管理 | • 云 • 免费自托管 • 企业版（付费自托管） |
| 可扩展性 | 自我管理 | 任务队列和服务器的自动扩展 |
| 容错 | 自我管理 | 自动重试 |
| 并发控制 | 简单线程 | 支持双重发送 |
| 调度 | 无 | Cron 调度 |
| 监控 | 无 | 与 LangSmith 集成以实现可观测性 |
| IDE 集成 | Studio | Studio |
LangSmith 是开源的吗？
不。LangSmith 是专有软件。 有一个免费的、自托管的 LangSmith 版本，可以访问基本功能。云部署选项和自托管部署选项是付费服务。联系我们的销售团队了解更多信息。 欲了解更多信息，请参阅我们的LangSmith 定价页面。LangGraph 是否适用于不支持工具调用的 LLM？
是的！您可以将 LangGraph 与任何 LLM 一起使用。我们使用支持工具调用的 LLM 的主要原因通常是这是让 LLM 决定下一步做什么的最便捷方式。如果您的 LLM 不支持工具调用，您仍然可以使用它——您只需要编写一些逻辑将原始 LLM 字符串响应转换为决策。LangGraph 是否适用于 OSS LLM？
是的！LangGraph 对底层使用的 LLM 完全不敏感。我们在大多数教程中使用闭源 LLM 的主要原因是它们无缝支持工具调用，而 OSS LLM 通常不支持。但工具调用并非必需（参见此部分），因此您可以完全将 LangGraph 与 OSS LLM 一起使用。我可以在不登录 LangSmith 的情况下使用 Studio 吗？
是的！您可以使用LangGraph Server 的开发版本在本地运行后端。这将连接到作为 LangSmith 一部分托管的 Studio 前端。如果您设置环境变量LANGSMITH_TRACING=false，则不会向 LangSmith 发送任何跟踪。
“执行的节点”对 LangSmith 的使用意味着什么？
已执行节点是指在应用程序调用期间成功调用并完成的 LangGraph 应用程序中的节点总数。如果图中的节点在执行期间未被调用或以错误状态结束，则不会计算这些节点。如果一个节点被多次调用并成功完成，则每次出现都将被计算。以编程方式连接这些文档到 Claude、VSCode 等，通过 MCP 获取实时答案。