Repolode
vizra-ai

vizra-ai/vizra-adk

지속 메모리, 추적 기능, 웹 대시보드를 갖춘 LLM 기반 AI 에이전트를 구축하고 배포하는 Laravel 패키지입니다(현재 유지보수 종료, 최종 버전은 v0.0.48).

스타
296
포크
37
열린 이슈
3
마지막 커밋
29일 전

어떤 프로젝트인가요?

Vizra ADK는 추론하고, 도구를 호출하며, 지속 메모리를 유지하는 자율 AI 에이전트를 구축하기 위한 Laravel 패키지입니다. 에이전트는 기본 LLM 에이전트 클래스를 확장하는 PHP 클래스로 정의하며, 이름, 지침, 모델, 도구를 선언하면 수동 등록 없이 자동으로 검색됩니다.

이 패키지는 Prism PHP 라이브러리를 통해 OpenAI, Anthropic, Google Gemini를 지원하며, 에이전트를 스캐폴딩하고 터미널에서 대화할 수 있는 Artisan 명령을 제공합니다. 또한 하위 에이전트 위임, 에이전트 워크플로(순차, 병렬, 조건부, 반복 흐름), 예약 실행·웹훅·이벤트 기반·큐 작업을 포함한 여러 트리거 모드, 스트리밍 응답, LLM-as-a-Judge 평가 프레임워크, 상세 실행 추적, Livewire 기반 웹 대시보드도 지원합니다.

이 프로젝트는 더 이상 유지보수되지 않습니다. 작성자는 2026년 8월 v0.0.48을 최종 릴리스로 프로젝트를 종료했으며, 에이전트를 구축하려는 사용자에게는 공식 Laravel AI SDK를, 에이전트를 평가하려는 사용자에게는 vizra/evals를 안내합니다.

핵심 기능

  • 01지침, 모델, 도구 목록을 갖춘 PHP 클래스로 에이전트를 정의하며, Laravel이 이를 자동으로 검색합니다.
  • 02Prism PHP를 통해 OpenAI, Anthropic, Google Gemini 모델을 지원합니다.
  • 03에이전트가 전문 하위 에이전트에 작업을 위임할 수 있습니다.
  • 04대화와 세션이 바뀌어도 유지되는 메모리를 제공합니다.
  • 05순차, 병렬, 조건부, 반복 워크플로를 지원합니다.
  • 06스트리밍 응답, 실행 추적, LLM-as-a-Judge 평가 프레임워크를 제공합니다.
  • 07Livewire 기반 웹 대시보드와 Artisan 명령을 제공합니다.

활용 사례

  • 기존 Laravel 앱에 사용자 지정 도구로 주문을 조회하는 고객 지원 챗봇을 추가하는 경우.
  • 데이터를 백그라운드에서 처리하는 예약 또는 큐 기반 에이전트 작업을 실행하는 경우.
  • 내장 평가 프레임워크로 에이전트 동작을 테스트하고 비교하는 경우.
  • 이미 이 패키지에 의존하는 기존 Laravel 프로젝트에서 v0.0.48을 고정해 사용하는 경우.

빠른 시작

  1. 1

    Composer로 패키지 설치

    composer require vizra/vizra-adk
  2. 2

    설정을 게시하고 마이그레이션 실행

    php artisan vizra:install
  3. 3

    첫 번째 에이전트 만들기

    php artisan vizra:make:agent CustomerSupportAgent
  4. 4

    에이전트와 채팅 시작

    php artisan vizra:chat customer_support

사용 전 알아둘 점

  • 이 프로젝트는 2026년 8월부로 종료되었으며, v0.0.48이 최종 릴리스입니다. 이후 수정 사항이나 보안 패치는 제공되지 않습니다.
  • Issue와 풀 리퀘스트는 더 이상 모니터링되지 않습니다.
  • 유료 LLM API 키(OpenAI, Anthropic 또는 Google)가 하나 이상 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

vizra-adk은(는) 무엇인가요?
지속 메모리, 추적 기능, 웹 대시보드를 갖춘 LLM 기반 AI 에이전트를 구축하고 배포하는 Laravel 패키지입니다(현재 유지보수 종료, 최종 버전은 v0.0.48). Vizra ADK는 추론하고, 도구를 호출하며, 지속 메모리를 유지하는 자율 AI 에이전트를 구축하기 위한 Laravel 패키지입니다. 에이전트는 기본 LLM 에이전트 클래스를 확장하는 PHP 클래스로 정의하며, 이름, 지침, 모델, 도구를 선언하면 수동 등록 없이 자동으로 검색됩니다.
vizra-adk은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
vizra-adk은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
vizra-adk은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. vizra-adk의 마지막 커밋은 2026년 10월 9일입니다.
vizra-adk은(는) 어디에 사용할 수 있나요?
기존 Laravel 앱에 사용자 지정 도구로 주문을 조회하는 고객 지원 챗봇을 추가하는 경우. 데이터를 백그라운드에서 처리하는 예약 또는 큐 기반 에이전트 작업을 실행하는 경우. 내장 평가 프레임워크로 에이전트 동작을 테스트하고 비교하는 경우. 이미 이 패키지에 의존하는 기존 Laravel 프로젝트에서 v0.0.48을 고정해 사용하는 경우.
vizra-adk는 어떻게 설치하나요?
Composer로 패키지 설치: composer require vizra/vizra-adk 설정을 게시하고 마이그레이션 실행: php artisan vizra:install 첫 번째 에이전트 만들기: php artisan vizra:make:agent CustomerSupportAgent 에이전트와 채팅 시작: php artisan vizra:chat customer_support
vizra-adk은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/vizra-ai/vizra-adk

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트