자주 묻는 질문

자주 묻는 질문 (FAQ)

출처: 문서

본문

관측 가능성 (Observability)

UI에서 API 키를 만들거나 사용자를 관리할 수 없어요. 무엇이 문제인가요?

SSO를 설정하지 않고 LangSmith를 배포했을 가능성이 높아요. LangSmith는 사용자와 API 키를 관리하기 위해 SSO를 요구해요. SSO 설정에 대한 자세한 내용은 구성 섹션에서 확인할 수 있어요.

로드 밸런싱/인그레스는 어떻게 작동하나요?

프론트엔드 컨테이너/서비스를 애플리케이션/사용자에게 노출해야 해요. 이는 모든 다운스트림 서비스로의 라우팅을 처리해요.
SSL은 인그레스 레벨에서 종료해야 해요. AWS ALB, GCP Load Balancer, Nginx 같은 관리형 서비스를 권장해요.

애플리케이션에 어떻게 인증하나요?

현재 셀프 호스팅 솔루션은 인증(authentication) 솔루션으로 OAuth2.0 및 OIDC를 사용한 SSO를 지원해요. no-auth 솔루션도 제공하지만, 프로덕션으로 넘어가기 전에 oauth를 설정하는 것을 강력히 권장해요.

SSO 설정에 대한 자세한 내용은 구성 섹션에서 확인할 수 있어요.

외부 스토리지 서비스를 사용할 수 있나요?

모든 스토리지 서비스의 외부 버전을 사용하도록 LangSmith를 구성할 수 있어요. 프로덕션 환경에서는 외부 스토리지 서비스를 사용하는 것을 강력히 권장해요. 자세한 내용은 구성 섹션을 확인해요.

애플리케이션이 제대로 작동하려면 이그레스가 필요한가요?

우리 배포는 몇 가지만을 위해 이그레스가 필요해요 (대부분 VPC 내에 있을 수 있어요):

이미지 가져오기 (이미지를 미러링한다면 필요 없을 수 있음)
LLM 엔드포인트와 통신
구성한 외부 스토리지 서비스와 통신
OAuth 정보 가져오기
구독 지표 및 운영 메타데이터 (오프라인 모드로 실행하지 않는 경우)
- https://beacon.langchain.com으로의 이그레스 필요
- 자세한 내용은 이그레스 참조

VPC에서 다른 모든 접근을 제한하는 규칙을 설정할 수 있어요. 참고: X-Organization-Id와 X-Tenant-Id 헤더가 백엔드 서비스로 전달되도록 허용해야 해요. 이 헤더는 요청이 어느 조직과 워크스페이스(이전 "tenant")에 대한 것인지 결정하는 데 사용돼요.

애플리케이션의 리소스 요구사항은?

Kubernetes에서는 medium size example에서 볼 수 있는 최소 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에서 중복 사용자를 피하기 위해 다음 단계를 따르는 것을 권장해요:

조직에서 사용자를 제거해요 (사용자 관리 참조: manage users)
IdP에서 이메일 주소를 변경해요.
사용자가 SAML SSO로 LangSmith에 다시 로그인하게 해요 - 이렇게 하면 새 이메일 주소로 일반적인 JIT 프로비저닝 흐름이 트리거돼요.

여러 연결된 로그인 방법이 있는 사용자에 대해서는 SCIM 또는 다른 방식으로 이메일 주소를 변경하는 것이 현재 지원되지 않아요. 이 오류 메시지가 표시돼요: email update not supported with linked login methods. 예를 들어, 사용자가 이전에 이메일/비밀번호나 Google 소셜 로그인으로 로그인했다가 같은 이메일 주소로 SSO로 추가된 경우, 이메일 주소 변경이 지원되지 않아요. 이는 self-hosted와 cloud 모두에 적용돼요.

ID 프로바이더를 변경할 수 있나요?

마이그레이션 지원을 위해 https://support.langchain.com 포털을 통해 LangChain 지원팀에 문의해요.

"405 method not allowed"를 어떻게 해결하나요?

올바른 ACS URL을 사용하고 있는지 확인하세요: https://auth.langchain.com/auth/v1/sso/saml/acs

SCIM FAQ

SAML SSO 없이 SCIM을 사용할 수 있나요?

클라우드: 아니요, 클라우드 배포에서 SCIM에는 SAML SSO가 필요해요.
셀프 호스팅: 예, SCIM은 Client Secret 인증 모드의 OAuth와 함께 작동해요.

JIT 프로비저닝과 SCIM이 모두 활성화되어 있으면 어떻게 되나요?

JIT 프로비저닝과 SCIM은 서로 충돌할 수 있어요. 일관된 사용자 프로비저닝 동작을 보장하려면 SCIM을 활성화하기 전에 JIT 프로비저닝을 비활성화하는 것을 권장해요.

