이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.
TL;DR
AI 에이전트가 Gmail, Slack 등 외부 서비스와 연동되어 업무를 자동화하려면 복잡한 OAuth 인증 과정이 큰 장벽이 된다. 본 영상에서는 Arcade라는 액션 런타임을 활용해 이러한 인증 과정을 자동화하고, GPT-4o 기반의 임원 비서 에이전트를 구축하는 방법을 제시한다. 개발자는 약 50줄의 코드만으로 수백 개의 외부 도구 스키마를 로드하고 인증 인프라를 구축할 수 있으며, 이를 통해 이메일 요약, 일정 관리, 슬랙 보고와 같은 복잡한 업무를 AI가 자율적으로 수행하게 만들 수 있다. 결과적으로 Arcade는 에이전트 개발의 복잡성을 획기적으로 낮추고 실행력을 극대화하는 강력한 도구임이 확인됐다.
챕터별 상세
AI 비서 에이전트의 기능과 Arcade 소개
AI 에이전트가 이메일, 캘린더, 슬랙에 직접 접근하여 업무를 수행하는 비서 역할을 하려면 복잡한 인증 과정이 필요하다. Arcade는 이러한 외부 서비스와의 OAuth 인증 및 권한 부여를 단순화하여 개발자가 별도의 자격 증명 관리 없이 도구를 연동하게 돕는다. 구글 계정 로그인 한 번으로 에이전트가 필요한 모든 서비스에 접근할 수 있는 환경을 구축했다. 이는 개발자가 인프라 구축 대신 에이전트의 지능과 워크플로우 설계에 집중할 수 있게 한다.
OpenAI 기반 AI 에이전트 클래스 구현
에이전트의 핵심 두뇌 역할을 할 `Assistant` 클래스를 Python으로 구현했다. OpenAI의 `gpt-4o` 모델을 기반으로 하며, 모델이 상황에 맞는 도구를 선택할 수 있도록 `tools` 파라미터에 도구 스키마를 전달하는 구조를 갖췄다. 사용자의 입력 프롬프트를 받아 모델이 도구 호출(Tool Calling)이 필요한지 판단하고, 결과값을 다시 메시지 히스토리에 추가하여 최종 응답을 생성한다. 이 과정을 통해 자연어 명령을 실제 API 실행으로 변환하는 자율적인 루프를 완성했다.
python
class Assistant:
def __init__(self, tools, system_prompt, model="gpt-4o", verbose=True):
self.openai = OpenAI()
self.tools = tools
self.model = model
self.verbose = verbose
self.messages = [{"role": "system", "content": system_prompt}]OpenAI의 GPT-4o 모델과 도구를 연동하기 위한 기본 에이전트 클래스 구조
메인 스크립트와 업무 루틴 설정
에이전트가 수행할 구체적인 업무 시나리오인 '모닝 루틴'을 `main.py`에 정의했다. 시스템 프롬프트를 통해 에이전트에게 임원 비서라는 페르소나를 부여하고, 읽지 않은 이메일 요약, 답장 초안 작성, 슬랙 채널 업데이트 등의 지침을 명시했다. 특정 시간에 실행되거나 슬랙 메시지에 반응하여 동작하도록 워크플로우를 구성했다. 에이전트는 이 설정을 바탕으로 사용자의 개입 없이도 매일 아침 업무 요약을 생성하고 필요한 조치를 취한다.
로컬 도구 설정의 복잡성과 한계
Arcade와 같은 런타임 없이 로컬에서 직접 외부 API를 연동할 때 발생하는 번거로움을 분석했다. Gmail 연동에만 구글 클라우드 프로젝트 생성, API 활성화, OAuth 동의 화면 구성 등 11단계의 복잡한 과정이 필요하며 전체 서비스 연동에는 총 22단계 이상의 수동 작업이 요구된다. 각 서비스마다 별도의 자격 증명 파일을 관리하고 토큰 갱신 로직을 구현해야 하는 부담이 크다. 이러한 수동 방식은 확장성이 낮고 보안 관리가 어렵다는 한계가 있다.
Arcade 대시보드를 활용한 도구 관리
Arcade 대시보드에서 제공하는 툴 카탈로그와 플레이그라운드 기능을 활용했다. 대시보드에서는 Gmail, Slack, GitHub 등 수십 개의 서비스에 대해 사전 정의된 수백 개의 도구들을 시각적으로 확인하고 테스트할 수 있다. 플레이그라운드에서 직접 자연어로 명령을 내려 도구가 올바르게 호출되는지 검증하는 과정을 거쳤다. 이를 통해 코드 작성 전 에이전트가 수행할 수 있는 액션의 범위를 명확히 파악하고 필요한 도구만 선택하여 에이전트에 주입할 수 있다.
Arcade SDK를 이용한 도구 연결 및 인증
Arcade SDK를 사용하여 Python 코드 내에서 외부 도구를 에이전트에 연결하는 로직을 구현했다. `ArcadeTools` 클래스를 통해 필요한 툴킷을 초기화하면, Arcade가 자동으로 해당 서비스의 OAuth 인증 URL을 생성하고 브라우저를 통해 사용자 승인을 받는다. 인증이 완료되면 액세스 토큰은 Arcade 서버에 안전하게 저장 및 갱신되며, 에이전트는 토큰에 직접 접근하지 않고도 도구를 실행할 수 있다. 약 50줄의 코드로 수백 개의 도구 스키마를 로드하고 인증 인프라를 대체했다.
python
class ArcadeTools:
def __init__(self, toolkits=["Gmail", "GoogleCalendar", "Slack"], user_id=None, verbose=True):
self.arcade = Arcade()
self.user_id = user_id or os.environ["ARCADE_USER_ID"]
self.toolkits = toolkits
self.schemas = []
for tk in self.toolkits:
self.schemas.extend(self.arcade.tools.formatted.list(format="openai", toolkit=tk))Arcade SDK를 사용하여 Gmail, 캘린더, Slack 도구 스키마를 로드하는 초기화 로직
실제 실행 및 서비스 연동 테스트
구현된 에이전트를 실제로 실행하여 Gmail 전송, 캘린더 예약, 슬랙 보고 업무를 수행하는 과정을 시연했다. 에이전트는 사용자의 요청에 따라 특정 인물에게 이메일을 보내고, 회의 시간을 조정하여 캘린더에 반영한 뒤 그 결과를 슬랙 채널에 요약하여 게시했다. 모든 과정에서 Arcade가 인증 상태를 체크하고 필요한 경우에만 사용자에게 승인을 요청하는 효율적인 동작을 확인했다. 결과적으로 복잡한 비즈니스 자동화를 AI 에이전트가 자율적으로 완수하는 성과를 보였다.
용어 해설
- 아케이드(Arcade)
- — AI 에이전트가 외부 서비스와 안전하게 상호작용할 수 있도록 인증 및 도구 실행을 관리하는 액션 런타임 플랫폼이다. 개발자가 개별 API의 OAuth 인증 로직을 직접 구현할 필요 없이 수백 개의 도구를 즉시 연동할 수 있게 지원한다.
- 도구 호출(Tool Calling)
- — LLM이 사용자 요청을 해결하기 위해 외부 함수나 API를 호출해야 한다고 판단하고, 해당 함수에 필요한 인자를 생성하는 기능이다. 모델이 단순히 텍스트를 생성하는 것을 넘어 실제 행동을 취하게 만드는 핵심 메커니즘이다.
- 오픈 인증(OAuth)
- — 사용자의 비밀번호를 노출하지 않고 제3의 애플리케이션에 특정 서비스의 접근 권한을 부여하는 표준 인증 프로토콜이다. AI 에이전트가 사용자의 Gmail이나 Slack 계정에 접근하기 위해 반드시 거쳐야 하는 보안 절차이다.
- 모델 컨텍스트 프로토콜(MCP)
- — Model Context Protocol의 약자로, 다양한 데이터 소스와 도구를 AI 모델에 표준화된 방식으로 연결하기 위한 개방형 프로토콜이다. Arcade 대시보드에서 도구를 관리하고 에이전트에 주입하는 기반 기술로 활용된다.
언급된 리소스
DemoArcade
GitHubNicolai Nielsen GitHub
AI 분석 전체 내용 보기
AI 요약 · 북마크 · 개인 피드 설정 — 무료
출처 · 인용 안내
원문 발행 2026. 09. 08.수집 2026. 09. 08.출처 타입 YOUTUBE
인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.
