
ADK-TS
IQ AI · 코딩
ADK-TS는 TypeScript로 AI 에이전트를 만드는 오픈소스 프레임워크다. 여러 LLM 공급자를 지원하고 도구, 세션, 메모리를 갖췄으며, 한 줄의 코드로 첫 에이전트를 실행한다.

ADK-TS 소개
About
ADK-TS란 무엇인가
ADK-TS는 TypeScript로 AI 에이전트를 만드는 프레임워크이며, TypeScript는 많은 웹과 Node.js 개발자가 이미 매일 쓰는 언어다. TypeScript AI 에이전트 프레임워크로서 시각적 패널이 아니라 코드로 에이전트를 정의하려는 사람을 겨냥하고, TypeScript로 AI 에이전트 만들기를 원하는 이들에게 곧바로 쓰인다. IQ AI가 MIT 라이선스의 오픈소스 프로젝트로 유지하므로 소스를 읽고, 포크하고, 상용 제품에 넣어도 라이선스 비용이 들지 않는다.
이 프레임워크는 에이전트 개발에서 흔히 접착 코드 더미로 변하는 부분을 대신 맡는다. 공급자에 얽매이지 않는 모델 접근, 외부 서비스를 잇는 도구 체계, 턴을 넘어 맥락을 유지하는 세션 관리를 제공한다. 그것들을 직접 배선하는 대신 에이전트를 기술하고 추론 루프는 프레임워크에 맡기면 된다.
가장 큰 한계는 코드를 쓰는 사람을 위한 도구라는 점이다. 비기술 사용자를 위한 드래그 앤 드롭 빌더가 없고, 문서도 여전히 작업 중으로 표시돼 일부 절이 불완전하다. TypeScript나 JavaScript를 다루지 않는다면 얻는 이점은 금방 줄어든다.
시작하기
npm install -g @iqai/adk-cli로 CLI를 전역 설치하고adk를 실행해 프로젝트를 만든다. 기존 앱에는npm install @iqai/adk로 패키지를 추가한다..env파일에 API 키를 설정한다. Google Gemini는GOOGLE_API_KEY만 있으면 되고, 다른 공급자는 각자의 키를 쓴다.- AgentBuilder API나 일반
LlmAgent로 에이전트를 정의하고 모델 이름을 지정한다. - 작업에 필요하면 도구나 세션 서비스, 하위 에이전트를 붙이고 에이전트를 실행해 응답을 읽는다.
제품 정보
ADK-TS의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- 웹 앱에 AI 기능을 넣는 TypeScript와 Node.js 개발자. 프레임워크가 그들의 언어로 말하고 npm install 한 번으로 기존 프로젝트에 들어간다.
- 프롬프트 스크립트가 아니라 타입이 있는 에이전트 로직을 원하는 풀스택 엔지니어. 모델과 도구, 세션이 타입 정의를 갖춘다.
- LLM 공급자를 바꿔야 하는 팀. 하나의 API가 Gemini, OpenAI, Anthropic, OpenRouter를 서로 교체 가능한 백엔드로 다룬다.
작업
- 지속적인 메모리를 가진 챗봇과 어시스턴트 만들기. 세션이 메시지 기록을 저장해 맥락이 턴을 넘어 살아남는다.
- 여러 에이전트를 파이프라인으로 잇기. 워크플로 에이전트가 단계를 순차, 병렬, 또는 루프로 실행한다.
- 에이전트를 외부 데이터와 서비스에 연결하기. 도구 체계와 MCP 지원이 검색, 파일, 서드파티 API를 끌어온다.
활용 상황
- 오후 한나절에 에이전트 아이디어를 시험하기. AgentBuilder 한 줄 호출이 인프라를 쓰기 전에 에이전트를 돌린다.
- 출처를 밝히는 리서치 어시스턴트 구성하기. 웹 검색 도구와 파일 작업을 결합하고 찾은 내용을 인용하라는 지시를 붙인다.
- 에이전트를 Node.js 서비스나 서버리스 함수에 올리기. Node.js가 도는 곳이면 어디든 배포하고 관측성을 위해 OpenTelemetry 추적도 쓴다.
주요 기능
AgentBuilder로 한 줄짜리 에이전트
AgentBuilder API는 연결된 호출 한 번으로 동작하는 에이전트를 만들고 곧바로 질문을 던진다. AgentBuilder.withModel("gemini-2.5-flash").ask(...)는 모델의 답을 바로 돌려주므로 본격적인 구조로 가기 전에 아이디어를 시험하기 좋다. 거기서 같은 빌더에 세션, 도구, 하위 에이전트를 더할 수 있다.
여러 모델 공급자 지원
ADK-TS는 기본으로 Google Gemini를 쓰지만 다른 공급자도 동등하게 다룬다. 모델 이름을 문자열로 넘기면 프레임워크가 공급자를 알아낸다. 더 깊이 들어가려면 Vercel AI SDK의 모델 인스턴스도 쓴다. OpenAI, Anthropic, Groq, Mistral과 OpenRouter의 모델 목록이 같은 에이전트 코드로 연결된다.
확장 가능한 도구 체계와 MCP
도구는 에이전트에 말하는 능력이 아니라 행동하는 능력을 준다. 선언적 스키마로 직접 도구를 정의하면 모델이 언제 어떻게 호출할지 판단한다. Model Context Protocol 지원은 더 나아가 블록체인, 시장 데이터, 메시징, 파일 같은 외부 MCP 서버에 에이전트를 연결한다. 템플릿으로 직접 서버를 만들 수도 있다.
세션과 지속적 메모리
모든 대화는 Session 객체 안에서 돌며 메시지 기록과 가변 상태를 추적한다. 세션은 강한 타입을 가지며 대화가 진행되는 동안 자동으로 만들어지고 불러와지고 저장된다. 덕분에 저장 로직을 직접 쓰지 않아도 이전 턴을 기억하고, 백엔드는 앱에 맞는 것을 고른다.
멀티 에이전트 워크플로
워크플로 에이전트는 여러 전문 에이전트를 하나의 시스템으로 묶는다. 순차 워크플로는 일을 다음 에이전트로 넘기고, 병렬은 동시에 돌리고, 루프는 조건이 충족될 때까지 반복한다. 조사하고 분석하고 요약하는 흐름도 빌더 호출 몇 번이면 된다.
스트리밍과 관측성
에이전트는 응답을 토큰 단위로 스트리밍할 수 있어 대화형 챗과 실시간 화면에 맞는다. 운영을 위해 ADK-TS는 OpenTelemetry 추적을 담아 에이전트의 단계를 따라가며 시간과 토큰이 어디로 가는지 확인하게 한다. 이 관측성은 에이전트가 데모 단계를 벗어난 뒤에 중요해진다.
장단점
장점
- 모델과 도구, 세션 전반에 타입 안전성이 있어 실행 전에 편집기가 실수를 잡는다.
- 공급자에 종속되지 않는 설계가 락인을 피하고 로직을 다시 쓰지 않고 LLM을 바꾸게 한다.
- 세션, 메모리, 스트리밍, 추적을 덧붙이는 옵션이 아니라 기본으로 갖춘다.
- MIT 라이선스와 npm 패키지라 개인과 기업 모두 도입 비용이 낮다.
단점
- 코드를 쓰는 사람만을 위한 도구로, TypeScript를 쓰지 않는 사람을 위한 시각적 빌더가 없다.
- 문서가 여전히 작업 중으로 표시돼 일부 절이 불완전하다.
- TypeScript와 Node.js 도구 환경에 어느 정도 익숙함을 전제로 해서 초보자에게 문턱이 높다.
- 에이전트 실행에는 자신의 LLM API 키가 필요해 사용량 기반 비용을 예산에 넣어야 한다.
자주 묻는 질문
ADK-TS는 TypeScript로 AI 에이전트를 만드는 데 쓴다. 개발자는 챗봇, 리서치 어시스턴트, 콘텐츠 파이프라인, 그리고 에이전트가 도구를 호출하거나 맥락을 기억하거나 다른 에이전트와 협력해야 하는 작업에 이를 활용한다.
관련 콘텐츠
ADK-TS와 관련된 도구, 스킬, 아티클을 살펴보세요.
ADK-TS 대안
Base Code
Base44 (Wix) · 코딩 · 생산성Base Code는 Base44가 만든 공유 클라우드 개발 환경이다. 팀은 기존 GitHub 저장소에 대한 변경을 채팅으로 설명하고, 미리보기로 확인한 뒤 풀 리퀘스트로 돌려보낸다.
Google EmbeddingGemma 2
Google DeepMind · 글쓰기 · 이미지 · 코딩Google EmbeddingGemma 2는 7억 4000만 파라미터의 오픈 모델로, 텍스트와 코드, 이미지, 오디오, 영상 프레임을 하나의 768차원 공간에 벡터로 바꿔 스마트폰과 노트북에서 실행한다.
GitGlow
GitGlow · 코딩 · 생산성GitGlow는 내 코드와 AI 에이전트의 변경을 한 리뷰에 모으는 데스크톱 Git 클라이언트다. 배포 전에 내 기계에서 무엇이 나가는지 확인할 수 있다.
