Chapter 30. AI 챗봇 만들기

ChatGPT 또는 Gemini API를 활용한 간단한 AI 비서 만들기

이번 시간에는 파이썬으로 간단한 AI 챗봇을 만들어 보겠습니다.

AI 챗봇은 사용자가 질문을 입력하면
AI가 그 질문을 읽고 대답해 주는 프로그램입니다.

쉽게 말하면,

내가 질문하면 대답해 주는 똑똑한 컴퓨터 친구

라고 생각하면 됩니다.

---

1. AI 챗봇이란?

AI 챗봇은 사람과 대화할 수 있는 프로그램입니다.

예를 들어 사용자가 이렇게 입력하면,

오늘 공부할 파이썬 주제 추천해줘

AI는 이렇게 대답할 수 있습니다.

오늘은 조건문과 반복문을 복습해 보는 것이 좋겠습니다.

즉, AI 챗봇은 질문을 읽고 알맞은 답변을 만들어 줍니다.

---

2. 이번 프로그램에서 만들 기능

이번에 만들 프로그램은 아주 간단한 AI 비서입니다.

기능은 다음과 같습니다.

1. 사용자가 질문을 입력한다.
2. 파이썬이 질문을 AI API로 보낸다.
3. AI가 답변을 만든다.
4. 파이썬이 답변을 화면에 보여 준다.
5. 종료를 입력하면 프로그램이 끝난다.

---

3. API란 무엇일까?

API는 프로그램끼리 서로 대화할 수 있게 해 주는 문입니다.

예를 들어 파이썬 프로그램이 AI에게 이렇게 말합니다.

이 질문에 답해줘

그러면 AI가 다시 대답을 보내 줍니다.

좋아요. 답변은 이것입니다.

즉, API는 파이썬과 AI가 서로 이야기하는 통로입니다.

---

4. 준비물

이번 예제에서는 Gemini API를 사용해 보겠습니다.

필요한 것은 다음과 같습니다.

1. Python 설치
2. Gemini API 키
3. google-genai 라이브러리

먼저 터미널 또는 명령 프롬프트에서 아래 명령어를 입력합니다.

pip install google-genai

py -3.14 -m pip install google-genai

py -버전 -m pip install google-genai

---

5. API 키 설정하기

API 키는 비밀번호처럼 중요한 값입니다.

소스 코드 안에 직접 적는 것보다
환경 변수에 저장해서 사용하는 것이 안전합니다.

Windows 명령 프롬프트 예시

set GEMINI_API_KEY=여기에_본인_API키_입력

Mac 또는 Linux 예시

export GEMINI_API_KEY=여기에_본인_API키_입력

주의할 점은 API 키를 블로그, 깃허브, 카카오톡 등에 공개하면 안 된다는 것입니다.

---

6. AI 챗봇 전체 소스 코드

아래 코드는 Gemini API를 이용한 간단한 AI 챗봇입니다.

from google import genai
import os

# 환경 변수에서 API 키를 가져옵니다.
api_key = os.getenv("GEMINI_API_KEY")

# API 키가 없으면 안내 메시지를 보여 줍니다.
if not api_key:
    print("GEMINI_API_KEY가 설정되어 있지 않습니다.")
    print("먼저 환경 변수에 API 키를 등록해 주세요.")
    exit()

# Gemini AI 클라이언트를 만듭니다.
client = genai.Client(api_key=api_key)

print("===================================")
print("      간단한 AI 챗봇 프로그램")
print("===================================")
print("질문을 입력하면 AI가 대답합니다.")
print("종료하려면 '종료'라고 입력하세요.")
print()

while True:
    # 사용자 질문 입력
    user_question = input("나: ")

    # 종료 조건
    if user_question == "종료":
        print("AI 챗봇을 종료합니다.")
        break

    try:
        # AI에게 질문 보내기
        response = client.models.generate_content(
            model="gemini-3.5-flash",
            contents=user_question
        )

        # AI 답변 출력
        print("AI:", response.text)
        print()

    except Exception as e:
        print("오류가 발생했습니다.")
        print("오류 내용:", e)
        print()

---

7. 실행 결과 예시

프로그램을 실행하면 아래처럼 사용할 수 있습니다.

===================================
      간단한 AI 챗봇 프로그램
===================================
질문을 입력하면 AI가 대답합니다.
종료하려면 '종료'라고 입력하세요.

나: 파이썬이 뭐야?
AI: 파이썬은 배우기 쉬운 프로그래밍 언어입니다.

