메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt

Use this file to discover all available pages before exploring further.

User Settings에서는 프로필, 기본 팀, API 키, 알림, 인테그레이션, 기타 계정 수준 옵션을 관리할 수 있습니다. 이 페이지에서는 User Settings의 각 섹션과 사용 방법을 설명합니다. User Settings를 열려면 사용자 프로필 페이지로 이동한 다음, 오른쪽 상단에 있는 사용자 아이콘을 선택합니다. 드롭다운 메뉴에서 Settings를 선택합니다.

​
프로필

프로필 섹션에서는 계정 이름과 소속 기관을 관리하고 수정할 수 있습니다. 필요에 따라 소개글과 위치를 추가하고, 개인 또는 소속 기관의 웹사이트를 연결하고, 프로필 이미지를 업로드할 수 있습니다.

​
자기소개 수정하기

자기소개는 프로필 상단에 표시되며, 자신을 소개하거나 프로젝트를 연결하거나 관련 계정을 공유하기에 좋은 공간입니다. 자기소개를 수정하려면 프로필 상단의 편집을 클릭하세요. 열리는 WYSIWYG 편집기는 Markdown을 지원합니다.
  1. 줄을 수정하려면 해당 줄을 클릭하세요. 시간을 절약하려면 /를 입력한 다음 목록에서 Markdown을 선택하면 됩니다.
  2. 항목의 드래그 핸들을 사용해 위치를 옮기세요.
  3. 블록을 삭제하려면 드래그 핸들을 클릭한 다음 삭제를 클릭하세요.
  4. 변경 사항을 저장하려면 저장을 클릭하세요.
업데이트된 자기소개가 이제 프로필에 표시됩니다.

​
소셜 배지 추가

