ADK for Go

구글의 코드 우선 에이전트 개발 도구 모음 고 판

go get google.golang.org/adk/v2

에이전트를 만들고 평가하고 배포하는 구글의 도구 모음입니다. 소프트웨어 개발 원칙을 에이전트 제작에 적용해 유연하고 모듈화된 구조를 지향합니다. 에이전트 논리와 도구, 조율을 전부 코드로 정의하므로 시험과 판 관리가 됩니다. 특정 모델에 최적화되어 있지만 모델과 배포 방식을 가리지 않고 다른 프레임워크와도 호환됩니다. 전문 에이전트를 여러 개 조합해 규모를 키우는 다중 에이전트 구성을 지원합니다. 고의 동시성과 성능을 살려 클라우드 환경에 올리기 좋습니다. 파이썬과 자바, 코틀린, 타입스크립트 판이 각각 따로 있습니다.

판단

이럴 때 씁니다

  • 고로 된 서비스에 에이전트를 넣을 때
  • 에이전트 논리를 코드로 관리하고 싶을 때
  • 클라우드 환경에 컨테이너로 올릴 때

이럴 땐 쓰지 마세요

  • 설정 파일로 끝내고 싶으면 맞지 않습니다
  • 다른 언어 판과 기능 진척이 다를 수 있습니다
  • 판이 2.x 로 올라 예전 코드와 다릅니다

차별점

  • 에이전트 논리와 도구, 조율을 전부 코드로 정의합니다.
  • 고의 동시성을 살린 구조입니다.
  • 모델과 배포 방식을 가리지 않습니다.
  • 문서를 기계가 읽는 단일 파일로도 제공합니다.

워크플로

  1. 01모듈을 받습니다.
  2. 02에이전트와 도구를 코드로 정의합니다.
  3. 03조율 방식을 코드로 씁니다.
  4. 04평가 도구로 결과를 확인합니다.
  5. 05컨테이너로 만들어 올립니다.

주요 명령

명령설명
go get google.golang.org/adk/v2모듈을 받습니다. 저장소 이름과 모듈 경로가 다릅니다.

함정

설치 전에 확인하세요

  • 모듈 경로가 저장소 주소와 다릅니다. 저장소 이름으로 받으면 안 됩니다.
  • 판이 2.x 대입니다. 이전 판 예제는 그대로 안 돕니다.
  • 언어별 판이 각각 다른 저장소입니다. 기능 진척이 다를 수 있습니다.
  • 특정 모델에 최적화되어 있습니다. 다른 모델은 설정이 더 필요합니다.

비교

설정 중심 프레임워크는 시작이 빠르지만 복잡해지면 표현이 막힙니다. 이쪽은 처음부터 코드로 쓰게 해서 시험과 판 관리를 그대로 가져갑니다. 대신 짧은 예제로 끝나는 작업에는 코드가 많아 보입니다.

최근 변경

중첩된 작업 흐름에서 사람이 개입한 뒤 재개할 때 응답이 유지되도록 고쳤습니다. 실시간 세션을 닫을 때 흐름을 제대로 정리하는 수정과 오류 표현 방식을 일관되게 맞추는 정리도 들어갔습니다.