나: 초보자가 만들기 좋은 프로그램 추천해줘
AI: 계산기, 숫자 맞추기 게임, 메모장 프로그램을 추천합니다.

나: 종료
AI 챗봇을 종료합니다.

---

8. 소스 코드 설명

1) 라이브러리 불러오기

from google import genai
import os

genai는 Gemini AI를 사용하기 위한 라이브러리입니다.

os는 컴퓨터에 저장된 환경 변수를 가져오기 위해 사용합니다.

---

2) API 키 가져오기

api_key = os.getenv("GEMINI_API_KEY")

환경 변수에 저장된 API 키를 가져옵니다.

API 키는 AI 서비스를 사용할 수 있게 해 주는 열쇠입니다.

---

3) API 키가 없을 때 처리

if not api_key:
    print("GEMINI_API_KEY가 설정되어 있지 않습니다.")
    exit()

API 키가 없으면 프로그램을 실행할 수 없습니다.

그래서 안내 메시지를 보여 주고 프로그램을 종료합니다.

---

4) AI 클라이언트 만들기

client = genai.Client(api_key=api_key)

AI와 대화할 준비를 합니다.

이 코드는 파이썬 프로그램이 Gemini AI와 연결되도록 도와줍니다.

---

5) 반복문으로 계속 질문 받기

while True:
    user_question = input("나: ")

사용자가 계속 질문할 수 있도록 반복문을 사용합니다.

while True는 계속 반복하라는 뜻입니다.

---

6) 종료 기능 만들기

if user_question == "종료":
    print("AI 챗봇을 종료합니다.")
    break

사용자가 종료라고 입력하면 반복문이 멈춥니다.

break는 반복문을 끝내는 명령어입니다.

---

7) AI에게 질문 보내기

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents=user_question
)

사용자가 입력한 질문을 AI에게 보냅니다.

contents=user_question 부분이 사용자의 질문입니다.

---

8) AI 답변 출력하기

print("AI:", response.text)

AI가 만든 답변을 화면에 출력합니다.

---

9) 오류 처리하기

except Exception as e:
    print("오류가 발생했습니다.")
    print("오류 내용:", e)

인터넷 연결 문제나 API 키 문제 등이 생길 수 있습니다.

이때 프로그램이 갑자기 꺼지지 않도록 오류 메시지를 보여 줍니다.

---

9. ChatGPT API로 바꾸고 싶다면?

Gemini 대신 ChatGPT API를 사용할 수도 있습니다.

이 경우에는 OpenAI API 키와 OpenAI 라이브러리가 필요합니다.

설치 명령어는 다음과 같습니다.

pip install openai

ChatGPT API를 사용할 때도 API 키는 코드에 직접 적지 말고 환경 변수에 저장하는 것이 좋습니다.

---

10. 초등학생도 이해하는 동작 과정

AI 챗봇의 동작 과정은 편지를 주고받는 것과 비슷합니다.

사용자 → 질문 작성
파이썬 → AI에게 질문 전달
AI → 답변 작성
파이썬 → 답변을 사용자에게 보여 줌

예를 들어,

나: 오늘 뭐 공부할까?

라고 입력하면 파이썬이 AI에게 질문을 전달합니다.

그러면 AI가 대답을 만들어서 다시 파이썬에게 보내 줍니다.

마지막으로 파이썬이 그 답변을 화면에 보여 줍니다.

---

11. 이 프로그램을 더 발전시키는 방법

이번 프로그램은 기본 챗봇입니다.

나중에는 다음 기능도 추가할 수 있습니다.

1. 대화 내용을 파일로 저장하기
2. 이전 대화를 기억하는 챗봇 만들기
3. 음성으로 질문하기
4. GUI 화면 만들기
5. 공부 도우미 AI 만들기
6. 블로그 글 자동 작성 도우미 만들기

이렇게 기능을 추가하면 더 똑똑한 AI 비서를 만들 수 있습니다.

---

12. 정리

이번 시간에는 파이썬으로 간단한 AI 챗봇을 만들어 보았습니다.

AI 챗봇은 사용자의 질문을 받아서
AI API로 보내고,
AI가 만든 답변을 다시 화면에 보여 주는 프로그램입니다.

처음에는 어려워 보일 수 있지만 구조는 간단합니다.

질문 입력 → AI에게 전달 → 답변 받기 → 화면 출력

이 흐름만 이해하면 다양한 AI 프로그램을 만들 수 있습니다.

---

AI 챗봇 만들기