LangSmith on Cloud

​

사전 요구사항

1. LangSmith 애플리케이션은 GitHub 리포지토리에서 배포됩니다. LangSmith에 배포하려면 LangSmith 애플리케이션을 구성하고 GitHub 리포지토리에 업로드하세요.
2. LangGraph API가 로컬에서 실행되는지 확인하세요. API가 성공적으로 실행되지 않으면 (예: langgraph dev), LangSmith에 배포하는 것도 실패합니다.

​

새 배포 생성

1. 왼쪽 탐색 패널에서 Deployments를 선택하면 기존 배포 목록이 표시됩니다.
2. 오른쪽 상단에서 + New Deployment를 선택하여 새 배포를 생성합니다.
3. Create New Deployment 패널에서 필수 필드를 입력합니다.
4. Deployment details
5. Import from GitHub를 선택하고 GitHub OAuth 워크플로우를 따라 LangChain의 hosted-langserve GitHub 앱을 설치하고 선택한 리포지토리에 대한 액세스를 승인합니다. 설치가 완료되면 Create New Deployment 패널로 돌아가서 드롭다운 메뉴에서 배포할 GitHub 리포지토리를 선택합니다. 참고: LangChain의 hosted-langserve GitHub 앱을 설치하는 GitHub 사용자는 조직 또는 계정의 소유자여야 합니다.
6. 배포의 이름을 지정합니다.
7. 원하는 Git Branch를 지정합니다. 배포는 브랜치에 연결됩니다. 새 리비전이 생성되면 연결된 브랜치의 코드가 배포됩니다. 브랜치는 나중에 배포 설정에서 업데이트할 수 있습니다.
8. 파일 이름을 포함한 LangGraph API config 파일의 전체 경로를 지정합니다. 예를 들어, langgraph.json 파일이 리포지토리의 루트에 있는 경우 단순히 langgraph.json을 지정합니다.
9. Automatically update deployment on push to branch 체크박스를 선택/해제합니다. 선택하면 지정된 Git Branch에 변경 사항이 푸시될 때 배포가 자동으로 업데이트됩니다. 이 설정은 나중에 배포 설정에서 활성화/비활성화할 수 있습니다.
10. 원하는 Deployment Type을 선택합니다.
11. Development 배포는 비프로덕션 사용 사례를 위한 것이며 최소한의 리소스로 프로비저닝됩니다.
12. Production 배포는 초당 최대 500개의 요청을 처리할 수 있으며 자동 백업이 포함된 고가용성 스토리지로 프로비저닝됩니다.
13. 배포가 Shareable through Studio인지 결정합니다.
14. 선택하지 않으면 배포는 워크스페이스에 대한 유효한 LangSmith API key로만 액세스할 수 있습니다.
15. 선택하면 배포는 모든 LangSmith 사용자가 Studio를 통해 액세스할 수 있습니다. 다른 LangSmith 사용자와 공유할 수 있는 배포용 Studio 직접 URL이 제공됩니다.
16. Environment Variables 및 secrets를 지정합니다. 배포에 대한 추가 변수를 구성하려면 Environment Variables 참조를 참조하세요.
17. API key와 같은 민감한 값(예: OPENAI_API_KEY)은 secrets로 지정해야 합니다.
18. 추가 비밀이 아닌 환경 변수도 지정할 수 있습니다.
19. 배포와 동일한 이름의 새 LangSmith Tracing Project가 자동으로 생성됩니다.
20. 오른쪽 상단에서 Submit을 선택합니다. 몇 초 후 Deployment 뷰가 나타나고 새 배포가 프로비저닝 대기열에 추가됩니다.

​

새 리비전 생성

