사용자 지정 에이전트 관리 - Amazon Q Developer
사용자 지정 에이전트 파일 위치사용자 지정 에이전트 구성 모범 사례팀과 사용자 지정 에이전트 공유

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

사용자 지정 에이전트 관리

이 섹션에서는 개발 워크플로에서 사용자 지정 에이전트를 효과적으로 구성, 관리 및 사용하는 방법을 다룹니다.

사용자 지정 에이전트 파일 위치

사용자 지정 에이전트 구성 파일은 특정 디렉터리에 JSON 파일로 저장됩니다.

글로벌 사용자 지정 에이전트

~/.aws/amazonq/cli-agents/{agent-name}.json

시스템의 모든 프로젝트 및 디렉터리에서 사용할 수 있습니다.

프로젝트 수준 사용자 지정 에이전트

.amazonq/cli-agents/{agent-name}.json

특정 프로젝트 디렉터리 및 해당 하위 디렉터리 내에서만 사용할 수 있습니다.

중요: 파일 이름{agent-name}의는 참조용일 뿐입니다. 실제 에이전트 이름은 JSON 구성 파일 자체 내의 name 필드에 의해 결정되며, 이는 필수입니다.

사용자 지정 에이전트 우선 순위 및 충돌 해결

Amazon Q Developer CLI는 사용자 지정 에이전트를 찾을 때 특정 우선 순위 순서를 따릅니다.

  1. 로컬 사용자 지정 에이전트 먼저 - 현재 작업 디렉터리에서 사용자 지정 에이전트를 확인합니다.

  2. 글로벌 사용자 지정 에이전트 두 번째 - 홈 디렉터리의 사용자 지정 에이전트로 돌아갑니다.

  3. 기본 제공 - 사용자 지정 에이전트를 찾을 수 없는 경우 기본 에이전트를 사용합니다.

로컬 디렉터리와 글로벌 디렉터리 모두에 동일한 이름의 사용자 지정 에이전트가 포함된 경우 로컬 사용자 지정 에이전트가 우선합니다. 이 경우 Amazon Q Developer CLI에 경고 메시지가 표시됩니다.

WARNING: Agent conflict for my-agent. Using workspace version.

이 우선 순위 시스템을 사용하면 다음을 수행할 수 있습니다.

  • 프로젝트별 버전으로 글로벌 사용자 지정 에이전트 재정의

  • 사용자 지정 에이전트 수정을 전역적으로 만들기 전에 로컬에서 테스트

  • 다양한 프로젝트에 대해 다양한 사용자 지정 에이전트 구성 유지 관리

사용자 지정 에이전트 구성 모범 사례

글로벌 사용자 지정 에이전트를 사용해야 하는 경우

다음과 같은 경우 글로벌 사용자 지정 에이전트를 사용합니다.

  • 범용 워크플로 - 여러 프로젝트에서 사용되는 사용자 지정 에이전트

  • 개인 생산성 - 개별 작업 스타일에 맞는 사용자 지정 에이전트

  • 일반적인 개발 작업 - 코드 검토, 디버깅, 설명서 생성

  • 도구별 워크플로 - AWS 관리, Git 작업, Docker 워크플로

로컬 사용자 지정 에이전트를 사용해야 하는 경우

다음에 로컬 사용자 지정 에이전트를 사용합니다.

  • 프로젝트별 구성 - 특정 프로젝트 파일에 액세스해야 하는 사용자 지정 에이전트

  • 팀 공동 작업 - 버전 관리를 통해 공유되는 사용자 지정 에이전트

  • 개발 환경 - 특정 프로젝트에 대한 고유한 요구 사항이 있는 사용자 지정 에이전트

  • 테스트 및 실험 - 글로벌 설정에 영향을 주지 않는 임시 사용자 지정 에이전트 수정

사용자 지정 에이전트 이름 지정 규칙

더 나은 사용자 지정 에이전트 조직을 위해 다음 이름 지정 규칙을 고려하세요.

  • 용도 기반 이름 - aws-specialist.json, code-reviewer.json, documentation-writer.json

  • 기술별 이름 - python-dev.json, react-frontend.json, terraform-ops.json

  • 프로젝트별 이름 - project-alpha.json, mobile-app.json, api-backend.json

  • 환경별 이름 - development.json, staging.json, production.json

팀과 사용자 지정 에이전트 공유

버전 관리 시스템을 통해 로컬 사용자 지정 에이전트를 팀원과 공유할 수 있습니다. 이 접근 방식을 통해 팀은 다음을 수행할 수 있습니다.

  • 개발 환경 표준화 - 모든 팀원이 동일한 도구 및 구성에 액세스할 수 있도록 보장

  • 프로젝트별 컨텍스트 공유 - 프로젝트 설명서, 코딩 표준 및 사용자 지정 스크립트 포함

  • 일관성 유지 - 팀 전체에서 동일한 도구 권한 및 설정 사용

  • 개선 사항 협업 - 풀 요청을 사용하여 사용자 지정 에이전트 구성 검토 및 개선

버전 관리 모범 사례

버전 관리를 통해 사용자 지정 에이전트를 공유하는 경우:

  • 사용자 지정 에이전트 디렉터리 포함 - 리포지토리.aws/amazonq/agents/에 추가

  • 사용자 지정 에이전트 목적 문서화 - 사용자 지정 에이전트 구성 파일에서 명확한 설명 사용

  • 사용자 지정 에이전트 변경 사항 검토 - 코드 변경과 같은 사용자 지정 에이전트 구성 변경 사항 처리

  • 사용자 지정 에이전트 구성 테스트 - 공유된 사용자 지정 에이전트가 모든 팀원에 대해 올바르게 작동하는지 확인

  • 민감한 정보 방지 - 공유 사용자 지정 에이전트에 API 키, 암호 또는 개인 정보를 포함하지 마십시오.