실험 기능 - Amazon Q Developer
실험 기능 관리지식 관리탄젠트 모드체크포인트컨텍스트 사용률DelegateTODO 목록향상된 사고 모드설정 통합추가 리소스

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

실험 기능

Amazon Q Developer CLI에는 생산성 향상을 위한 고급 기능을 제공하는 실험 기능이 있습니다. 이러한 기능은 아직 개발 중이므로 사용하기 전에 명시적으로 활성화해야 합니다.

중요

실험 기능은 언제든지 변경 또는 제거될 수 있습니다. 프로덕션 워크플로에서 원하는대로 사용하세요.

실험 기능 관리

/experiment 명령을 사용하여 실험 기능을 보고 전환합니다.

/experiment

그러면 다음과 같은 대화형 메뉴가 표시됩니다.

  • 각 실험의 현재 상태 보기(켜기/끄기)

  • 실험을 선택하여 전환

  • 각 실험이 수행하는 작업에 대한 설명 보기

지식 관리

지식 관리 기능은 채팅 세션 전반에 걸쳐 지속적인 컨텍스트 저장 및 검색을 제공합니다. 다음을 사용하여 활성화합니다.

q settings chat.enableKnowledge true

기본 사용법

활성화되면 채팅 세션 내에서 /knowledge 명령을 사용합니다.

/knowledge add <name> <path>

지식 기반에 파일 또는 디렉터리 추가

/knowledge show

지식 기반의 모든 항목 표시

/knowledge remove <identifier>

이름, 경로 또는 컨텍스트 ID로 항목 제거

/knowledge update <path>

기존 지식 기반 항목을 새 콘텐츠로 업데이트

/knowledge clear

지식 기반에서 모든 항목 제거(확인 필요)

/knowledge status

백그라운드 인덱싱 작업의 상태 보기

인덱스 유형

콘텐츠를 추가할 때 두 가지 인덱싱 접근 방식 중에서 선택합니다.

빠름(--index-type Fast)

BM25를 사용해 어휘를 검색합니다. 인덱싱 및 인스턴트 키워드 기반 검색이 매우 빠릅니다. 로그, 구성 및 대규모 코드베이스에 적합합니다.

최적(--index-type Best)

AI 임베딩을 사용해 의미 체계를 검색합니다. 컨텍스트와 의미를 이해하는 지능형 검색입니다. 문서화 및 연구에 적합합니다.

사용 예:

/knowledge add "project-docs" /path/to/docs --index-type Best
/knowledge add "log-files" /path/to/logs --index-type Fast

에이전트별 지식 기반

각 에이전트는 자체 격리된 지식 기반을 유지하여 작업 중인 특정 에이전트로 지식 컨텍스트 범위가 지정되도록 합니다. 에이전트 간에 전환하면 지식 명령이 해당 에이전트의 특정 지식 기반에서 자동으로 작동합니다.

탄젠트 모드

탄젠트 모드는 대화 체크포인트를 생성하므로 주요 대화 흐름을 방해하지 않고 부가 주제를 탐색할 수 있습니다. 다음을 사용하여 활성화합니다.

q settings chat.enableTangentMode true

탄젠트 모드 사용

활성화하면 /tangent 또는 Ctrl+T를 사용하여 탄젠트 모드를 전환합니다.

  1. 탄젠트 모드 시작: 대화 체크포인트를 생성합니다.

    /tangent
Created a conversation checkpoint (↯). Use ctrl + t or /tangent to restore the conversation later.

  2. 탄젠트 모드: 프롬프트에 노란색 ↯ 기호가 표시됩니다.

    ↯ > What is the difference between async and sync functions?

  3. 탄젠트 모드 종료: 기본 대화로 돌아갑니다.

    ↯ > /tangent
Restored conversation from checkpoint (↯). - Returned to main conversation.

모범 사례

다음과 같은 경우 탄젠트 모드를 사용합니다.

  • 현재 주제에 대해 명확하게 질문하기

  • 결정을 내리기 전에 대체 접근 방식 탐색

  • Q Developer CLI 명령 또는 기능에 대한 도움말 보기

  • 개념에 대한 이해 테스트

전혀 관련이 없는 주제나 길고 복잡한 토론에는 탄젠트 모드를 사용하지 마세요.

체크포인트

