​
Safari 连接问题

Safari 阻止 localhost 上的纯 HTTP 流量。使用 langgraph dev 运行 Studio 时，您可能会看到”Failed to load assistants”错误。

​
解决方案 1：使用 Cloudflare Tunnel

  • Python
  • JS
pip install -U langgraph-cli>=0.2.6
langgraph dev --tunnel
该命令输出以下格式的 URL： 
https://smith.langchain.com/studio/?baseUrl=https://hamilton-praise-heart-costumes.trycloudflare.com
在 Safari 中使用此 URL 加载 Studio。在这里，baseUrl 参数指定您的智能体服务器端点。

​
解决方案 2：使用 Chromium 浏览器

Chrome 和其他 Chromium 浏览器允许 localhost 上的 HTTP。使用 langgraph dev 而无需额外配置。

​
Brave 连接问题

当启用 Brave Shields 时，Brave 阻止 localhost 上的纯 HTTP 流量。使用 langgraph dev 运行 Studio 时，您可能会看到”Failed to load assistants”错误。

​
解决方案 1：禁用 Brave Shields

使用 URL 栏中的 Brave 图标为 LangSmith 禁用 Brave Shields。

​
解决方案 2：使用 Cloudflare Tunnel

  • Python
  • JS
pip install -U langgraph-cli>=0.2.6
langgraph dev --tunnel
该命令输出以下格式的 URL： 
https://smith.langchain.com/studio/?baseUrl=https://hamilton-praise-heart-costumes.trycloudflare.com
在 Brave 中使用此 URL 加载 Studio。在这里，baseUrl 参数指定您的智能体服务器端点。

​
图边缘问题

未定义的条件边缘可能在图中显示意外的连接。这是因为如果没有适当的定义，Studio 假设条件边缘可以访问所有其他节点。要解决此问题，请使用以下方法之一明确定义路由路径：

​
解决方案 1：路径映射

定义路由器输出和目标节点之间的映射：
  • Python
  • Javascript
graph.add_conditional_edges("node_a", routing_function, {True: "node_b", False: "node_c"})

​
解决方案 2：路由器类型定义

使用 Python 的 Literal 类型指定可能的路由目标： 
def routing_function(state: GraphState) -> Literal["node_b","node_c"]:
    if state['some_condition'] == True:
        return "node_b"
    else:
        return "node_c"

​
Studio 中的实验故障排除

​
运行实验按钮被禁用

检查以下内容：
  • 已部署的应用程序：如果您的应用程序部署在 LangSmith 上，您可能需要创建新修订版以启用此功能。
  • 本地开发服务器：如果您在本地运行应用程序，请确保已升级到最新版本的 langgraph-cli（pip install -U langgraph-cli）。此外，通过在项目的 .env 文件中设置 LANGSMITH_API_KEY 确保已启用跟踪。

​
评估器结果缺失

运行实验时，所有附加的评估器都计划在队列中执行。如果您没有立即看到结果，很可能是它们仍在待处理中。
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.