X에서 @weights_biases 계정을 팔로우하는 배지를 추가하려면, 배지 이미지를 가리키는 HTML <img> 태그가 포함된 Markdown 스타일 링크를 추가하세요: 
[![X: @weights_biases](https://img.shields.io/twitter/follow/weights_biases?style=social)](https://x.com/intent/follow?screen_name=weights_biases)
<img> 태그에서는 width, height 또는 둘 다 지정할 수 있습니다. 둘 중 하나만 지정하면 이미지의 가로세로 비율이 유지됩니다.

​
기본 팀

둘 이상의 팀에 속해 있는 경우 기본 팀 섹션에서 run 또는 Weave 트레이스에 팀이 지정되지 않았을 때 사용할 기본 팀을 설정할 수 있습니다. 한 팀에만 속해 있는 경우에는 해당 팀이 기본값이므로 이 섹션은 표시되지 않습니다. 기본 팀을 설정하는 방법은 배포 환경에 따라 다릅니다. 사용 중인 환경에 맞는 탭을 선택하세요.
Default location to create new projects in 옆의 드롭다운을 클릭한 다음 기본 팀을 선택하세요.
자동화된 환경에서 스크립트를 실행할 때 기본 팀을 지정하려면 WANDB_ENTITY 환경 변수를 사용해 기본 위치를 지정하세요.

​
팀

팀 섹션에는 내가 속한 모든 팀이 표시됩니다.
  • 팀 이름을 클릭해 팀 페이지로 이동합니다.
  • 추가 팀에 참여할 권한이 있으면 가입할 수 있는 팀을 찾았습니다 옆의 팀 보기를 클릭합니다.
  • 선택 사항: 공개 프로필에서 팀 숨기기를 켭니다.
팀을 생성하거나 관리하려면 팀 관리를 참조하세요.

​
API 키

API 키 섹션에서는 W&B 서비스에 인증할 때 사용하는 개인 API 키를 관리할 수 있습니다. 이 섹션에서 기존 키를 검토하고, 새 키를 만들고, 더 이상 필요하지 않은 키를 취소할 수 있습니다.

​
API 키 보기

API 키 테이블에는 다음이 표시됩니다:
  • 키 ID: 각 API 키의 첫 부분으로, 식별에 사용됩니다.
  • 이름: 키를 만들 때 지정한 설명용 이름입니다.
  • 생성됨: 키가 생성된 시점입니다.
  • 마지막 사용: 가장 최근 사용 타임스탬프입니다.
보안을 위해 테이블에는 키 ID(키의 첫 부분)만 표시됩니다. 전체 시크릿 API 키는 키를 만들 때 한 번만 표시됩니다.
API 키 목록을 필터링하려면 키 이름 또는 ID의 일부를 입력하세요.

​
새 API 키 생성

API 키를 만들려면 자세한 내용이 있는 개인 API 키 또는 서비스 계정 API 키 탭을 선택하세요.
사용자 ID에 속한 개인 API 키를 만들려면 다음 단계를 따르세요.
  1. W&B에 로그인한 다음 사용자 프로필 아이콘을 클릭하고 User Settings를 클릭합니다.
  2. Create new API key를 클릭합니다.
  3. API 키를 식별할 수 있는 설명적인 이름을 입력합니다.
  4. Create를 클릭합니다.
  5. 표시된 API 키를 즉시 복사해 안전하게 저장합니다.
전체 API 키는 생성 시점에 한 번만 표시됩니다. 대화 상자를 닫으면 전체 API 키를 다시 볼 수 없습니다. Settings에서는 키 ID(키의 첫 부분)만 확인할 수 있습니다. 전체 API 키를 분실한 경우 새 API 키를 만들어야 합니다.
안전한 저장 옵션은 API 키를 안전하게 저장하기를 참조하세요.

​
API 키 삭제

더 이상 필요하지 않거나 노출되었을 수 있는 경우 API 키를 삭제하세요. API 키를 삭제해 액세스를 철회하려면 다음 단계를 따르세요.
  1. API 키 테이블에서 삭제할 키를 찾으세요.
  2. 키 옆의 Delete 버튼을 클릭하세요.
  3. 삭제를 확인하세요.
W&B는 테이블에서 해당 키를 제거하며, 더 이상 그 키로 인증할 수 없습니다.
API 키를 삭제하면 해당 키를 사용하는 모든 스크립트 또는 서비스의 액세스가 즉시 취소됩니다. 기존 키를 삭제하기 전에 모든 시스템이 새 키를 사용하도록 업데이트했는지 확인하세요.

​
API 키를 안전하게 저장하고 관리하기

API 키는 W&B 계정에 접근할 수 있게 하므로 비밀번호처럼 보호해야 합니다. 다음 권장 사항을 따르세요:
  • Secrets manager: AWS Secrets Manager, HashiCorp Vault, Azure Key Vault, 또는 Google Secret Manager와 같은 전용 시크릿 관리 시스템을 사용하세요.
  • Password manager: 신뢰할 수 있는 비밀번호 관리 애플리케이션을 사용하세요.
  • OS-level keychains: macOS Keychain, Windows Credential Manager, 또는 Linux secret service에 키를 저장하세요. 프로덕션 환경에는 권장되지 않습니다.

​
피해야 할 사항

  • Git과 같은 버전 관리 시스템에 API 키를 절대 커밋하지 마세요.
  • API 키를 평문 설정 파일에 저장하지 마세요.
  • ps와 같은 OS 명령의 출력에 표시되므로, 명령줄 인수로 API 키를 전달하지 마세요.
  • 이메일, 채팅 또는 기타 암호화되지 않은 채널을 통해 API 키를 공유하지 마세요.
  • 소스 코드에 API 키를 하드코딩하지 마세요.
API 키가 노출된 경우, W&B 계정에서 즉시 해당 API 키를 삭제하고 지원팀 또는 AISE에 문의하세요.

​
환경 변수

코드에서 API 키를 사용할 때는 환경 변수로 전달하세요: 
export WANDB_API_KEY="your-api-key-here"
이 방식은 키를 소스 코드에 넣지 않도록 하고, 필요할 때 더 쉽게 교체할 수 있게 해줍니다.
ps 같은 OS 명령어의 출력에 표시되므로, 환경 변수를 명령어와 같은 줄에서 설정하지 마세요:
# 이 패턴은 피하세요. 프로세스 관리자에 API 키가 노출될 수 있습니다
export WANDB_API_KEY="your-api-key-here" ./my-script.sh

​
SDK 버전 호환성

새 API 키는 기존 키보다 더 깁니다. 이전 버전의 wandb 또는 weave SDK로 인증할 때 API 키 길이 오류가 발생할 수 있습니다. 해결 방법: 최신 SDK 버전으로 업데이트하세요.
  • wandb SDK v0.22.3+ 
    pip install --upgrade wandb==0.22.3
  • weave SDK v0.52.17+ 
    pip install --upgrade weave==0.52.17
SDK를 바로 업그레이드할 수 없다면, 우회 방법으로 WANDB_API_KEY 환경 변수를 사용해 API 키를 설정하세요.

​
베타 기능

베타 기능 섹션에서는 부가 기능과 개발 중인 제품의 미리보기를 선택적으로 활성화할 수 있습니다. 활성화하려는 베타 기능 옆의 토글 스위치를 선택하세요.

​
알림

run이 비정상 종료되거나 완료될 때 알림을 받거나, wandb.Run.alert()를 사용해 맞춤형 알림을 설정할 수 있습니다. 알림은 이메일 또는 Slack을 통해 받게 됩니다. 알림을 받을 이벤트 유형 옆의 스위치를 켜세요:
  • Runs finished: W&B run이 성공적으로 완료되면 알림을 받습니다.
  • Run crashed: run이 정상적으로 완료되지 못하고 실패하면 알림을 받습니다.
알림을 설정하고 관리하는 방법에 대한 자세한 내용은 wandb.Run.alert()로 알림 보내기를 참조하세요.

​
개인 GitHub 인테그레이션

개인 GitHub 계정을 연결하면 W&B가 사용자를 대신해 GitHub 리소스에 액세스할 수 있습니다. GitHub 계정을 연결하려면 다음 단계를 따르세요.
  1. Connect Github 버튼을 선택하세요. W&B가 OAuth 승인 페이지로 리디렉션합니다.
  2. Organization access 섹션에서 액세스를 부여할 조직을 선택하세요.
  3. Authorize wandb를 선택하세요.
이제 개인 GitHub 계정이 W&B 계정에 연결되었습니다.

​
계정 삭제

계정을 삭제하려면 계정 삭제 버튼을 선택하세요.
계정 삭제는 되돌릴 수 없습니다.

​
저장소

저장소 섹션에서는 계정이 W&B 서버에서 사용한 총 메모리를 설명합니다. 기본 저장소 플랜은 100 GB입니다. 저장소 및 가격에 대한 자세한 내용은 가격 페이지를 참조하세요.