1. 왼쪽 탐색 패널에서 Deployments를 선택하면 기존 배포 목록이 표시됩니다.
2. 새 리비전을 생성할 기존 배포를 선택합니다.
3. Deployment 뷰에서 오른쪽 상단의 + New Revision을 선택합니다.
4. New Revision 모달에서 필수 필드를 입력합니다.
5. 파일 이름을 포함한 LangGraph API config 파일의 전체 경로를 지정합니다. 예를 들어, langgraph.json 파일이 리포지토리의 루트에 있는 경우 단순히 langgraph.json을 지정합니다.
6. 배포가 Shareable through Studio인지 결정합니다.
7. 선택하지 않으면 배포는 워크스페이스에 대한 유효한 LangSmith API key로만 액세스할 수 있습니다.
8. 선택하면 배포는 모든 LangSmith 사용자가 Studio를 통해 액세스할 수 있습니다. 다른 LangSmith 사용자와 공유할 수 있는 배포용 Studio 직접 URL이 제공됩니다.
9. Environment Variables 및 secrets를 지정합니다. 기존 secrets 및 환경 변수가 미리 채워집니다. 리비전에 대한 추가 변수를 구성하려면 Environment Variables 참조를 참조하세요.
10. 새 secrets 또는 환경 변수를 추가합니다.
11. 기존 secrets 또는 환경 변수를 제거합니다.
12. 기존 secrets 또는 환경 변수의 값을 업데이트합니다.
13. Submit을 선택합니다. 몇 초 후 New Revision 모달이 닫히고 새 리비전이 배포 대기열에 추가됩니다.

​

빌드 및 서버 로그 보기

1. Revisions 테이블에서 원하는 리비전을 선택합니다. 오른쪽에서 패널이 슬라이드되어 열리고 기본적으로 Build 탭이 선택되며 리비전의 빌드 로그가 표시됩니다.
2. 패널에서 Server 탭을 선택하여 리비전의 서버 로그를 봅니다. 서버 로그는 리비전이 배포된 후에만 사용할 수 있습니다.
3. Server 탭 내에서 필요에 따라 날짜/시간 범위 선택기를 조정합니다. 기본적으로 날짜/시간 범위 선택기는 Last 7 days로 설정됩니다.

​

배포 메트릭 보기

1. 왼쪽 탐색 패널에서 Deployments를 선택하면 기존 배포 목록이 표시됩니다.
2. 모니터링할 기존 배포를 선택합니다.
3. Monitoring 탭을 선택하여 배포 메트릭을 봅니다. 사용 가능한 모든 메트릭 목록을 참조하세요.
4. Monitoring 탭 내에서 필요에 따라 날짜/시간 범위 선택기를 사용합니다. 기본적으로 날짜/시간 범위 선택기는 Last 15 minutes로 설정됩니다.

​

리비전 중단

1. Revisions 테이블에서 원하는 리비전의 행 오른쪽에 있는 메뉴 아이콘(점 세 개)을 선택합니다.
2. 메뉴에서 Interrupt를 선택합니다.
3. 모달이 나타납니다. 확인 메시지를 검토합니다. Interrupt revision을 선택합니다.

​

배포 삭제

1. 왼쪽 탐색 패널에서 Deployments를 선택하면 기존 배포 목록이 표시됩니다.
2. 원하는 배포의 행 오른쪽에 있는 메뉴 아이콘(점 세 개)을 선택하고 Delete를 선택합니다.
3. Confirmation 모달이 나타납니다. Delete를 선택합니다.

​

배포 설정

1. 오른쪽 상단에서 톱니바퀴 아이콘(Deployment Settings)을 선택합니다.
2. Git Branch를 원하는 브랜치로 업데이트합니다.
3. Automatically update deployment on push to branch 체크박스를 선택/해제합니다.
4. 브랜치 생성/삭제 및 태그 생성/삭제 이벤트는 업데이트를 트리거하지 않습니다. 기존 브랜치에 대한 푸시만 업데이트를 트리거합니다.
5. 브랜치에 빠르게 연속으로 푸시하면 후속 업데이트가 대기열에 추가됩니다. 빌드가 완료되면 가장 최근 커밋이 빌드를 시작하고 대기열에 있는 다른 빌드는 건너뜁니다.

​

GitHub 리포지토리 추가 또는 제거

1. GitHub 프로필에서 Settings > Applications > hosted-langserve > Configure 클릭으로 이동합니다.
2. Repository access에서 All repositories 또는 Only select repositories를 선택합니다. Only select repositories를 선택한 경우 새 리포지토리를 명시적으로 추가해야 합니다.
3. Save를 클릭합니다.
4. 새 배포를 생성할 때 드롭다운 메뉴의 GitHub 리포지토리 목록이 리포지토리 액세스 변경 사항을 반영하도록 업데이트됩니다.

​

IP 주소 허용 목록 추가