​
Safari 연결 문제

Safari는 localhost에서 plain-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 파라미터는 agent server endpoint를 지정합니다.

​
해결 방법 2: Chromium 브라우저 사용

Chrome 및 기타 Chromium 브라우저는 localhost에서 HTTP를 허용합니다. 추가 설정 없이 langgraph dev를 사용하세요.

​
Brave 연결 문제

Brave는 Brave Shields가 활성화되어 있을 때 localhost에서 plain-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 파라미터는 agent server endpoint를 지정합니다.

​
Graph Edge 문제

정의되지 않은 conditional edge는 그래프에서 예상치 못한 연결을 표시할 수 있습니다. 이는 적절한 정의가 없으면 Studio가 conditional edge가 다른 모든 node에 접근할 수 있다고 가정하기 때문입니다. 이를 해결하려면 다음 방법 중 하나를 사용하여 routing path를 명시적으로 정의하세요:

​
해결 방법 1: Path Map

router 출력과 대상 node 간의 매핑을 정의하세요:
  • Python
  • Javascript
graph.add_conditional_edges("node_a", routing_function, {True: "node_b", False: "node_c"})

​
해결 방법 2: Router Type Definition

Python의 Literal type을 사용하여 가능한 routing 대상을 지정하세요: 
def routing_function(state: GraphState) -> Literal["node_b","node_c"]:
    if state['some_condition'] == True:
        return "node_b"
    else:
        return "node_c"

​
Studio에서 Experiment 문제 해결

​
Run experiment 버튼이 비활성화됨

다음을 확인하세요:
  • 배포된 application: application이 LangSmith에 배포된 경우, 이 기능을 활성화하려면 새 revision을 생성해야 할 수 있습니다.
  • 로컬 개발 서버: application을 로컬에서 실행하는 경우, 최신 버전의 langgraph-cli로 업그레이드했는지 확인하세요 (pip install -U langgraph-cli). 또한 프로젝트의 .env 파일에 LANGSMITH_API_KEY를 설정하여 tracing이 활성화되어 있는지 확인하세요.

​
Evaluator 결과가 누락됨

experiment를 실행하면 연결된 evaluator가 queue에서 실행되도록 예약됩니다. 결과가 즉시 표시되지 않으면 아직 대기 중일 가능성이 높습니다.
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
⌘I