常见问题解答

​

可观测性

​

我无法在界面中创建 API 密钥或管理用户，这是怎么回事？

• 您很可能在未设置 SSO 的情况下部署了 LangSmith。LangSmith 需要 SSO 来管理用户和 API 密钥。您可以在配置部分找到有关设置 SSO 的更多信息。

​

负载均衡/入口如何工作？

• 您需要将前端容器/服务暴露给您的应用程序/用户。这将处理到所有下游服务的路由。
• 您需要在入口层终止 SSL。我们建议使用 AWS ALB、GCP Load Balancer 或 Nginx 等托管服务。

​

我们如何对应用程序进行身份验证？

• 目前，我们的自托管解决方案支持使用 OAuth2.0 和 OIDC 作为身份验证解决方案的 SSO。请注意，我们确实提供无身份验证的解决方案，但强烈建议在投入生产环境之前设置 OAuth。

您可以在配置部分找到有关设置 SSO 的更多信息。

​

我可以使用外部存储服务吗？

• 您可以配置 LangSmith 使用所有存储服务的外部版本。在生产环境中，我们强烈建议使用外部存储服务。请查看配置部分获取更多信息。

​

我的应用程序需要出站流量才能正常工作吗？

我们的部署仅需要少量出站流量（其中大部分可以驻留在您的 VPC 内）：

• 获取镜像（如果您镜像了自己的镜像，则可能不需要）
• 与任何 LLM 端点通信
• 与您可能配置的任何外部存储服务通信
• 获取 OAuth 信息
• 订阅指标和操作元数据（如果未在离线模式下运行）
  • 需要出站流量到 https://beacon.langchain.com
  • 有关更多信息，请参阅出站流量

您的 VPC 可以设置规则来限制任何其他访问。注意：我们要求允许将 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 用户的电子邮件地址？

某些身份提供商在电子邮件更改时会保留原始的 User ID，而其他则不会，因此我们建议您遵循以下步骤以避免 LangSmith 中出现重复用户：

1. 从组织中移除该用户（参见管理用户）
2. 在 IdP 中更改其电子邮件地址
3. 让他们通过 SAML SSO 再次登录 LangSmith - 这将使用其新电子邮件地址触发通常的 JIT 配置流程

目前不支持通过 SCIM 或其他方式为具有多个关联登录方法的用户更改电子邮件地址。会显示此错误消息：email update not supported with linked login methods。例如，如果用户之前通过电子邮件/密码或 Google 社交登录登录，然后通过 SSO 使用相同的电子邮件地址添加，则不支持更改其电子邮件地址。这适用于自托管和云部署。

​

我可以更改身份提供商吗？

请通过我们的门户 https://support.langchain.com 联系 LangChain 支持团队以获取迁移支持。

​

如何修复“405 方法不允许”错误？

确保您使用的是正确的 ACS URL：https://auth.langchain.com/auth/v1/sso/saml/acs

​

SCIM 常见问题

​

我可以在没有 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。

​

是否支持降级？

不正式支持降级。LangSmith 升级可能包含数据库迁移和其他不向后兼容的更改。如果您需要回滚到以前的版本，请联系支持以获取指导。

​

部署

​

使用 LangGraph 需要使用 LangChain 吗？有什么区别？

不需要。LangGraph 是一个用于复杂代理系统的编排框架，比 LangChain 代理更底层且更可控。LangChain 提供与模型和其他组件交互的标准接口，适用于简单的链和检索流程。

​

LangGraph 与其他代理框架有何不同？

其他代理框架可以处理简单的通用任务，但对于公司特定需求的复杂任务则力不从心。LangGraph 提供了一个更具表现力的框架来处理公司的独特任务，而不会将用户限制在单一的黑盒认知架构中。

​

LangGraph 会影响我的应用程序性能吗？

LangGraph 不会为您的代码增加任何开销，并且专门针对流式工作流而设计。

​

LangGraph 是开源的吗？是免费的吗？

是的。LangGraph 是一个 MIT 许可的开源库，可以免费使用。

​

LangGraph 和 LangSmith 有什么区别？

LangGraph 是一个有状态的编排框架，为代理工作流提供额外的控制。LangSmith 是一个用于部署和扩展代理应用程序的服务，具有用于构建代理用户体验的专用 API，以及集成的开发者 UI。

​

LangSmith 是开源的吗？

不是。LangSmith 是专有软件。 有一个免费的自托管版本的 LangSmith，可以访问基本功能。云部署选项和自托管部署选项是付费服务。联系我们的销售团队了解更多信息。 有关更多信息，请参阅我们的 LangSmith 定价页面。

​

LangGraph 是否适用于不支持工具调用的 LLM？

是的！您可以将 LangGraph 与任何 LLM 一起使用。我们使用支持工具调用的 LLM 的主要原因是，这通常是让 LLM 决定做什么的最方便方式。如果您的 LLM 不支持工具调用，您仍然可以使用它 - 您只需要编写一些逻辑将原始的 LLM 字符串响应转换为关于做什么的决策。

​

LangGraph 是否适用于开源 LLM？

是的！LangGraph 完全不关心底层使用的是什么 LLM。我们在大多数教程中使用闭源 LLM 的主要原因是它们无缝支持工具调用，而开源 LLM 通常不支持。但工具调用不是必需的（参见 LangGraph 是否适用于不支持工具调用的 LLM？），因此您完全可以将 LangGraph 与开源 LLM 一起使用。

​

我可以在不登录 LangSmith 的情况下使用 Studio 吗？

可以！您可以使用 Agent Server 的开发版本在本地运行后端。 这将连接到作为 LangSmith 一部分托管的 Studio 前端。 如果您设置环境变量 LANGSMITH_TRACING=false，则不会向 LangSmith 发送任何跟踪。

​

什么是部署运行？

部署运行是通过 LangSmith 部署的 LangGraph 代理的一次端到端调用。节点和子图不单独收费。对其他 LangGraph 代理的调用（通过 RemoteGraph 或 LangGraph SDK 或直接通过 API）会单独收费，向托管被调用代理的部署收费。人机循环的中断在恢复时会创建一个单独的部署运行。

---