전체 글211 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)과 실제 날씨 정보를 가져오.. 2026. 10. 11. 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 이용 .. 2026. 10. 11. 9. G-ADK Tool 활용[6](2/3) - ContainerCodeExecutor (도커 기반 컨테이너 실행)를 다루는 코드 Google ADK의 코드 실행(Code Execution) 방법 중 두 번째 방식인 ContainerCodeExecutor (도커 기반 컨테이너 실행)를 다루는 코드입니다.1. ContainerCodeExecutor의 핵심 개념앞서 보았던 BuiltInCodeExecutor가 ADK 내부의 기본 환경에서 코드를 실행했다면, ContainerCodeExecutor는 격리된 도커(Docker) 컨테이너 안에서 안전하게 파이썬 코드를 실행하는 방식입니다.완벽한 보안과 격리: 에이전트가 실수로 위험한 코드나 시스템 명령어를 실행하더라도, 호스트(내 컴퓨터)가 보호되고 도커 컨테이너 내부만 영향을 받습니다.환경 맞춤화: 프로젝트에 필요한 특정 파이썬 버전이나 외부 패키지가 미리 설치된 도커 이미지를 자유롭게 지.. 2026. 10. 10. 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()는 .. 2026. 10. 10. 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.. 2026. 10. 10. 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.. 2026. 10. 10. 이전 1 2 3 4 ··· 36 다음 반응형