체크포인트를 사용하면 Git CLI 명령을 사용하여 파일 변경 사항을 추적하기 위한 세션 범위의 스냅샷이 활성화됩니다. 이 기능은 채팅 세션 전체에서 파일 상태를 관리하는 섀도우 베어 git 리포지토리를 생성합니다.

다음을 사용하여 체크포인트 활성화:

q settings chat.enableCheckpoint true

Features

  • 섀도우 베어 git 리포지토리로 파일 변경 사항 스냅샷

  • 체크포인트 나열, 확장, 차이 및 복원

  • 체크포인트를 복원할 때 대화 기록이 풀림

  • git 리포지토리에서 자동 활성화(임시, 세션 종료 시 정리됨)

  • 비 Git 디렉터리에 수동 초기화 사용 가능

기본 사용법

활성화되면 채팅 세션 내에서 /checkpoint 명령을 사용합니다.

/체크포인트 초기화

체크포인트 수동 활성화(git 리포지토리에 없는 경우 필수)

/체크포인트 목록 [--limit N]

파일 통계가 포함된 턴 수준 체크포인트 표시

/checkpoint 확장 <tag>

특정 턴으로 도구 수준 체크포인트 표시

/체크포인트 차이 <tag1> [tag2|HEAD]

체크포인트 비교 또는 현재 상태와 비교

/체크포인트 복원 [<tag>] [--hard]

체크포인트로 복원(지정된 태그가 없는 경우 대화형 선택기 표시)

/체크포인트 정리

세션 섀도우 리포지토리 삭제

복원 옵션

기본 복원 동작:

  • 추적된 변경 사항 및 삭제를 되돌립니다.

  • 체크포인트 이후에 생성된 파일을 유지합니다.

하드 복원(--hard 플래그):

  • 워크스페이스가 체크포인트 상태와 정확히 일치하도록 합니다.

  • 체크포인트 이후에 생성된 추적 파일을 삭제합니다.

중요

체크포인트 지정은 세션이 종료될 때 정리되는 임시 git 리포지토리를 생성합니다. 파일을 영구적으로 삭제하므로 --hard 복원 시 주의해야 합니다.

컨텍스트 사용률

컨텍스트 사용률은 채팅 프롬프트에 현재 컨텍스트 창 사용률을 백분율로 표시하므로 사용 가능한 컨텍스트 창이 얼마나 사용되고 있는지 모니터링할 수 있습니다.

다음을 사용하여 컨텍스트 사용률을 활성화합니다.

q settings chat.enableContextUsageIndicator true

Features

  • 프롬프트에 사용되는 컨텍스트 기간의 백분율을 표시합니다(예: "[rust-agent] 6% >").

  • 빠른 시각적 참조를 위한 색상으로 구분된 표시기

  • 긴 대화 중에 컨텍스트 창 소비를 모니터링하는 데 도움이 됩니다.

시각적 지표

백분율 표시는 색상 코딩을 사용하여 사용 수준을 나타냅니다.

녹색: 사용량이 50% 미만

사용 가능한 컨텍스트 공간이 많은 정상 작업

노란색: 50~89% 사용량

중간 수준의 사용량, 컨텍스트 관리 고려

빨간색: 90~100% 사용량

사용량이 많고 컨텍스트 기간이 거의 가득 참

Delegate

위임을 사용하면 비동기 작업 프로세스를 시작하고 관리할 수 있으므로 기본 대화와 동시에 특정 에이전트와 Amazon Q 채팅 세션을 실행할 수 있습니다.

다음을 사용하여 위임 활성화:

q settings chat.enableDelegate true

Features

  • 자연어를 사용하여 백그라운드 작업 시작

  • 특정 에이전트와 병렬 Amazon Q 채팅 세션 실행

  • 작업 진행 상황을 독립적으로 모니터링

  • 보안 작업 실행을 위한 에이전트 승인 흐름

사용법

자연어를 사용하여 모델에 백그라운드 작업을 시작하도록 요청합니다.

Can you create a background task to analyze the performance of our API endpoints?

작업이 준비되면 결과를 확인합니다.

Check the status of my API analysis task
Show me the results from the background analysis

에이전트 승인 흐름

에이전트가 있는 작업: 실행 전에 명시적 승인이 필요하고 에이전트 세부 정보를 표시합니다.

에이전트가 없는 작업: trust-all 권한에 대한 경고와 함께 실행

