기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon Q Developer를 사용한 기능 개발
Amazon Q Developer를 사용하면 코드 기능을 개발하거나 통합 개발 환경(IDE)의 프로젝트를 코드 변경할 수 있습니다. 수행하려는 작업을 설명하고 Amazon Q는 현재 프로젝트 또는 작업 영역의 컨텍스트를 사용하여 변경 사항을 구현하는 코드를 생성합니다. Amazon Q는 AWS 프로젝트 또는 자체 애플리케이션을 구축하는 데 도움이 될 수 있습니다.
완전히 새로운 프로젝트를 시작하거나 IDE에 열려 있는 프로젝트에서 작업할 수 있습니다. 기존 프로젝트에서 개발할 때 Amazon Q는 워크스페이스 루트의 모든 관련 파일을 컨텍스트로 사용하여 코드를 생성합니다. Amazon Q는 .gitignore
파일에 정의된 파일 또는 폴더를 필터링하고 지원되는 파일 유형만 사용하여 코드를 생성합니다. 지원되는 파일 유형 목록은 IDE에 대한 다음 GitHub 링크를 참조하세요.
-
JetBrains IDE에 지원되는 파일 유형 - https://github.com/aws/aws-toolkit-jetbrains/blob/main/plugins/core/jetbrains-community/src/software/aws/toolkits/jetbrains/services/telemetry/TelemetryUtils.kt
-
Visual Studio Code에 지원되는 파일 유형 - https://github.com/aws/aws-toolkit-vscode/blob/master/packages/core/src/shared/filetypes.ts
시작하려면 새 프로젝트 또는 기존 프로젝트를 열고 Amazon Q 채팅 패널에서 /dev
를 입력합니다. Amazon Q와 상호 작용하여 기능에 대한 새 코드를 생성하는 새 채팅 탭이 열립니다.
주제
/dev
를 사용하여 기능 개발
IDE에서 Amazon Q로 코드 작업을 수행하려면 다음 단계를 완료하세요.
-
IDE에서 기능을 개발하려는 새 프로젝트 또는 기존 프로젝트 또는 작업 영역을 엽니다.
-
Amazon Q 아이콘을 선택하여 Amazon Q 채팅 패널을 엽니다.
-
Amazon Q 채팅 패널에
/dev
를 입력한 다음 수행하려는 작업 또는 해결하려는 문제에 대한 설명을 입력합니다. 작업에 대한 간략한 개요를 제공하거나 세부 정보를 추가할 수 있습니다. Amazon Q는 설명과 프로젝트의 코드를 사용하여 코드를 생성합니다.다음은 Amazon Q에 구현을 요청할 수 있는 코드 변경의 예입니다.
/dev Create a new REST API endpoint /api/authenticate to handle user authentication. This endpoint should accept POST requests with user credentials and return a JWT token upon successful authentication. Additionally, update the user management system to integrate with the new authentication endpoint and enforce authentication for relevant API endpoints.
/dev
만 입력하여 예제 작업을 볼 수도 있습니다. -
새 탭이 열립니다. 아직 입력하지 않은 경우 작업 또는 문제에 대한 설명을 입력합니다.
-
Amazon Q는 설명한 작업에 대한 코드를 생성하기 시작합니다. 코드 생성 중에 Amazon Q는 수행 중인 단계와 새 코드를 제안하기 위해 사용 또는 업데이트 중인 파일에 대한 요약을 제공합니다. 이 단계는 몇 분 정도 소요될 수 있습니다.
Amazon Q가 코드 생성을 중지하도록 하려면 중지를 선택합니다. 불완전한 코드 생성은이 작업의 코드 생성 할당량에 포함됩니다. 생성을 중지한 후 다른 작업 설명을 입력하여 작업을 계속할 수 있습니다.
선택적으로 Amazon Q는 채팅 창에서 코드를 제시하기 전에 별도의 개발 환경에서 코드 제안을 테스트할 수 있습니다. 자세한 내용은 '/dev' 제안 테스트 단원을 참조하십시오.
-
Amazon Q가 작업에 대한 코드를 생성한 후 제안된 변경 사항이 포함된 파일 목록을 제공합니다. 변경 사항과 함께 diff 파일을 보려면 파일을 선택합니다.
-
제안된 모든 코드 변경 사항으로 파일을 업데이트하려면 모든 변경 사항 수락을 선택합니다. 개별 파일의 변경 사항을 수락하고 거부할 수도 있습니다. 개별 파일 변경을 수락하려면 파일 이름 위에 커서를 놓고 녹색 확인 표시를 선택합니다. 변경을 거부하려면 빨간색 X를 선택합니다. 나머지 변경 사항 수락을 선택하여 아직 수락하지 않은 변경 사항을 적용할 수도 있습니다.
코드 변경을 수락한 후에는 실행 취소할 수 없습니다. 코드 변경을 거부하는 경우 파일 이름 위로 마우스를 가져가 화살표를 선택하여 되돌릴 수 있습니다. 그런 다음 코드 변경을 다시 수락하거나 거부할 수 있습니다.
-
제안된 변경 사항에 만족하지 않는 경우 개선할 수 있는 사항에 대한 피드백을 제공할 수 있습니다. 피드백 제공 및 재생성을 선택한 다음 Amazon Q에서 변경하려는 사항을 설명합니다.
Amazon Q는 피드백을 기반으로 새 코드를 생성합니다. 생성된 코드가 요구 사항을 충족하면 모든 변경 사항 수락 또는 개별 파일 수락을 선택하여 프로젝트 또는 워크스페이스의 코드를 업데이트합니다.
-
코드를 업데이트한 후 Amazon Q는 새 작업을 시작하라는 메시지를 표시합니다.
프로젝트 또는 작업 영역에서 다른 작업을 시작하려면 예, 다른 작업이 있습니다를 선택합니다. 이전 대화와 생성된 코드는 새 작업의 컨텍스트로 사용되지 않습니다.
기능 개발 세션을 종료하려면 아니요, 감사합니다를 선택합니다. Amazon Q와 채팅을 계속하거나 다른 워크플로를 시작하려면 새 채팅 탭을 엽니다.
모범 사례
Amazon Q에서 기능 개발을 최대한 활용하려면 다음 모범 사례를 따르세요.
-
코드가 달성해야 하는 세부 사항을 포함하여, 변경하려는 새 기능 또는 코드 변경 사항에 대한 자세한 설명을 제공합니다. 이를 통해 Amazon Q는 포괄적이고 구현 가능한 코드 변경을 제안할 수 있습니다. 예시는 예시 작업 섹션을 참조하세요.
-
기능은 한 번에 5개 이상의 파일을 업데이트할 필요가 없습니다. Amazon Q에 더 큰 변경을 요청하면 기능 구현의 품질과 관리 가능성에 영향을 미칠 수 있습니다. 파일 차이에 여러 파일의 변경 사항이 포함된 경우 기능 설명의 범위를 줄이세요.
예시 작업
다음은 Amazon Q에 수행할 것을 요청할 수 있는 기능 개발 작업의 예이며, 제공할 수 있는 해당 설명이 나와 있습니다.
-
응답형 레이아웃을 위한 CSS 스타일 업데이트: CSS 스타일을 업데이트하여 애플리케이션 레이아웃의 응답성을 개선합니다. 다양한 화면 크기에 맞게 레이아웃을 조정하여 다양한 장치에서 최적의 디스플레이를 보장하는 데 중점을 둡니다.
-
사용자 프로필 이미지 업로드 수정: 사용자가 프로필 이미지를 업로드하지 못하는 문제를 해결합니다. 파일 업로드 프로세스를 조사하고, 적절한 파일 형식 검증을 확인하고, 성공적인 업로드를 방해하는 서버 측 오류를 해결합니다.
-
코드 가독성을 위한 코드 리팩터링: 리팩터링을 통해 특정 코드 모듈의 가독성을 개선합니다. 복잡한 함수를 더 작고 관리 가능한 단위로 나누고 의미 있는 변수 및 함수 이름을 적용하여 명확성을 높입니다.
-
연락처 양식에 대한 입력 유효성 검사 구현: 연락처 양식에 클라이언트 측 및 서버 측 입력 유효성 검사를 추가하여 비어 있거나 유효하지 않은 데이터가 제출되지 않도록 합니다. 유효성 검사 실패 시 사용자에게 적절한 오류 메시지를 표시합니다.
-
탐색 메뉴의 중단된 링크 해결: 애플리케이션의 탐색 메뉴에서 중단된 링크를 조사하고 수정합니다. URL 또는 경로를 업데이트하여 모든 탐색 링크가 올바른 페이지로 연결되도록 합니다.
-
더 빠른 페이지 로드를 위한 이미지 로딩 최적화: 애플리케이션의 주요 페이지에서 이미지 로딩을 최적화하여 페이지 로드 시간을 줄입니다. 지연 로딩 또는 비동기 로딩 기술을 구현하여 표시되는 콘텐츠의 우선 순위를 지정합니다.
-
중요 API 엔드포인트에 대한 오류 로깅 추가: 중요 API 엔드포인트에 대한 로깅을 구현하여 오류 처리를 개선합니다. 요청 파라미터 및 스택 추적과 같은 관련 오류 세부 정보를 로깅하여 디버깅 및 문제 해결을 용이하게 합니다.
-
API 엔드포인트에 대한 설명서 업데이트: 최신 변경 사항 또는 추가 사항을 반영하도록 기존 API 엔드포인트에 대한 설명서를 검토하고 업데이트합니다. API를 사용하는 개발자를 위해 정보의 정확성과 완전성을 보장합니다.
-
효율성을 위한 데이터베이스 쿼리 리팩터링: 효율성을 개선하고 리소스 소비를 줄이기 위해 데이터베이스 쿼리를 분석하고 최적화합니다. 중복 쿼리를 식별 및 제거하고, 인덱싱을 최적화하고, 해당하는 경우 캐싱 전략을 고려합니다.
할당량
Amazon Q를 사용한 기능 개발은 다음 할당량을 유지합니다.
-
작업당 코드 생성 - 초기 코드 생성을 포함하여 지정된 개발 작업에 대한 코드를 재생성하기 위해 피드백을 제공할 수 있는 횟수입니다. 이 할당량은 새 작업을 시작할 때마다 재설정됩니다.
-
코드 프로젝트 크기 - Amazon Q가 새 코드를 생성하기 위해 컨텍스트로 사용할 수 있는 코드 파일 또는 폴더의 최대 크기입니다.
리소스 | 할당량 |
---|---|
작업당 코드 생성 수 | 10 |
코드 프로젝트 크기 | 200MB 비압축 50MB 압축 |