아톨러브

11. G-ADK Tool 활용[8]- PlanReActPlanner(사고 과정을 설계하는 명시적 플래너)

Google ADK(Agent Development Kit)와 Gemini 모델을 활용하여 Open-Meteo 지오코딩 API와 OpenWeatherMap API를 연동하고, AI 에이전트(Agent)가 도구(Tool)로 삼아 실시간 날씨를 조회할 수 있도록 구현한 파이썬 스크립트입니다.I. 코드 요약 및 핵심 의미제목: Google ADK와 외부 날씨 API(Open-Meteo & OpenWeatherMap)를 연동한 LLM 에이전트 구현핵심 의미:사용자의 자연어 질문(예: "서울 날씨 어때?")을 이해하고, 에이전트가 스스로 필요한 도구(get_real_current_weather)를 선택해 실행합니다.도시 이름을 위/경도 좌표로 변환하는 지오코딩 과정(Open-Meteo)과 실제 날씨 정보를 가져오..

10. G-ADK Tool 활용[7](3/3) - GCP 샌드박스 에이전트 엔진 기

GCP 샌드박스 에이전트 엔진 인스턴스 생성 및 ADK(Agent Development Kit) 웹 UI 연동 작업에 대한 전체 흐름과, 두 가지 핵심 코드에 대한 상세한 해설입니다.1. GCP 샌드박스 에이전트 엔진 구축 및 ADK 연동 작업 순서GCP 인증 및 환경 설정 1) 터미널에서 구글 클라우드 인증을 수행하여 Application Default Credentials(ADC)를 발급받습니다. => winget install -e --id Google.CloudSDK Google Cloud CLI (gcloud) 설치하기 Windows 환경에서 신속/깔끔한 설치하는 방법인 PowerShell의 패키지 관리자인 winget 이용 ..

9. G-ADK Tool 활용[6](2/3) - ContainerCodeExecutor (도커 기반 컨테이너 실행)를 다루는 코드

Google ADK의 코드 실행(Code Execution) 방법 중 두 번째 방식인 ContainerCodeExecutor (도커 기반 컨테이너 실행)를 다루는 코드입니다.1. ContainerCodeExecutor의 핵심 개념앞서 보았던 BuiltInCodeExecutor가 ADK 내부의 기본 환경에서 코드를 실행했다면, ContainerCodeExecutor는 격리된 도커(Docker) 컨테이너 안에서 안전하게 파이썬 코드를 실행하는 방식입니다.완벽한 보안과 격리: 에이전트가 실수로 위험한 코드나 시스템 명령어를 실행하더라도, 호스트(내 컴퓨터)가 보호되고 도커 컨테이너 내부만 영향을 받습니다.환경 맞춤화: 프로젝트에 필요한 특정 파이썬 버전이나 외부 패키지가 미리 설치된 도커 이미지를 자유롭게 지..

8. G-ADK Tool 활용[5](1/3) - BuiltInCodeExecutor(내장 실행기)를 로컬 환경에서 구현

Google ADK(Agent Development Kit)에서 제공하는 Code Execution(코드 실행 기능)의 세 가지 방법 중 첫 번째인 BuiltInCodeExecutor를 활용하는 에이전트 코드입니다.1. BuiltInCodeExecutor의 핵심 개념 (Code Execution이란?)LLM은 언어 모델 특성상 복잡한 다단계 산술 연산, 데이터 분석, 프로그래밍 로직 검증 등에서 가끔 실수를 하거나 환각(Hallucination)을 일으킬 수 있습니다. 이를 해결하기 위해 에이전트가 "말이나 생각으로만 답하지 않고, 직접 파이썬 코드를 작성해서 실행한 뒤 그 결과를 보고 답변하는 능력"을 부여하는 기술이 바로 Code Execution입니다.그중 BuiltInCodeExecutor()는 ..

7. G-ADK Tool 활용[4.2] - Declarative OpenAPI Spec Tool (OpenWeatherMap_OpenAPI_명세서.json)

Declarative OpenAPI Spec Tool 코드에서 사용하는 OpenAPIToolset은 OpenWeatherMap처럼 거대하고 복잡한 공식 Swagger 명세서 전체를 넣으면 파싱 에러가 나거나 토큰이 낭비되기 쉽습니다. 따라서 가장 현명하고 신속하며 확실하게 작동하는 방식은 "에이전트가 실제로 사용하는 핵심 엔드포인트(/weather, /forecast)만 쏙쏙 골라 담은 미니멀 OpenAPI 3.0 JSON 명세서를 직접 구성하는 것"입니다. 아래에 Declarative OpenAPI Spec Tool 코드와 완벽하게 호환되며 곧바로 파일로 저장해 쓸 수 있는 실전용 OpenWeatherMap_OpenAPI_명세서.json 코드 템플릿을 정리합니다. 실전용 OpenWeatherMap_Op..

