기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
컨텍스트 후크 사용
컨텍스트 후크는 Amazon Q Developer CLI의 기능으로, Q Developer와의 대화에 컨텍스트를 자동으로 삽입하는 데 사용할 수 있습니다. /context 명령으로 컨텍스트를 수동으로 추가하는 대신 컨텍스트 후크는 명령을 실행하고 출력을 컨텍스트로 포함합니다.
컨텍스트 후크 유형
Q Developer CLI는 두 가지 유형의 컨텍스트 후크를 지원합니다.
- 대화 시작 후크
-
대화를 시작할 때 한 번 실행합니다. 출력은 대화 컨텍스트에 추가되며 세션 내내 유지됩니다.
- 프롬프트별 후크
-
각 사용자 메시지로를 실행합니다. 출력은 현재 프롬프트에만 추가됩니다.
컨텍스트 후크 관리
Q Developer CLI의 /context hooks 명령을 사용하여 컨텍스트 후크를 관리할 수 있습니다.
후크 보기
글로벌 및 프로필 수준 모두에서 구성된 모든 후크를 보려면:
/context hooks
이 명령은 현재 프로필 및 글로벌 수준에 대해 구성된 모든 후크를 상태(활성화됨 또는 비활성화됨)와 함께 표시합니다.
후크 추가
새 컨텍스트 후크를 추가하려면:
/context hooks add [--global] <name> --trigger <trigger> --command <command>
- <이름>
-
후크의 고유 이름
- <트리거>
-
per_prompt또는conversation_start - <명령>
-
실행할 shell 명령
- --글로벌
-
(선택 사항) 현재 프로파일 대신 글로벌 구성에 후크 추가
예 git 상태 후크 추가
/context hooks add git-status --trigger per_prompt --command "git status --short"
후크 제거
기존 컨텍스트 후크를 제거하려면:
/context hooks rm <name> [--global]
후크 활성화 또는 비활성화
특정 후크를 활성화하려면:
/context hooks enable [--global] <name>
특정 후크를 비활성화하려면:
/context hooks disable [--global] <name>
모든 후크를 활성화하려면:
/context hooks enable-all [--global]
모든 후크를 비활성화하려면:
/context hooks disable-all [--global]
후크에 대한 도움말 보기
후크 명령에 대한 자세한 도움말을 표시하려면:
/context hooks help
구성
다음 위치에서 후크의 구성을 확인할 수 있습니다.
후크가 전역인 경우:
~/.aws/amazonq/global_context.json
후크가 프로파일 기반인 경우:
~/.aws/amazonq/profiles/profile-name/context.json
사용 사례 예제
다음 예제에서는 컨텍스트 후크의 일반적인 사용 사례를 보여줍니다.
Git 상태
후크를 추가하여 각 프롬프트와 함께 git 상태를 표시합니다.
/context hooks add git-status --trigger per_prompt --command "git status --short"
이 후크는 각 프롬프트 앞에 git status --short 명령을 실행하고 Q Developer와의 대화에 출력을 포함합니다. 이렇게 하면 버전 관리에 대해 질문하거나 git 명령에 도움이 필요할 때 Q Developer가 git 리포지토리의 현재 상태를 이해하는 데 도움이 됩니다.
프로젝트 정보
후크를 추가하여 대화 시작 시 프로젝트 정보를 표시합니다.
/context hooks add project-info --trigger conversation_start --command "echo 'Project: '$(basename $(pwd))"
이 후크는 대화 시작 시 한 번 실행되며 컨텍스트에 현재 프로젝트 이름을 포함합니다. 이렇게 하면 Q Developer가 프로젝트와 관련된 보다 관련성이 높은 응답을 제공하는 데 도움이 됩니다.
작은 정보
이 후크를 확장하여 프로그래밍 언어, 프레임워크 또는 프로젝트 구조와 같은 더 많은 프로젝트 정보를 포함할 수 있습니다.
동작 및 제한 사항
컨텍스트 후크를 사용할 때는 다음 동작과 제한 사항에 유의하세요.
-
후크는 병렬로 실행되어 응답 시간에 미치는 영향을 최소화합니다.
-
후크 출력은 형식이 지정되고 컨텍스트에 명확하게 표시됩니다.
-
/clear명령은 대화 시작 후크를 재평가합니다. -
후크는 Q Developer CLI 구성에 저장됩니다.
-
현재 인라인 명령 후크만 지원됩니다.
-
후크 출력은 후크당 10KB로 제한됩니다.
-
기본적으로 5초 후 후크 제한 시간
보안 고려 사항
컨텍스트 후크를 사용하는 경우 다음 보안 모범 사례를 고려하세요.
-
컨텍스트 후크는 현재 사용자 권한으로 셸 명령을 실행합니다. 후크에 포함하는 명령은 사용자 계정과 액세스 권한이 동일하므로 주의해야 합니다.
-
자격 증명 또는 개인 데이터와 같은 민감한 정보를 노출할 수 있는 후크를 추가할 때는 주의해야 합니다. 후크의 출력을 검토하여 공유하지 않으려는 정보가 포함되지 않았는지 확인합니다.
-
후크가 필요하지 않은 경우 비활성화하는 것이 좋습니다. 이렇게 하면 민감한 정보가 실수로 노출될 위험이 줄어듭니다.
-
후크를 사용하여 시스템 또는 데이터를 수정할 수 있는 명령을 실행하지 마십시오. 후크는 변경하지 않고 정보를 읽는 데 사용해야 합니다.
-
공유 환경에서 후크를 사용할 때는 주의해야 합니다. 다른 사용자가 Q Developer CLI 세션에 액세스할 수 있는 경우 후크의 출력을 볼 수 있습니다.
주의
후크에 암호, 액세스 키 또는 기타 자격 증명을 노출하는 명령을 포함하지 마십시오. 이 정보는 대화 기록에 저장되어 잠재적으로 다른 사람에게 노출될 수 있습니다.
문제 해결
컨텍스트 후크에 문제가 발생하면 다음 해결 방법을 시도해 보세요.
| 문제 | Solution |
|---|---|
| 후크가 실행되지 않음 | 에서 후크가 활성화되어 있는지 확인 /context hooks |
| 명령 실패 | 터미널에서 직접 명령을 테스트하여 작동하는지 확인합니다. |
| 출력이 너무 큼 | 출력 크기를 제한하도록 명령 수정 |
| 후크 시간 초과 | 더 빠른 실행을 위해 명령 최적화 |
