본문 바로가기

전체 글202

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.. 2026. 10. 9.
1. Google ADK 기반의 에이전트 아키텍처 및 오케스트레이션(Orchestration) 순차, 병렬, 반복 패턴 코드 1~4는 Google ADK(Agent Development Kit)를 활용하여 단일 에이전트부터 멀티 에이전트의 다양한 오케스트레이션(순차, 병렬, 반복) 패턴 예제들입니다.1. 코드별 주제코드 1: 단일 에이전트(Single Agent) 기본 구현코드 2: 순차 실행(Sequential Orchestration) 워크플로 패턴코드 3: 병렬 처리 및 결과 취합(Parallel Fan-Out / Fan-In) 워크플로 패턴코드 4: 레거시 루프 에이전트(LoopAgent) 기반 반복 처리 패턴 2. 코드별 상세 해설코드 1 주제: 단일 에이전트(Single Agent) 기본 구현import os from google.adk import Agent, Workflow weather_agent .. 2026. 10. 9.
[3/3] Harness와 MCP를 결합한 AI Agent 구축 지금까지 진행한 Python → Tool Calling → Agent Loop → MCP → Skill → Harness가 실제 코드 하나로 어떻게 합쳐지는지 이해하는 단계입니다.특히 이번에는 코드를 단순히 한 줄씩 번역하기보다는,“이 코드가 왜 필요한가 → 실행하면 무슨 일이 일어나는가 → 데이터가 어디로 이동하는가”를 중심으로 설명하겠습니다.1. 먼저 전체 그림부터 잡겠습니다우리가 지금 만든 시스템은 크게 두 개의 프로그램입니다.┌──────────────────────────────────────────────────────────┐│ Harness / AI Agent ││ .. 2026. 10. 5.
[2/3] 하니스엔지니어링(Harness Engineering) 로직 구현 이번 코드는 앞서 공부한 MCP + Skill 구조에서 한 단계 더 발전한 형태입니다.이전에는 우리가 다음 구조를 공부했습니다.SKILL.md → LLM → MCP Tool → MCP Server → 실제 데이터 → LLM → 답변이번에는 여기에 Harness Engineering이 추가됩니다.즉,“LLM에게 일을 시키는 것”에서 끝나는 것이 아니라, LLM이 여러 작업을 안정적으로 수행하도록 바깥에서 계획·상태·저장·재실행을 관리하는 구조입니다.특히 이번 코드에서 꼭 이해해야 할 핵심은 다음 5가지입니다.① SKILL.md → AI에게 "어떻게 일할지" 가르친다.② Tool → AI가 실제 데이터를 가져오게 한다.③ Agent Loop → Tool 호출 → 결과 전달.. 2026. 10. 4.
[1/3] MCP 기반 AI Agent와 Skill.md를 활용한 Tool Calling: MCP Server · MCP Client · SKILL.md · Tool Calling · Agent Loop 이번 코드는 **“MCP 서버가 제공하는 Tool을 LLM이 사용하고, 그 위에 로컬 SKILL.md를 시스템 지침으로 얹는 구조”**를 이해하는 것이 핵심입니다.특히 이번 예제에서 가장 중요한 것은 MCP와 Skill이 서로 같은 것이 아니라 역할이 완전히 다르다는 점입니다.MCP 서버 → 실제 기능과 데이터를 제공MCP 클라이언트 → 서버와 LLM 사이를 연결하고 도구를 전달·실행OpenAI LLM → 무엇을 해야 할지 판단하고 결과를 문장으로 만듦SKILL.md → LLM에게 “이 업무를 어떤 절차와 기준으로 수행할지” 알려주는 업무 지침서아래에서 코드 한 줄씩 → 실행 흐름 → 전체 구조 → MCP Prompt/Resource와 Skill의 차이 → 실제 실행 예시 순서로 설명하겠습니다. 이번 예.. 2026. 10. 4.
A2A. (2/2) Weather Client 이 코드는 크게 보면 다음 한 문장입니다."Weather Server의 Agent Card를 먼저 확인하고 → A2A Client를 만들고 → 사용자의 질문을 Message로 포장하고 → Request로 한 번 더 포장해서 → 서버에 보내고 → 서버가 보내는 응답 이벤트를 받아서 → Client를 종료한다." 전체 구조부터 잡고 하나씩 보겠습니다.1. 먼저 전체 그림을 이해하자현재 우리가 만든 프로그램은 A2A Client입니다.상대방에는 앞에서 만든 Weather Agent Server가 실행되고 있습니다.┌─────────────────────────────┐│ A2A Weather Client ││ ││ 우리가 지금 공부하는 코드 .. 2026. 10. 3.
반응형