컨텍스트 관리

컨텍스트 관리

컨텍스트 파일에는 Amazon Q가 대화 중에 고려할 정보가 포함되어 있습니다. 여기에는 프로젝트 요구 사항, 코딩 표준, 개발 규칙 또는 Amazon Q가 보다 관련성이 높은 응답을 제공하는 데 도움이 되는 기타 정보가 포함될 수 있습니다.

컨텍스트를 구성하는 방법에는 두 가지가 있습니다.

• 에이전트 리소스(권장): 에이전트 구성 파일에 정의된 영구 컨텍스트

• 세션 컨텍스트: /context 명령을 사용하여 채팅 세션 중에 추가된 임시 컨텍스트

에이전트 리소스를 사용하여 영구 컨텍스트 구성

컨텍스트를 구성하는 권장 방법은 에이전트 구성 파일의 resources 필드를 사용하는 것입니다. 이렇게 하면 에이전트를 사용할 때마다 사용할 수 있는 영구 컨텍스트가 생성됩니다.

에이전트 구성의 resources 배열에 파일 경로 또는 glob 패턴을 추가합니다.

{
  "name": "my-agent",
  "description": "My development agent",
  "resources": [
    "file://README.md",
    "file://.amazonq/rules/**/*.md",
    "file://docs/**/*.md",
    "file://src/config.py"
  ]
}

컨텍스트 파일로 포함file://하려면 리소스 앞에 접두사를 붙여야 합니다. 이러한 파일은이 에이전트를 사용하는 모든 채팅 세션에서 자동으로 사용할 수 있습니다.

임시 세션 컨텍스트 추가

/context add 명령을 사용하여 현재 채팅 세션에 파일을 일시적으로 추가할 수 있습니다. 이러한 추가 사항은 현재 세션에서만 사용할 수 있으며 새 채팅 세션을 시작할 때 지속되지 않습니다.

q chat
> /context add README.md
Added 1 path(s) to context.
Note: Context modifications via slash command is temporary.

glob 패턴을 사용하여 한 번에 여러 파일을 추가할 수도 있습니다.

q chat
> /context add docs/*.md
Added 3 path(s) to context.
Note: Context modifications via slash command is temporary.

컨텍스트를 영구적으로 변경하려면 대신 에이전트의 resources 필드에 파일을 추가합니다.

컨텍스트 보기

현재 컨텍스트를 보려면 /context show 명령을 사용합니다.

q chat
> /context show
👤 Agent (my-agent):
    README.md (1 match)
    .amazonq/rules/**/*.md (3 matches)
    docs/**/*.md (5 matches)

💬 Session (temporary):
    <none>

5 matched files in use:
👤 README.md (~250 tkns)
👤 .amazonq/rules/security.md (~180 tkns)
👤 .amazonq/rules/coding-standards.md (~320 tkns)
👤 docs/architecture.md (~150 tkns)
👤 docs/best-practices.md (~200 tkns)

Total: ~1100 tokens

출력에는 다음이 표시됩니다.

• 👤 에이전트: 에이전트 resources 필드의 영구 컨텍스트

• 💬 세션: 현재 세션 중에 임시 컨텍스트가 추가됨

컨텍스트 제거

현재 세션 컨텍스트에서 파일을 제거하려면 /context rm 명령을 사용합니다.

q chat
> /context rm src/temp-file.py
Removed 1 path(s) from context.
Note: Context modifications via slash command is temporary.

모든 세션 컨텍스트를 지우려면 /context clear 명령을 사용합니다.

q chat
> /context clear
Cleared context
Note: Context modifications via slash command is temporary.

참고: /context 명령을 사용하여 에이전트 정의 컨텍스트를 제거할 수 없습니다. 컨텍스트를 영구적으로 제거하려면 에이전트의 resources 필드를 편집합니다.

일반 사용 사례

다음은 컨텍스트 관리를 위한 몇 가지 일반적인 사용 사례입니다.

프로젝트 규칙 사용

Amazon Q는 보안 지침 및 제한을 정의할 수 있는 프로젝트 수준 규칙을 지원합니다. 이러한 규칙은 프로젝트 .amazonq/rules 디렉터리의 마크다운 파일에 정의되어 있습니다.

예를 들어 다음을 지정하는 규칙을 생성할 수 있습니다.

• Amazon Q가 액세스하지 않아야 하는 디렉터리

• 생성된 코드에 대한 보안 요구 사항

• 코딩 표준 및 모범 사례

프로젝트 규칙을 포함하는 권장 방법은 에이전트 구성을 사용하는 것입니다.

{
  "name": "my-project-agent",
  "resources": [
    "file://.amazonq/rules/**/*.md",
    "file://README.md",
    "file://docs/architecture.md"
  ]
}

현재 세션에 프로젝트 규칙을 일시적으로 추가할 수도 있습니다.

q chat
> /context add .amazonq/rules/*.md
Added 3 path(s) to context.
Note: Context modifications via slash command is temporary.

프로젝트 규칙 생성 및 사용에 대한 자세한 내용은 IDE 설명서의 Amazon Q Developer 채팅에 사용할 프로젝트 규칙 생성을 참조하세요.

세션 컨텍스트에서 에이전트 리소스로 마이그레이션

/context add 명령을 사용하여 동일한 컨텍스트 파일을 반복적으로 추가하는 경우 지속성을 위해 에이전트의 resources 필드로 이동하는 것이 좋습니다.

1. 자주 추가하는 파일을 기록해 둡니다. /context add

2. 에이전트 구성 파일 편집

3. file:// 접두사가 있는 resources 배열에 파일 경로 추가

4. 에이전트 구성 저장

마이그레이션 예제:

# Instead of running these commands every session:
> /context add README.md
> /context add docs/*.md
> /context add .amazonq/rules/*.md

# Add them to your agent config once:
{
  "resources": [
    "file://README.md",
    "file://docs/**/*.md", 
    "file://.amazonq/rules/**/*.md"
  ]
}