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

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

사용자 지정 에이전트 정의

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

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

다음은 첫 번째 사용자 지정 에이전트를 생성하기 위한 step-by-step 연습입니다.

  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 구성 사용

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

  • 도구 액세스를 필요한 것으로만 제한

  • 중단을 줄이기 위한 추가 도구 사전 승인

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

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