사용자 지정 에이전트 정의 - Amazon Q Developer
첫 번째 사용자 지정 에이전트 생성사용자 지정 에이전트 명령레거시 프로필에서 마이그레이션기본 에이전트 사용과 맞춤형 사용자 지정 에이전트 사용

사용자 지정 에이전트 정의

이 섹션에서는 Amazon Q Developer CLI 워크플로에서 사용자 지정 에이전트를 생성하고 사용하는 방법을 다룹니다.

첫 번째 사용자 지정 에이전트 생성

다음은 첫 번째 사용자 지정 에이전트를 생성하기 위한 단계별 안내입니다.

  1. Amazon Q Developer CLI 채팅 세션 시작:

    $ q chat

  2. 기존 에이전트를 나열하여 사용 가능한 항목을 확인합니다.

    /agent list

  3. 새 에이전트 생성(my-agent를 원하는 이름으로 변경):

    /agent create --name my-agent

    그러면 새 에이전트 구성 파일이 생성되고 기본 편집기(EDITOR 환경 변수를 통해 설정)에서 열립니다.

  4. 필요에 따라 사용자 지정 에이전트 구성을 사용자 지정합니다. 간단한 시작을 위해 다음을 수행할 수 있습니다.

    • 사용자 지정 에이전트의 목적을 서술하는 설명 추가

    • 사용 가능한 도구 지정

    • 자주 사용하는 도구 사전 승인

  5. 구성 파일을 저장하고 편집기를 종료하여 채팅 세션으로 돌아갑니다.

  6. 사용자 지정 에이전트와 새 채팅 세션 시작:

    $ q chat --agent my-agent

    참고: 기존 채팅 세션 내에서 사용자 지정 에이전트를 전환할 수 없습니다. 사용자 지정 에이전트를 변경하려면 새 세션을 시작해야 합니다.

  7. 구성한 도구를 사용하여 작업을 수행하도록 요청하여 사용자 지정 에이전트를 테스트합니다.

사용자 지정 에이전트 구성 옵션에 대한 자세한 내용은 구성 참조를 참조하세요.

사용자 지정 에이전트 명령

Amazon Q Developer CLI는 사용자 지정 에이전트 관리를 위한 여러 명령을 제공합니다. 이러한 명령은 채팅 세션 중에 사용할 수 있으며 /agent로 시작합니다.

사용자 지정 에이전트 명령
Command 설명 가용성
/agent list 환경에서 사용 가능한 모든 사용자 지정 에이전트 표시 채팅 세션
/agent schema 사용자 지정 에이전트 구성 파일을 생성하기 위한 JSON 스키마 표시 채팅 세션
/agent create --name [name] 새 사용자 지정 에이전트 구성 파일을 생성하고 기본 편집기에서 열기 채팅 세션

참고: 일부 사용자 지정 에이전트 관리 작업에는 대화형 명령이 아닌 수동 파일 편집이 필요합니다. 사용자 지정 에이전트 변경 사항은 새 채팅 세션을 시작할 때 적용됩니다.

레거시 프로필에서 마이그레이션

에이전트를 지원하는 Amazon Q Developer CLI 버전으로 업데이트하고 로그인할 때 다음과 같은 경우 레거시 프로필을 에이전트로 마이그레이션하라는 메시지가 표시될 수 있습니다.

  • 기존 레거시 프로필 구성이 있는 경우

  • 대화형 모드에서 실행 중(--no-interactive로 마이그레이션을 건너뜀)

  • 이전에 마이그레이션 프로세스를 완료하지 않음

마이그레이션 프로세스:

  • 기존 프로필 구성을 새 에이전트 형식으로 변환

  • 기존 도구 권한 및 컨텍스트 설정 보존

  • 홈 디렉터리에 에이전트 구성 파일 생성

  • 기존 워크플로와의 하위 호환성 유지

마이그레이션은 선택 사항이며 거부할 수 있습니다. 마이그레이션하지 않기로 선택한 경우 기본 에이전트를 계속 사용하거나 새 에이전트를 수동으로 생성할 수 있습니다. 마이그레이션 동작을 제어하려면 --no-interactive 플래그를 사용하여 마이그레이션 프롬프트를 완전히 건너뜁니다.

기본 에이전트 사용과 맞춤형 사용자 지정 에이전트 사용

Amazon Q Developer CLI에는 사전 승인된 최소한의 권한으로 모든 도구에 액세스할 수 있는 기본 에이전트가 내장되어 있습니다. 이 기본 에이전트는 다음과 같습니다.

  • 사용 가능한 모든 도구(내장 및 MCP) 포함

  • 보안을 위해 fs_read 도구만 사전 승인

  • README.md 및 AmazonQ.md와 같은 공통 프로젝트 파일을 자동으로 포함

  • 사용 가능한 경우 레거시 MCP 구성 사용

맞춤형 사용자 지정 에이전트를 사용하면 다음을 수행할 수 있습니다.

  • 필요한 도구에만 액세스하도록 제한

  • 중단 감소를 위한 추가 도구 사전 승인

  • 특정 프로젝트 설명서 및 컨텍스트 파일 포함

  • 특정 사용 사례에 맞게 도구 동작 구성