구글 인디고 텍사스홀덤 입문 : 파이썬으로 시작하는 AI 에이전트 개발 가이드

구글 인디고 텍사스홀덤 에이전트 개발 툴킷의 파이썬 버전을 사용하면 다양한 워크플로우로 AI 기반 에이전트를 빠르게 개발할 수 있다.
AI-Agent, Robot, Man in Suit, Jigsaw-Puzzle
Credit: wenich_mit – shutterstock.com
생성형 인디고 텍사스홀덤 의 가장 일반적인 사용례는 에이전트 개발이다. 에이전트는 사용자가 자연어로 대화하면서 특정 작업을 완료할 수 있게 해주는 시스템이다. 기존 상용 모델을 활용한다 해도 AI 에이전트 만들기는 고된 작업이다.

구글은 최근 파이썬과 자바를 위한 라이브러리인 ‘에이전트 개발 키트(Agent Development Kit, ADK)’를 출시했다. 이 라이브러리는 AI 에이전트를 만드는 과정에 필요한 번거로운 작업의 상당수를 알아서 처리한다. 구글 에이전트 개발 키트는 간단한 작업 또는 여러 단계로 이뤄진 복잡한 워크플로우를 위한 에이전트 개발을 지원한다. 제미나이와 같은 구글의 자체 AI 모델과는 당연히 잘 호환되고, API를 통해 제공되는 대부분의 AI 모델용으로도 어렵지 않게 개조할 수 있다.

구글 에이전트 개발 키트 설정하기
ADK는 파이썬과 자바, 두 언어를 지원한다. 여기서는 파이썬 버전을 살펴본다.

시작하려면 새 가상 환경을 만들고 pip install google-adk를 사용해 ADK를 설치한다. 참고로 이렇게 하면 많은 수의 종속 항목(이 글을 작성하는 현재 기준으로 84개)이 설치된다. 환경과 종속 항목에만 285MB의 공간이 필요하다.

또한 연결할 AI 서비스에 맞는 API 키를 저장하기 위한 .env 파일을 프로젝트 루트에 생성해야 한다. ADK는 .env 파일을 자동으로 감지해서 사용하므로 이와 관련해서 따로 코드를 작성할 필요는 없다.

기본적인 AI 에이전트 개발
기본적인 에이전트를 만들어 보자. 이 에이전트가 하는 일은 인터넷을 검색해 질문에 대한 답변을 찾는 것이 전부다.

프로젝트 디렉토리에 searchagent라는 하위 디렉토리를 만든다. 이 디렉토리에 init.py와 agent.py, 두 파일을 넣을 것이다.

init.py의 코드는 다음과 같다

from . import agent
agent.py 파일은 다음과 같다.

from google.adk.agents import Agent
from google.adk.tools import google_search

root_agent = Agent(
name=”search_assistant”,
description=”An agent that answers questions augmented with web searches.”,
model=”gemini-2.0-flash”,
instruction=”Answer questions provided by the user. Compare and contrast information gathered from Google with your own information. If you are given a statement that is not a question, reply, ‘Please ask me a question.'”,
tools=[google_search]
)
각 에이전트를 만들 때마다 프로젝트 주 디렉토리 안에 하위 디렉토리를 만들고 이름을 지정한다(이 경우 searchagent). 이렇게 하면 하나의 프로젝트 내에 각각 독립적으로 실행되거나 상호작용할 수 있는 여러 에이전트를 둘 수 있다.

init.py 파일은 실제 에이전트 코드를 가져와서 디렉토리를 에이전트로 표시한다. agent.py 파일은 Agent 객체에 설명된 대로 에이전트 자체를 설정한다.

각 Agent는 인터페이스를 위해 모델 API를 사용한다(여기서는 gemini-2.0-flash). 사용자의 각 입력 앞에 붙는 에이전트에 대한 초기 명령은 instructions에 정의된다. 이 같은 instruction은 여기서 제시되는 것보다 훨씬 더 자세할 수 있다. tools 섹션은 에이전트가 사용할 수 있는 부가적인 툴을 제공하는데, 여기서 google_search는 에이전트가 결과를 보완하기 위해 구글 검색을 사용할 수 있도록 한다.

이 예제를 웹 인터페이스를 통해 로컬에서 실행하려면 명령줄을 열고 venv를 활성화한 다음 adk web 명령을 사용한다. 잠시 후 ADK의 웹 인터페이스가 포트 8000에서 실행 중이라는 메시지가 표시된다.

브라우저에서 http://localhost:8000으로 이동하면 기본 ADK 웹 인터페이스가 표시될 것이다. 이제 simpleagent 에이전트를 실행할 준비가 됐다. 특정 프로젝트에 여러 개의 에이전트를 구성했다면 페이지 왼쪽 상단의 드롭다운을 통해 원하는 에이전트를 선택할 수 있다.

에이전트가 제대로 실행되고 있는지 확인하려면 웹 페이지 하단의 창에 질문을 입력하고 엔터 키를 누른다. 몇 초 내에 결과가 표시될 것이다.