계정 및 API 키 만들기

LangSmith를 시작하려면 계정을 만들어야 해요. LangSmith UI에서 무료 계정에 가입할 수 있어요. LangSmith는 Google, GitHub, 이메일로 로그인을 지원해요.

출처: 문서

본문

API 키

LangSmith는 두 가지 유형의 API 키를 지원해요. 두 유형의 토큰을 모두 LangSmith API에 대한 요청을 인증하는 데 사용할 수 있지만 사용 사례가 달라요:

PAT(Personal Access Tokens)는 이를 만든 사용자의 권한을 상속해요. 개인 스크립트나 도구에는 PAT를 사용하세요.
서비스 키(Service keys)는 특정 워크스페이스 또는 전체 조직으로 범위가 한정돼요. 애플리케이션과 프로덕션 서비스에는 서비스 키를 사용하세요.

LangSmith로 트레이스를 기록하고 평가를 실행하려면 요청을 인증할 API 키를 만드세요.

API Keys 설정 열기: Settings 페이지로 이동해 API Keys 섹션을 선택하세요.
키 유형 구성하기: 서비스 키의 경우 조직 범위 키와 워크스페이스 범위 키 중에서 선택하세요. 키가 워크스페이스 범위라면 워크스페이스를 지정해야 해요.

엔터프라이즈 사용자는 서비스 키에 특정 워크스페이스 역할을 할당할 수도 있으며, 이는 어떤 사용자와도 무관하게 권한을 조정해요.
만료 설정하기: 키의 만료를 설정하세요. 선택한 일수 이후 또는 "never"(무기한)를 선택하면 키를 사용할 수 없게 돼요.
키 생성하기: Create API Key를 클릭하세요. LangSmith는 API 키를 한 번만 표시하므로 반드시 복사해서 안전한 곳에 보관하세요.

엔터프라이즈 조직 관리자는 키를 회전하지 않고 기존 서비스 키의 역할을 편집할 수 있어요. Settings 페이지의 API Keys 섹션에서 Service 탭으로 전환하고 아무 서비스 키 행이나 클릭해 편집 대화상자를 열어요. 워크스페이스 역할(조직 범위 키라면 조직 역할)을 업데이트하고 Save를 클릭하세요. 키 문자열 자체는 변경되지 않아요.

PAT 비활성화 또는 삭제

비활성화는 PAT가 인증하는 것을 일시적으로 중지하고, 삭제는 이를 영구적으로 제거해요. 기록을 유지하고 나중에 다시 활성화해야 할 때는 토큰을 비활성화하세요.

멤버는 자신의 PAT를 비활성화, 재활성화, 삭제할 수 있어요. 조직 관리자와 조직 운영자는 모든 멤버의 PAT를 관리할 수도 있어요.

작업	효과	되돌릴 수 있음
Deactivate	인증을 중지하고 기록, 소유자, 마지막 사용이 Deactivated 배지와 함께 표시로 유지돼요.	예. 동일한 토큰을 다시 사용하려면 Reactivate key를 선택하세요.
Reactivate	동일한 토큰과 원래 만료 날짜로 다시 인증할 수 있어요.	예. 언제든 토큰을 다시 비활성화할 수 있어요.
Delete	토큰과 기록을 영구적으로 제거해요.	아니요. 다시 접근해야 한다면 새 토큰을 만드세요.

비활성화는 토큰의 만료 날짜를 변경하지 않으며, 해당 날짜가 지나면 Reactivate key를 사용할 수 없어요. 대신 새 토큰을 만드세요.

PAT를 비활성화하거나 삭제하려면:

Settings > API Keys로 이동해 Personal 탭을 여세요.
My keys 아래에서 토큰을 찾으세요. 다른 멤버의 토큰을 관리하려면 All members로 전환하세요.
Actions 열에서 Deactivate key 또는 Delete key를 선택하세요. 각 작업은 자체 확인 대화상자를 열어요.
대화상자에 표시된 토큰의 설명을 입력하세요. 설명이 없는 토큰은 Key 열의 짧은 키를 입력하세요.
Deactivate 또는 Delete를 선택해 확인하세요. 성공 알림이 작업을 확인해줘요.

비활성화된 PAT를 재활성화하려면 Actions 열에서 Reactivate key를 선택하세요. 재활성화는 확인 대화상자 없이 한 번의 클릭으로 이루어지며 성공 알림이 표시돼요.

인증 결과는 캐시되므로 비활성화되거나 삭제된 토큰은 즉시가 아니라 1분 이내에 작동을 멈춰요. 재활성화된 토큰은 캐시된 거부가 만료될 때까지 사용할 수 없을 수 있어요.

감사 로그는 비활성화를 revoke_personal_access_token으로, 재활성화를 reinstate_personal_access_token으로 기록해요.

서비스 키는 비활성화할 수 없고 삭제만 할 수 있어요. Service 탭을 열고 Actions 열에서 Delete key를 선택한 다음, PAT 삭제에 필요한 설명을 입력해 확인하세요.

SDK 구성하기

사용 언어용 SDK를 설치하세요:

Python:

pip install langsmith

uv add langsmith

TypeScript:

npm install langsmith

자세한 내용은 Python SDK 또는 JS/TS SDK 참조를 참고하세요.

그런 다음 API 키를 설정하고 추적을 활성화하세요:

export LANGSMITH_API_KEY=<your-api-key>
export LANGSMITH_TRACING=true

다음 추가 환경 변수가 필요할 수도 있어요:

LANGSMITH_ENDPOINT는 SDK가 데이터를 보내는 LangSmith 서버를 제어해요. 기본값은 https://api.smith.langchain.com (GCP US)이에요. 다른 배포에 있을 때만 설정하세요. 리전별 SaaS의 경우 해당 리전의 API URL로 설정하세요:

리전 URL

GCP US https://api.smith.langchain.com

GCP EU https://eu.api.smith.langchain.com

GCP APAC https://apac.api.smith.langchain.com

AWS US https://aws.api.smith.langchain.com
LANGSMITH_WORKSPACE_ID는 API 키가 둘 이상의 워크스페이스로 범위가 한정된 경우에만 필요해요. Settings 페이지의 General 아래에서 Workspace ID를 찾으세요:

LANGSMITH_WORKSPACE_ID=<Workspace ID>

리전	URL
GCP US	`https://api.smith.langchain.com`
GCP EU	`https://eu.api.smith.langchain.com`
GCP APAC	`https://apac.api.smith.langchain.com`
AWS US	`https://aws.api.smith.langchain.com`

로컬 셸이나 원격 런타임 간에 엔드포인트, API 키 및 워크스페이스 설정을 재사용하려면 프로필 구성을 참고하세요.

SDK 외부에서 API 키 사용하기

API를 통한 조직 관리 지침을 참고하세요.

계정 및 API 키 만들기