Skip to main content

可观测性

我无法在UI中创建API密钥或管理用户,怎么回事?

您可能已经部署了LangSmith,但没有设置SSO。LangSmith需要SSO来管理用户和API密钥。您可以在配置部分找到有关设置SSO的更多信息。

负载均衡/入口工作原理是怎样的

您需要将前端容器/服务暴露给您的应用程序/用户。这将处理对所有下游服务的路由。 您需要在入口级别终止SSL。我们建议使用像AWS ALB、GCP负载均衡器或Nginx这样的托管服务。

如何对应用程序进行身份验证?

目前,我们的自托管解决方案支持使用OAuth2.0和OIDC作为认证解决方案进行单点登录。请注意,我们确实提供无认证解决方案,但强烈建议在生产环境中部署之前设置OAuth。 您可以在配置部分找到有关设置单点登录的更多信息。

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

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

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

我们的部署只需要为数不多的出站流量(其中大部分可以驻留在您的VPC内):
  • 获取图片(如果镜像您的图片,可能不需要此步骤)
与任何LLM端点进行对话 与您可能已配置的任何外部存储服务进行通信
  • 获取 OAuth 信息
  • 订阅指标和操作元数据(如果不在离线模式下运行)
  • 需要访问 https://beacon.langchain.com
  • 有关更多信息,请参阅 出口
您的VPC可以设置规则以限制其他访问。注意:我们需要允许X-Organization-IdX-Tenant-Id头信息通过到后端服务。这些信息用于确定请求是为哪个组织和工作空间(之前称为“租户”)的。

应用程序的资源需求是什么?

  • 在 Kubernetes 中,我们推荐至少配置 Helm,配置信息可在此处找到。对于 Docker,我们推荐至少 16GB 的内存和 4 个 CPU。
  • 对于 Postgres,我们推荐至少 8GB 的内存和 2 个 CPU。
  • 对于 Redis,我们推荐 4GB 的内存和 2 个 CPU。
  • 对于 Clickhouse,我们推荐 32GB 的内存和 8 个 CPU。

SAML 单点登录常见问题解答

如何更改SAML SSO用户的电子邮件地址?

一些身份提供者在通过电子邮件更改时保留原始的 User ID,而另一些则不保留,因此我们建议您遵循以下步骤以避免在LangSmith中出现重复用户:
  1. 从组织中移除用户(见此处)
  2. 在身份提供者(IdP)中更改他们的电子邮件地址
  3. 让他们通过SAML单点登录(SSO)再次登录LangSmith - 这将触发带有新电子邮件地址的常规JIT配置流程

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

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

SCIM 常见问题解答

我可以在没有SAML单点登录的情况下使用SCIM吗?

  • 云服务: 不,在云部署中,SCIM需要SAML单点登录
  • 自托管: 是的,SCIM可以与OAuth配合使用,并采用客户端密钥认证模式

如果同时启用了JIT配置和SCIM会发生什么?

即时供应和SCIM可能会相互冲突。我们建议在启用SCIM之前禁用即时供应,以确保用户供应行为的连续性。

如何更改用户的角色或工作空间访问权限?

更新您的身份提供者(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。

部署

使用LangGraph是否需要使用LangChain?两者有什么区别?

No. LangGraph 是一个用于复杂智能体系统的编排框架,比 LangChain 智能体更底层、更可控。LangChain 提供了一个标准接口,用于与模型和其他组件交互,适用于直接的链式操作和检索流程。

LangGraph与其他智能体框架有何不同?

其他智能体框架可以处理简单的通用任务,但对于满足公司特定需求的复杂任务则显得不足。LangGraph提供了一个更具表现力的框架,可以处理公司的独特任务,同时不限制用户使用单一的黑色盒子认知架构。

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

LangGraph 不会给您的代码增加任何开销,并且专门针对流式工作流程进行设计。

LangGraph是否开源?是否免费?

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

LangGraph 和 LangSmith 有何不同?

LangGraph是一个有状态的编排框架,为智能体工作流程带来额外的控制。LangSmith是一个用于部署和扩展智能体应用的服务,提供用于构建智能体用户界面的有观点API,以及集成的开发者UI。
特性LangGraph(开源)LangSmith
描述用于智能体应用的具有状态编排框架部署 LangGraph 应用可扩展的基础设施
SDKsPython 和 JavaScriptPython 和 JavaScript
HTTP APIs是 - 用于检索和更新状态或长期记忆,或创建可配置的助手
流式传输基础版专为按令牌逐个消息的专用模式
Checkpointer社区贡献的开箱即用支持
持久层自管理管理型 Postgres,具有高效的存储
部署自管理• 云服务
• 免费自托管
• 企业版(付费自托管)
可扩展性自管理任务队列和服务器自动扩展
容错性自管理自动重试
并发控制简单线程支持双文输入
调度Cron 调度
监控与 LangSmith 集成以实现可观察性
IDE 集成StudioStudio

LangSmith是否开源?

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

LangGraph是否支持与不支持工具调用的LLMs协同工作?

是的!您可以使用 LangGraph 与任何大型语言模型(LLMs)配合使用。我们主要使用支持工具调用的 LLM 的原因是因为这通常是 LLM 做出决策关于做什么的最方便方式。如果您的 LLM 不支持工具调用,您仍然可以使用它——您只需要编写一些逻辑来将原始的 LLM 字符串响应转换为关于做什么的决策。

LangGraph是否与开源LLM(大型语言模型)兼容?

是的!LangGraph对底层使用的LLM持完全中立的态度。我们大多数教程中使用封闭式LLM的主要原因是因为它们无缝支持工具调用,而开源LLM通常不支持。但是工具调用并非必要(见本节),因此您完全可以使用LangGraph与开源LLM配合使用。

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

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

“已执行节点”对LangSmith的使用意味着什么?

已执行节点数是指在LangGraph应用程序调用过程中,成功调用并完成的节点总数。如果在执行过程中某个图中的节点未被调用或以错误状态结束,这些节点将不会被计算。如果一个节点被调用并多次成功完成,每次出现都将被计算。