사용자의 역할 또는 워크스페이스 접근을 어떻게 변경하나요?

IdP에서 사용자의 그룹 멤버십을 업데이트해요. 변경 사항은 역할 우선순위 규칙에 따라 LangSmith에 동기화돼요.

사용자가 모든 그룹에서 제거되면 어떻게 되나요?

IdP의 디프로비저닝 설정에 따라 사용자가 LangSmith 조직에서 디프로비저닝돼요.

커스텀 그룹 이름을 사용할 수 있나요?

예. ID 프로바이더가 displayName 그룹 속성에 대체 필드를 동기화하는 것을 지원한다면, LangSmith의 displayName으로 대체 속성(예: description)을 사용하고 ID 프로바이더 그룹 이름의 완전한 커스터마이징을 유지할 수 있어요. 그렇지 않으면 그룹은 LangSmith 역할과 워크스페이스에 제대로 매핑되도록 Group Naming Convention 섹션에 설명된 특정 명명 규칙을 따라야 해요.

또한 기본 콜론(:) 대신 커스텀 구분자(예: -, _, &)를 구성해 그룹 이름 문자에 제한이 있는 ID 프로바이더를 수용할 수 있어요.

Okta 통합이 왜 작동하지 않나요?

Okta의 문제 해결 가이드를 참조하세요: https://help.okta.com/en-us/content/topics/users-groups-profiles/usgp-group-push-troubleshoot.htm.

다운그레이드가 지원되나요?

다운그레이드는 공식적으로 지원되지 않아요. LangSmith 업그레이드에는 이전 버전과 호환되지 않는 데이터베이스 마이그레이션 및 기타 변경 사항이 포함될 수 있어요. 이전 버전으로 롤백해야 한다면 지원 포털을 통해 기술 지원에 문의해 안내를 받으세요.

배포 (Deployment)

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
배포	자체 관리	• Cloud • 무료 셀프 호스팅 • Enterprise (유료 셀프 호스팅)
확장성	자체 관리	작업 큐 및 서버 자동 확장
장애 허용성	자체 관리	자동 재시도
동시성 제어	단순 스레딩	double-texting 지원
스케줄링	없음	Cron 스케줄링
모니터링	없음	관측 가능성을 위한 LangSmith와 통합
IDE 통합	Studio	Studio

LangSmith는 오픈 소스인가요?

아니요. LangSmith는 독점 소프트웨어예요.

자세한 내용은 LangSmith 가격 페이지를 참조해요.

LangGraph는 도구 호출을 지원하지 않는 LLM과 작동하나요?

예! 모든 LLM과 함께 LangGraph를 사용할 수 있어요. 도구 호출을 지원하는 LLM을 사용하는 주된 이유는 LLM이 무엇을 할지 결정을 내리게 하는 가장 편리한 방법이기 때문이에요. LLM이 도구 호출을 지원하지 않아도, 원시 LLM 문자열 응답을 무엇을 할지에 대한 결정으로 변환하는 약간의 로직을 작성하기만 하면 여전히 사용할 수 있어요.

LangGraph는 OSS LLM과 작동하나요?

예! LangGraph는 내부에서 어떤 LLM이 사용되든 전혀 무관해요. 대부분의 튜토리얼에서 폐쇄형 LLM을 사용하는 주된 이유는 폐쇄형 LLM이 도구 호출을 완벽하게 지원하는 반면 OSS LLM은 종종 그렇지 않기 때문이에요. 하지만 도구 호출은 필수가 아니므로(LangGraph는 도구 호출을 지원하지 않는 LLM과 작동하나요? 참조), OSS LLM과 함께 LangGraph를 완전히 사용할 수 있어요.

LangSmith에 로그인하지 않고 Studio를 사용할 수 있나요?

예! 에이전트 서버의 개발 버전을 사용해 백엔드를 로컬에서 실행할 수 있어요. 이렇게 하면 LangSmith의 일부로 호스팅되는 Studio 프론트엔드에 연결돼요. LANGSMITH_TRACING=false 환경 변수를 설정하면 LangSmith로 트레이스가 전송되지 않아요.

Deployment Run이란 무엇인가요?

Deployment Run은 LangSmith Deployment를 통해 배포된 LangGraph 에이전트의 한 번의 엔드투엔드 호출이에요. 노드와 서브그래프는 별도로 청구되지 않아요. 다른 LangGraph 에이전트에 대한 호출(RemoteGraph 또는 LangGraph SDK 또는 API를 직접 통해)은 호출되는 에이전트를 호스팅하는 배포에 별도로 청구돼요. 인간-인-더-루프를 위한 인터럽트는 재개 시 별도의 Deployment Run을 만들어요.

자주 묻는 질문