6. G-ADK Tool 활용[4.1] - Declarative OpenAPI Spec Tool (OpenAPI Spec 명세서 자동 바인딩)

개발자가 API 호출 함수를 일일이 파이썬 코드로 작성하지 않고, OpenAPI/Swagger JSON 명세서 파일을 그대로 읽어 들여 툴 세트로 자동 변환 및 등록하는 고급 방식입니다. 이 코드는 OpenAPI 규격문서(JSON)를 파싱하여, 개발자가 일일이 Python 함수를 만들지 않고도 OpenWeatherMap API를 LLM 도구(Tool)로 자동으로 변환 및 바인딩하는 최신 ADK 툴셋 구현 코드입니다. TypeError: the JSON object must be str... not NoneType 에러를 방지하기 위한 안전장치(read_file_as_string)와 API Key 인증 헬퍼(auth_helpers)까지 깔끔하게 포함되어 있습니다.I. 주요 동작 방식OpenWeatherMa..

5. G-ADK Tool 활용[3] - Custom Open API Tool (Python requests 함수 직접 구현)

실제 외부 날씨 API(OpenWeatherMap, Open-Meteo)를 호출하는 파이썬 함수를 작성하고, 이를 에이전트의 Custom Tool로 등록하는 방식입니다.1. 주요 동작 방식2단계 API 연동 구조를 가집니다. 사용자가 도시 이름을 입력하면, 먼저 위도/경도를 찾아주는 get_coordinates 함수를 거친 후, 해당 좌표를 이용해 OpenWeatherMap API에서 실시간 날씨 JSON 데이터를 받아옵니다. ADK는 이 전체 과정을 하나의 get_real_current_weather 툴로 인식하여 필요할 때 자동으로 실행합니다.2. 코드 라인별 상세 해설get_coordinates(location: str) (위경도 변환 함수)Open-Meteo Geocoding API를 사용해 입력..

4. G-ADK Tool 활용[2] - Custom Tool / Function Tool (파이썬 함수를 도구로 변환)

개발자가 직접 작성한 일반 파이썬 함수를 LLM이 인식하고 실행할 수 있는 에이전트 도구로 자동 변환하여 사용하는 방식입니다.1. 주요 동작 방식ADK는 파이썬 함수의 함수명, Docstring(주석 설명), Type Hint(타입 힌트)를 자동으로 분석(Parsing)하여, 이를 LLM이 이해할 수 있는 OpenAPI/JSON Schema 형태의 툴 스펙으로 변환합니다.2. 코드 라인별 상세 해설MOCK_WEATHER_DATA = { ... }외부 API 연동 대신 테스트 목적으로 만든 가짜(Mock) 날씨 데이터베이스입니다.def get_current_weather(city: str) -> str: 및 Docstring[가장 중요한 부분] LLM이 이 함수를 언제, 어떻게 사용해야 할지 판단하는 기준..

3. G-ADK Tool 활용[1]- Prebuilt Tool (사전 정의된 검색 도구 활용)

Google ADK(Agent Development Kit)에서 기본 제공하는 Prebuilt Tool을 활용하여 실시간 웹 검색 기반의 팩트 체크 에이전트를 구축하는 코드입니다.1. 주요 동작 방식LLM은 자체적인 학습 데이터 범위를 넘어선 최신 정보나 내부 데이터는 알지 못합니다. 이 코드에서는 Google이 미리 만들어 둔 google_search 툴을 에이전트에 장착시켜, 필요할 때 에이전트가 직접 구글 검색을 수행하고 그 결과를 바탕으로 답변하도록 구성되어 있습니다. 2. 코드 라인별 상세 해설from google.adk.tools import google_searchADK 라이브러리에서 미리 구상된 google_search 툴을 불러옵니다. 개발자가 검색 API 연동 로직을 직접 구현할 필요 ..

2. Google ADK, Custom Agent - 보안 게이트키퍼 시스템

사용자가 입력한 암호를 검증한 뒤, 인증에 성공했을 때만 기밀 정보를 처리하는 AI 비서 에이전트로 제어권(Handoff/Transfer)을 넘겨주는 보안 게이트키퍼 시스템입니다.코드의 구성을 1) 모듈 임포트, 2) 작업 에이전트 정의, 3) 커스텀 게이트키퍼 클래스, 4) 인스턴스 생성 및 Root Agent 설정 영역으로 나누어 한 줄 한 줄 상세히 설명해 드리겠습니다.1. 모듈 임포트 (Import) 영역import osfrom typing import AsyncGeneratorfrom google.adk import Agentfrom google.adk.agents import BaseAgentfrom google.adk.agents.invocation_context import Invocati..