跳到主要内容

​
Safari 连接问题

Safari 会阻止 localhost 上的纯 HTTP 流量。当使用 langgraph dev 运行 Studio 时，你可能会看到“未能加载助手”错误。

​
解决方案 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 时，你可能会看到“未能加载助手”错误。

​
解决方案 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 来启用跟踪。

​
评估器结果缺失

当你运行实验时，任何附加的评估器都会被安排在队列中执行。如果你没有立即看到结果，那很可能意味着它们仍在等待处理。
在 GitHub 上编辑此页面源文件。
以编程方式连接这些文档到 Claude、VSCode 等，通过 MCP 获取实时答案。
© . This site is unofficial and not affiliated with LangChain, Inc.