개요
이 가이드 에서는 로컬 개발 환경에서 Atlas Agent Engine 에이전트 수동으로 테스트하는 방법을 학습 수 있습니다. agentengine dev 명령을 사용하여 환경을 시작한 후에는 CLI 가 앱 및 로컬 MongoDB 인스턴스 의 URL을 인쇄하므로 에이전트 를 빌드 하고 cloud 에 배포 전에 요청을 유도하고, 응답을 검사하고, 문제를 디버깅할 수 있습니다.
전제 조건
시작하기 전에 다음 작업을 완료했는지 확인하세요.
Agentengine CLI 설치하고 구성합니다.
로컬에서 에이전트 실행 및 테스트 가이드 의 단계에 따라 로컬 개발 환경을 시작합니다.
CLI 설치하고, 프로젝트 를 인증 및 등록하는 방법에 대해 자세히 학습 설치 및 인증을 참조하세요.
로컬 서비스 액세스
핫 리로드 또는 격리 모드 에서 agentengine dev up를 실행 CLI 에이전트 대한 Docker 이미지를 빌드하고 전체 스택 시작합니다. 모든 서비스가 준비되면 CLI 앱 및 로컬 MongoDB 인스턴스 의 URL을 출력합니다.
다음 URL을 사용하여 수동 테스트를 수행합니다.
앱 엔드포인트 URL: 브라우저, API 클라이언트 또는 명령줄 도구를 사용하여 에이전트 에 요청을 보냅니다.
MongoDB Atlas 로컬 URL:
mongosh또는 다른 MongoDB 클라이언트 사용하여 연결하여 테스트 데이터를 검사하거나 시딩합니다.
예시 를 들어 이러한 URL을 사용하여 다음 테스트를 수행할 수 있습니다.
특정 도구 호출을 실행하는 채팅 또는 HTTP 요청 보냅니다.
로컬 데이터베이스 에 테스트 문서를 삽입하고 에이전트 문서를 사용하는 방법을 확인합니다.
응답의 정확성, 지연 시간, 오류 처리를 검사합니다.
핫 리로드 모드에서 테스트
핫 리로드 모드 소스 코드 앱 컨테이너 에 마운트하고 변경 사항을 저장할 때마다 에이전트 프로세스 다시 로드합니다. 스택 다시 빌드하지 않고도 테스트하고 반복하려면 다음 워크플로를 사용합니다.
핫 리로드 모드 에서 환경을 시작하거나 실행 컨테이너 에 VS Code 연결하는 방법을 학습 로컬 환경 빌드 가이드 의 핫 리로드 모드(권장)를 참조하세요.
격리 모드에서 테스트
서비스 경계, 컨테이너 재시작 또는 네트워크 상호 작용에 의존하는 동작의 유효성을 검사하려면 격리 모드 사용하세요.
격리 모드 에서 환경을 시작하는 방법을 학습 로컬 환경 구축 가이드 에서 격리 모드를 참조하세요.
로그 검사 및 문제 해결
테스트하는 동안 agentengine dev 명령을 사용하여 로그를 검사하고 필요에 따라 상태 재설정합니다.
로그 보기
실행 모든 서비스에서 로그를 스트림 하려면 다음 명령을 실행 .
agentengine dev logs
이 출력을 사용하여 오류를 디버깅하고, 도구 호출을 확인하고, 에이전트 에서 방출하는 추적 메시지를 검사합니다.
로컬 상태 재설정
로컬 MongoDB 복제본 세트 또는 데이터와 관련하여 지속적인 오류가 발생하는 경우 다음 명령을 실행 하여 로컬 상태 재설정할 수 있습니다.
agentengine dev clean agentengine dev up
이 시퀀스는 모든 로컬 볼륨을 제거하고 새 스택 시작합니다.
경고
agentengine dev clean를 실행하면 MongoDB Atlas 로컬 볼륨에 저장된 모든 로컬 데이터가 영구적으로 삭제됩니다. 이 명령을 실행 전에 필요한 데이터를 백업하세요.
다음 단계
로컬에서 에이전트 유효성을 검사한 후 이를 빌드 하여 Atlas Agent Engine cloud 환경에 배포 할 수 있습니다. 에이전트 이미지를 패키지 하여 작업 공간에 배포 방법을 학습 에이전트 배포 섹션을 참조하세요.