AVCTL

인증 관리

AVCTL은 Agentverse 계정과의 인증을 처리합니다. avctl auth login 명령으로 로그인하고, avctl auth logout로 로그아웃하며, avctl auth status로 현재 인증 상태를 확인할 수 있습니다. 헤드리스 환경에서는 --no-browser 옵션을 사용하여 인증 URL을 터미널에 출력할 수 있습니다.

개별 에이전트 관리

개별 에이전트를 다루는 호스팅 명령이 제공됩니다. avctl hosting init로 템플릿 에이전트를 초기화하고, avctl hosting pull -a <agent_address>로 기존 에이전트를 가져올 수 있습니다. avctl hosting deploy로 에이전트를 Agentverse에 배포하고, avctl hosting run -l로 로그와 함께 에이전트를 실행할 수 있습니다. 또한 avctl hosting logs -f로 실시간 로그를 확인하고, avctl hosting stop로 에이전트를 중지할 수 있습니다.

워크스페이스 관리

여러 에이전트를 하나의 워크스페이스로 관리할 수 있습니다. avctl hosting init --workspace로 워크스페이스를 초기화하고, 각 에이전트 폴더에 agent.py, pyproject.toml, .env 파일을 배치해야 합니다. .env 파일에는 AGENT_ADDRESS={{ .AgentName.Address }} 형식으로 의존성을 지정합니다. 초기화 후 avctl hosting deploy로 의존성 순서에 따라 모든 에이전트를 배포할 수 있습니다.

다운로드·설치 방법

Windows 사용자는 다음 방법으로 AVCTL을 설치할 수 있습니다.

Chocolatey를 통한 설치

Chocolatey 패키지 관리자가 설치되어 있다면, 관리자 권한으로 PowerShell 또는 명령 프롬프트를 열고 다음 명령을 실행합니다:

choco install avctl

수동 설치 (PowerShell 스크립트)

Chocolatey를 사용하지 않는 경우, 공식 설치 스크립트를 직접 실행할 수 있습니다. PowerShell을 관리자 권한으로 열고 다음 명령을 입력합니다:

Invoke-WebRequest -UseBasicParsing https://github.com/fetchai/avctl/releases/latest/download/install.ps1 | Invoke-Expression

이 스크립트는 AVCTL을 %LOCALAPPDATA%Programsavctl 디렉터리에 설치하고 사용자 PATH에 추가합니다. 설치를 마친 후 새 터미널을 열어 경로 변경을 적용해야 합니다.

특정 버전을 설치하려면 설치를 실행하기 전에 환경 변수를 설정합니다. 예를 들어 v0.1.17 버전을 고정하려면:

$env:AVCTL_VERSION="v0.1.17"

설치가 완료되면 avctl version 명령으로 버전을 확인하고, avctl auth login으로 Agentverse에 로그인하여 사용을 시작할 수 있습니다.

기본 사용법/명령어

AVCTL을 처음 사용하는 경우 다음과 같은 워크플로우를 따릅니다.

1. Agentverse에 인증합니다:

   avctl auth login

   이 명령은 브라우저를 열어 Fetch.ai 로그인 페이지로 이동시킵니다. 헤드리스 환경에서는 --no-browser 플래그를 추가하여 인증 URL만 출력할 수 있습니다.

2. 작업 디렉터리를 생성하고 이동합니다:

   mkdir myagent
cd myagent

3. 에이전트를 초기화하거나 기존 에이전트를 가져옵니다:

   새 프로젝트의 경우 템플릿으로 초기화:

   avctl hosting init

   기존 에이전트를 사용하는 경우 주소를 지정하여 가져옵니다 (주소는 avctl hosting get agents로 확인 가능):

   avctl hosting pull -a <agent_address>

4. 에이전트를 Agentverse에 배포합니다:

   avctl hosting deploy

   이미 배포된 에이전트의 경우 이 명령은 업데이트 및 재시작만 수행합니다.

워크스페이스를 사용할 경우 다음과 같이 진행합니다:

1. 인증 후 작업 디렉터리를 생성합니다:

   avctl auth login
mkdir myworkspace
cd myworkspace

2. 각 에이전트 폴더에 필수 파일(agent.py, pyproject.toml, .env)을 배치하고, .env에 의존성을 설정합니다 (예: AGENT_ADDRESS={{ .AgentName.Address }}).

3. 워크스페이스를 초기화합니다:

   avctl hosting init --workspace

4. 모든 에이전트를 의존성 순서에 따라 배포합니다:

   avctl hosting deploy

이런 경우에 유용합니다

AI 에이전트를 Fetch.ai의 Agentverse 플랫폼에 배포하고 관리해야 하는 개발자에게 유용합니다. 특히 여러 에이전트가 서로 의존하는 복잡한 워크스페이스를 구성할 때, AVCTL은 의존성 감지와 순차적 배포를 자동화하여 수동 구성 오류를 줄이고 배포 프로세스를 간소화합니다. 개별 에이전트의 빠른 테스트 및 반복 개발을 위한 로컬 실행 및 로그 확인 기능도 제공합니다.

지원 환경·시스템 요구사항

AVCTL은 Windows 64비트(x86_64) 환경을 지원합니다. 공식 배포 자산은 avctl_Windows_x86_64.zip 형태로 제공됩니다. macOS 및 Linux 버전도 별도로 제공되지만, 이 스토어 항목은 Windows 사용자를 대상으로 합니다.

최신 버전·업데이트

현재 버전은 0.1.18이며, GitHub 저장소의 릴리스 페이지에서 최신 버전 정보를 확인할 수 있습니다. 버전 고정이 필요한 경우 설치 스크립트 실행 전에 AVCTL_VERSION 환경 변수를 설정하여 원하는 버전을 지정할 수 있습니다.