관찰성
UI에서 API 키를 생성하거나 사용자를 관리할 수 없습니다. 무엇이 문제인가요?
- SSO 설정 없이 LangSmith를 배포한 것으로 보입니다. LangSmith는 사용자 및 API 키 관리를 위해 SSO가 필요합니다. SSO 설정에 대한 자세한 내용은 구성 섹션에서 확인할 수 있습니다.
로드 밸런싱/인그레스는 어떻게 작동하나요?
- 프론트엔드 컨테이너/서비스를 애플리케이션/사용자에게 노출해야 합니다. 이를 통해 모든 다운스트림 서비스로의 라우팅이 처리됩니다.
- 인그레스 수준에서 SSL을 종료해야 합니다. AWS ALB, GCP Load Balancer 또는 Nginx와 같은 관리형 서비스 사용을 권장합니다.
애플리케이션에 어떻게 인증하나요?
- 현재 자체 호스팅 솔루션은 인증 솔루션으로 OAuth2.0 및 OIDC를 통한 SSO를 지원합니다. 인증 없는 솔루션도 제공하지만, 프로덕션 환경으로 전환하기 전에 OAuth 설정을 강력히 권장합니다.
외부 스토리지 서비스를 사용할 수 있나요?
- 모든 스토리지 서비스의 외부 버전을 사용하도록 LangSmith를 구성할 수 있습니다. 프로덕션 환경에서는 외부 스토리지 서비스 사용을 강력히 권장합니다. 자세한 내용은 구성 섹션을 확인하세요.
애플리케이션이 제대로 작동하려면 이그레스가 필요한가요?
다음 몇 가지 항목을 위해서만 이그레스가 필요합니다(대부분은 VPC 내에 위치할 수 있습니다):- 이미지 가져오기(이미지를 미러링하는 경우 필요하지 않을 수 있음)
- LLM 엔드포인트와 통신
- 구성한 외부 스토리지 서비스와 통신
- OAuth 정보 가져오기
-
구독 메트릭 및 운영 메타데이터(오프라인 모드로 실행하지 않는 경우)
https://beacon.langchain.com으로의 이그레스 필요- 자세한 내용은 이그레스를 참조하세요
X-Organization-Id 및 X-Tenant-Id 헤더가 허용되어야 합니다. 이들은 요청이 어느 조직 및 워크스페이스(이전 명칭: “tenant”)에 대한 것인지 판단하는 데 사용됩니다.
애플리케이션의 리소스 요구사항은 무엇인가요?
- Kubernetes에서는 여기에서 확인할 수 있는 최소 Helm 구성을 권장합니다. Docker의 경우 최소 16GB RAM과 4개의 CPU를 권장합니다.
- Postgres의 경우 최소 8GB RAM과 2개의 CPU를 권장합니다.
- Redis의 경우 4GB RAM과 2개의 CPU를 권장합니다.
- Clickhouse의 경우 32GB RAM과 8개의 CPU를 권장합니다.
SAML SSO FAQ
SAML SSO 사용자의 이메일 주소를 어떻게 변경하나요?
일부 ID 제공자는 이메일 변경 시 원래의User ID를 유지하지만 그렇지 않은 경우도 있으므로, LangSmith에서 중복 사용자를 방지하기 위해 다음 단계를 따르는 것을 권장합니다:
- 조직에서 사용자 제거(여기 참조)
- IdP에서 이메일 주소 변경
- SAML SSO를 통해 LangSmith에 다시 로그인하도록 요청 - 새 이메일 주소로 일반적인 JIT 프로비저닝 플로우가 실행됩니다
”405 method not allowed” 오류를 어떻게 해결하나요?
올바른 ACS URL을 사용하고 있는지 확인하세요: https://auth.langchain.com/auth/v1/sso/saml/acsSCIM FAQ
SAML SSO 없이 SCIM을 사용할 수 있나요?
- 클라우드: 아니요, 클라우드 배포에서 SCIM을 사용하려면 SAML SSO가 필요합니다
- 자체 호스팅: 예, SCIM은 클라이언트 시크릿 인증 모드의 OAuth와 함께 작동합니다
JIT 프로비저닝과 SCIM을 모두 활성화하면 어떻게 되나요?
JIT 프로비저닝과 SCIM은 서로 충돌할 수 있습니다. 일관된 사용자 프로비저닝 동작을 보장하기 위해 SCIM을 활성화하기 전에 JIT 프로비저닝을 비활성화하는 것을 권장합니다.사용자의 역할이나 워크스페이스 액세스를 어떻게 변경하나요?
IdP에서 사용자의 그룹 멤버십을 업데이트하세요. 변경 사항은 역할 우선순위 규칙에 따라 LangSmith에 동기화됩니다.사용자가 모든 그룹에서 제거되면 어떻게 되나요?
사용자는 IdP의 프로비저닝 해제 설정에 따라 LangSmith 조직에서 프로비저닝 해제됩니다.사용자 정의 그룹 이름을 사용할 수 있나요?
예. ID 제공자가displayName 그룹 속성에 대체 필드 동기화를 지원하는 경우, LangSmith에서 displayName으로 대체 속성(예: description)을 사용하고 ID 제공자 그룹 이름의 전체 사용자 정의 기능을 유지할 수 있습니다. 그렇지 않은 경우, 그룹은 LangSmith 역할 및 워크스페이스에 올바르게 매핑되도록 그룹 명명 규칙 섹션에 설명된 특정 명명 규칙을 따라야 합니다.
Okta 통합이 작동하지 않는 이유는 무엇인가요?
Okta의 문제 해결 가이드를 참조하세요: https://help.okta.com/en-us/content/topics/users-groups-profiles/usgp-group-push-troubleshoot.htm.배포
LangGraph를 사용하려면 LangChain이 필요한가요? 차이점은 무엇인가요?
아니요. LangGraph는 복잡한 에이전트 시스템을 위한 오케스트레이션 프레임워크이며, LangChain 에이전트보다 더 저수준이고 제어 가능합니다. LangChain은 모델 및 다른 컴포넌트와 상호 작용하기 위한 표준 인터페이스를 제공하며, 직관적인 체인 및 검색 플로우에 유용합니다.LangGraph는 다른 에이전트 프레임워크와 어떻게 다른가요?
다른 에이전트 프레임워크는 단순하고 일반적인 작업에는 적합하지만, 기업의 고유한 요구에 맞는 복잡한 작업에는 부족합니다. LangGraph는 사용자를 단일 블랙박스 인지 아키텍처로 제한하지 않으면서 기업의 고유한 작업을 처리할 수 있는 더 표현력 있는 프레임워크를 제공합니다.LangGraph가 내 앱의 성능에 영향을 미치나요?
LangGraph는 코드에 어떤 오버헤드도 추가하지 않으며, 특히 스트리밍 워크플로우를 염두에 두고 설계되었습니다.LangGraph는 오픈 소스인가요? 무료인가요?
예. LangGraph는 MIT 라이선스의 오픈 소스 라이브러리이며 무료로 사용할 수 있습니다.LangGraph와 LangSmith는 어떻게 다른가요?
LangGraph는 에이전트 워크플로우에 제어 기능을 추가하는 상태 저장 오케스트레이션 프레임워크입니다. LangSmith는 에이전트 애플리케이션을 배포하고 확장하기 위한 서비스이며, 에이전트 UX 구축을 위한 주관적인 API와 통합 개발자 UI를 제공합니다.| 기능 | LangGraph (오픈 소스) | LangSmith |
|---|---|---|
| 설명 | 에이전트 애플리케이션을 위한 상태 저장 오케스트레이션 프레임워크 | LangGraph 애플리케이션 배포를 위한 확장 가능한 인프라 |
| SDK | Python 및 JavaScript | Python 및 JavaScript |
| HTTP API | 없음 | 예 - 상태 또는 장기 메모리를 검색 및 업데이트하거나 구성 가능한 어시스턴트를 생성하는 데 유용 |
| 스트리밍 | 기본 | 토큰 단위 메시지를 위한 전용 모드 |
| 체크포인터 | 커뮤니티 기여 | 기본 제공 지원 |
| 영속성 계층 | 자체 관리 | 효율적인 스토리지를 갖춘 관리형 Postgres |
| 배포 | 자체 관리 | • 클라우드 • 무료 자체 호스팅 • 엔터프라이즈 (유료 자체 호스팅) |
| 확장성 | 자체 관리 | 작업 큐 및 서버의 자동 확장 |
| 장애 허용 | 자체 관리 | 자동 재시도 |
| 동시성 제어 | 단순 스레딩 | 이중 텍스팅 지원 |
| 스케줄링 | 없음 | Cron 스케줄링 |
| 모니터링 | 없음 | 관찰성을 위한 LangSmith 통합 |
| IDE 통합 | Studio | Studio |
LangSmith는 오픈 소스인가요?
아니요. LangSmith는 독점 소프트웨어입니다. 기본 기능에 액세스할 수 있는 무료 자체 호스팅 버전의 LangSmith가 있습니다. 클라우드 배포 옵션과 자체 호스팅 배포 옵션은 유료 서비스입니다. 자세한 내용은 영업 팀에 문의하세요. 자세한 내용은 LangSmith 가격 페이지를 참조하세요.도구 호출을 지원하지 않는 LLM에서 LangGraph가 작동하나요?
예! 모든 LLM과 함께 LangGraph를 사용할 수 있습니다. 도구 호출을 지원하는 LLM을 사용하는 주된 이유는 LLM이 무엇을 할지 결정하는 가장 편리한 방법이기 때문입니다. LLM이 도구 호출을 지원하지 않는 경우에도 사용할 수 있습니다. 다만 원시 LLM 문자열 응답을 무엇을 할지에 대한 결정으로 변환하는 약간의 로직을 작성해야 합니다.LangGraph는 OSS LLM과 함께 작동하나요?
예! LangGraph는 내부적으로 사용되는 LLM에 대해 완전히 독립적입니다. 대부분의 튜토리얼에서 폐쇄형 LLM을 사용하는 주된 이유는 도구 호출을 원활하게 지원하기 때문이며, 반면 OSS LLM은 종종 그렇지 않습니다. 하지만 도구 호출이 필수는 아니므로(이 섹션 참조) OSS LLM과 함께 LangGraph를 완전히 사용할 수 있습니다.LangSmith에 로그인하지 않고 Studio를 사용할 수 있나요?
예! LangGraph Server의 개발 버전을 사용하여 백엔드를 로컬에서 실행할 수 있습니다. 이는 LangSmith의 일부로 호스팅되는 Studio 프론트엔드에 연결됩니다. 환경 변수를LANGSMITH_TRACING=false로 설정하면 LangSmith로 추적이 전송되지 않습니다.
LangSmith 사용량에서 “노드 실행”이란 무엇을 의미하나요?
노드 실행은 애플리케이션 호출 중에 호출되고 성공적으로 완료된 LangGraph 애플리케이션의 노드 수를 집계한 것입니다. 실행 중에 그래프의 노드가 호출되지 않았거나 오류 상태로 종료된 경우, 해당 노드는 계산되지 않습니다. 노드가 여러 번 호출되고 성공적으로 완료되면 각 발생이 계산됩니다.Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.