위임되면 작업이 독립적으로 작동하며 다음을 수행할 수 있습니다.

  • 언제든지 진행 상황 확인

  • 완료되면 결과 읽기

  • 더 이상 필요하지 않은 경우 작업 삭제

중요

위임 작업은 승격된 권한으로 실행됩니다. 작업 실행을 승인하기 전에 에이전트 세부 정보를 주의 깊게 검토합니다.

TODO 목록

TODO 목록을 사용하면 Amazon Q가 작업 목록을 자동으로 생성하고 수정하는 동시에 기존 TODO 목록을 보고 관리하는 명령을 제공할 수 있습니다.

다음을 사용하여 TODO 목록을 활성화합니다.

q settings chat.enableTodoList true

Features

  • Amazon Q는 적절한 경우 또는 요청 시 TODO 목록을 자동으로 생성합니다.

  • /todos 명령을 사용하여 TODOs 보기, 관리 및 삭제

  • 에 저장된 기존 TODO 목록 재개 .amazonq/cli-todo-lists

  • 채팅 세션 간 영구 스토리지

기본 사용법

활성화되면 Amazon Q는 대화 중에 TODO 목록을 자동으로 생성합니다. /todos 명령을 사용하여 관리합니다.

/todos 클리어 완료

작업 디렉터리에서 완료된 TODOs 삭제

/todos 재개

기존 TODO 목록 선택 및 재개

/todos 보기

기존 TODO 목록 선택 및 보기

/todos 삭제

기존 TODO 목록 선택 및 삭제

워크플로 통합

Amazon Q는 다음과 같은 경우 TODO 목록을 생성합니다.

  • 작업 분석을 요청합니다.

  • 복잡한 다단계 프로세스 설명

  • 프로젝트 계획 대화 발생

  • TODO 목록을 명시적으로 요청합니다.

TODO 목록은 채팅 세션에 자동으로 저장.amazonq/cli-todo-lists되고 지속되므로 장기 프로젝트 작업을 재개할 수 있습니다.

향상된 사고 모드

사고 모드를 사용하면 step-by-step 사고 프로세스를 통해 복잡한 추론을 수행할 수 있으므로 Amazon Q의 의사 결정 프로세스에 투명성을 제공할 수 있습니다.

다음을 사용하여 사고 모드를 활성화합니다.

q settings chat.enableThinking true

Features

  • 복잡한 문제에 대한 AI 추론 프로세스를 보여줍니다.

  • 다Step-by-step 사고 프로세스

  • 결론에 도달하는 방법을 이해하는 데 도움이 됩니다.

  • 디버깅 및 학습에 유용

  • 복잡한 작업에 대한 투명한 의사 결정

사용해야 하는 경우

사고 모드는 다음과 같은 경우에 특히 유용합니다.

  • 복잡한 문제 해결: 솔루션의 근거 이해

  • 디버깅 지원: 문제 해결을 위한 분석 프로세스 확인

  • 학습 시나리오: 개념이 서로 연결하고 구축하는 방법 이해

  • 다단계 워크플로: 복잡한 절차를 통해 로직 따르기

설정 통합

모든 실험 기능은 Amazon Q CLI 설정 시스템과 통합되며 세션 간에 유지됩니다. 다음을 통해 실험을 관리할 수 있습니다.

대화형 실험 메뉴:

/experiment

직접 설정 명령:

q settings chat.enableCheckpoint true
q settings chat.enableContextUsageIndicator true
q settings chat.enableKnowledge true
q settings chat.enableTangentMode true
q settings chat.enableThinking true
q settings chat.enableDelegate true
q settings chat.enableTodoList true

모든 실험 명령은 퍼지 검색(Ctrl+S)을 통해 사용할 수 있습니다.

  • /experiment - 실험 기능 관리

  • /knowledge - 지식 기반 명령(활성화된 경우)

  • /checkpoint - 체크포인트 명령(활성화된 경우)

  • /todos - TODO 목록 명령(활성화된 경우)

  • /tangent - 접선 모드 토글(활성화된 경우)

이 통합을 통해 실험 기능을 쉽게 검색하고 워크플로 중에 액세스할 수 있습니다.

추가 리소스

고급 구성 옵션 및 문제 해결을 포함한 실험 기능에 대한 자세한 내용은 추가 Amazon Q Developer CLI 설명서를 참조하세요.