Chapter 02 · 환경변수

키·URL·이름,
한 번만
정리해두기.

실습마다 인증키·모델명·base URL을 반복 입력하면
코드가 빠르게 더러워진다. .env 한 파일에 모아두자.

Anti-pattern → Pattern

매 셀마다 키 입력?
한 번이면 충분하다.

❌ 매 셀마다

# Cell 1
api_key = "sk-..."
url     = "https://..."

# Cell 2 (같은 거 또)
api_key = "sk-..."
url     = "https://..."

✓ .env 한 번

# .env (한 번만 작성)
api_key=sk-...
api_base_url=https://...

# 어느 셀에서든 두 줄
from dotenv import load_dotenv
load_dotenv()
key = os.getenv("api_key")

.env 는 git에 올리지 않는 게 원칙. .gitignore 에 추가해 두세요.

강의에서 쓰는 여덟 키

한 번 적어두고
열 장 동안 재사용.

변수

의미

언제 쓰이나

OPENAI_API_KEY

OpenAI 호환 더미 키

API 클라이언트 형식상 필수

credential_key

실제 LLM 인증 헤더

매 호출의 x-ticket

send_system_name

호출하는 시스템명

게이트웨이가 본인 확인

model

사용할 LLM 모델명

e.g. gpt-oss-120b

api_base_url

LLM 엔드포인트

OpenAI client base_url

user_id

본인 SSO ID

호출 로깅 · 위키

embedding_credential_key

임베딩 API 키

RAG 챕터

user_pw

위키 비밀번호

Confluence 조회

Code · .env 만들기

dict 한 번 →
.env 파일 한 번.

import os
from dotenv import set_key

env_vars = {
    "OPENAI_API_KEY":           OPENAI_API_KEY,
    "credential_key":           credential_key,
    "send_system_name":         send_system_name,
    "model":                    model,
    "api_base_url":             api_base_url,
    "user_id":                  user_id,
    "embedding_credential_key": embedding_credential_key,
    "user_pw":                  user_pw,
}

for key, value in env_vars.items():
    set_key(".env", key, value)

set_key 는 .env가 없으면 만들고, 있으면 해당 키만 갱신한다.
비밀번호처럼 한 번만 받아두면 그 뒤로는 무신경해도 좋다.

Code · 매 노트북의 첫 두 줄

한 번 적고,
매 노트북에서
두 줄로.

load_dotenv(override=True) 로 .env를 프로세스에 주입.
os.getenv() 로 어디서든 꺼낸다.

import os
from dotenv import load_dotenv

load_dotenv(override=True)

# 어디서든 꺼내 쓰기
key  = os.getenv("credential_key")
url  = os.getenv("api_base_url")
name = os.getenv("model")

Sanity Check

세 API가
모두 살아 있는지
한 번에.

from utils.helper import check_llm_api, check_embedding_api, check_confluence_api
from dotenv import load_dotenv

load_dotenv(override=True)

check_llm_api()          # 인증키 + base_url
check_embedding_api()    # 임베딩 키
check_confluence_api()   # 위키 비번

하나라도 실패하면 다음 챕터로 못 간다.
8할은 키 오타.

→

Chapter 02 · 마무리

이제 진짜
LLM을 호출할 수 있다.

.env 만들기 → load_dotenv → check_api 통과.
다음 챕터부터 모든 노트북은 같은 두 줄로 시작한다.

Next · Chapter 03

시스템 프롬프트와 페르소나

→

키·URL·이름, 한 번만 정리해두기.

매 셀마다 키 입력? 한 번이면 충분하다.

❌ 매 셀마다

✓ .env 한 번

한 번 적어두고 열 장 동안 재사용.

dict 한 번 → .env 파일 한 번.

한 번 적고, 매 노트북에서 두 줄로.

세 API가 모두 살아 있는지 한 번에.

이제 진짜 LLM을 호출할 수 있다.

키·URL·이름,
한 번만
정리해두기.

매 셀마다 키 입력?
한 번이면 충분하다.

한 번 적어두고
열 장 동안 재사용.

dict 한 번 →
.env 파일 한 번.

한 번 적고,
매 노트북에서
두 줄로.

세 API가
모두 살아 있는지
한 번에.

이제 진짜
LLM을 호출할 수 있다.