可观测性
我无法在 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 FAQs
How do I change a SAML SSO user’s email address?
Some identity providers retain the originalUser ID through an email change while others do not, so we recommend that you follow these steps to avoid duplicate users in LangSmith:
- Remove the user from the organization (see here)
- Change their email address in the IdP
- Have them login to LangSmith again via SAML SSO - this will trigger the usual JIT provisioning flow with their new email address
How do I fix “405 method not allowed”?
Ensure you’re using the correct ACS URL: https://auth.langchain.com/auth/v1/sso/saml/acsSCIM FAQs
Can I use SCIM without SAML SSO?
- Cloud: No, SAML SSO is required for SCIM in cloud deployments
- Self-hosted: Yes, SCIM works with OAuth with Client Secret authentication mode
What happens if I have both JIT provisioning and SCIM enabled?
JIT provisioning and SCIM can conflict with each other. We recommend disabling JIT provisioning before enabling SCIM to ensure consistent user provisioning behavior.How do I change a user’s role or workspace access?
Update the user’s group membership in your IdP. The changes will be synchronized to LangSmith according to the role precedence rules.What happens when a user is removed from all groups?
The user will be deprovisioned from your LangSmith organization according to your IdP’s deprovisioning settings.Can I use custom group names?
Yes. If your identity provider supports syncing alternate fields to thedisplayName group attribute, you may use an alternate attribute (like description) as the displayName in LangSmith and retain full customizability of the identity provider group name. Otherwise, groups must follow the specific naming convention described in the Group Naming Convention section to properly map to LangSmith roles and workspaces.
Why is my Okta integration not working?
See Okta’s troubleshooting guide here: 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。| Features | LangGraph (open source) | LangSmith |
|---|---|---|
| Description | Stateful orchestration framework for agentic applications | Scalable infrastructure for deploying LangGraph applications |
| SDKs | Python and JavaScript | Python and JavaScript |
| HTTP APIs | None | Yes - useful for retrieving & updating state or long-term memory, or creating a configurable assistant |
| Streaming | Basic | Dedicated mode for token-by-token messages |
| Checkpointer | Community contributed | Supported out-of-the-box |
| Persistence Layer | Self-managed | Managed Postgres with efficient storage |
| Deployment | Self-managed | • Cloud • Free self-hosted • Enterprise (paid self-hosted) |
| Scalability | Self-managed | Auto-scaling of task queues and servers |
| Fault-tolerance | Self-managed | Automated retries |
| Concurrency Control | Simple threading | Supports double-texting |
| Scheduling | None | Cron scheduling |
| Monitoring | None | Integrated with LangSmith for observability |
| IDE integration | Studio | Studio |
Is LangSmith open source?
No. LangSmith is proprietary software. There is a free, self-hosted version of LangSmith with access to basic features. The Cloud deployment option and the Self-Hosted deployment options are paid services. Contact our sales team to learn more. For more information, see our LangSmith pricing page.Does LangGraph work with LLMs that don’t support tool calling?
Yes! You can use LangGraph with any LLMs. The main reason we use LLMs that support tool calling is that this is often the most convenient way to have the LLM make its decision about what to do. If your LLM does not support tool calling, you can still use it - you just need to write a bit of logic to convert the raw LLM string response to a decision about what to do.Does LangGraph work with OSS LLMs?
Yes! LangGraph is totally ambivalent to what LLMs are used under the hood. The main reason we use closed LLMs in most of the tutorials is that they seamlessly support tool calling, while OSS LLMs often don’t. But tool calling is not necessary (see this section) so you can totally use LangGraph with OSS LLMs.Can I use Studio without logging in to LangSmith?
Yes! You can use the development version of Agent Server to run the backend locally. This will connect to the Studio frontend hosted as part of LangSmith. If you set an environment variable ofLANGSMITH_TRACING=false, then no traces will be sent to LangSmith.