에이전트 지침

에이전트 지침을 사용하여 AWS DevOps 에이전트가 모든 세션에 적용하는 상시 작동 지침을 제공합니다. 세션은 에이전트와의 단일 대화 또는 조사입니다. 에이전트 스페이스 운영자 웹 앱의 에이전트 페이지에서 모든 에이전트에 적용되는 글로벌 지침을 설정하거나 채팅 또는 인시던트 분류와 같은 특정 관리형 에이전트에 대한 지침을 설정할 수 있습니다. 이 지침은 AGENTS.md 파일로 저장됩니다. 에이전트가 스킬 설명을 현재 작업과 일치시킬 때 온디맨드로 로드DevOps 에이전트 기술되는와 달리 에이전트 지침은 에이전트가 작업하는 대상에 관계없이 모든 세션이 시작될 때 항상 표시됩니다.

에이전트 지침이란 무엇입니까?

에이전트 지침은 에이전트를 위한 무조건적인 상시 작동 지침을 제공합니다. 모든 세션이 시작될 때 에이전트 서비스는 에이전트 스페이스에 대해 구성된 지침을 검색하고 에이전트 시스템 프롬프트에 콘텐츠를 직접 주입합니다. 에이전트는 로드 여부를 결정하지 않으며 항상 존재합니다.

각 에이전트 세션은 채팅과 같은 글로벌 지침과 관련 에이전트별 지침으로부터 지침을 받습니다.

에이전트 지침은 AGENTS.md 파일로 저장되며 다음과 같은 DevOps 에이전트 기술 몇 가지 중요한 면에서와 다릅니다.

속성	스킬	에이전트 지침(AGENTS.md)
이름 및 설명	필수	해당 사항 없음
콘텐츠 형식	마크다운 또는 ZIP 번들	마크다운만
리소스 파일	지원됨	지원되지 않음
컨텍스트 삽입	온디맨드(에이전트가 스킬 설명 일치를 통해 결정)	항상(무조건, 모든 세션)
Uniqueness	에이전트 스페이스당 배수	에이전트당 1개(글로벌 지침용 1개, 관리형 에이전트당 1개)

에이전트 지침에는 이름이나 설명 필드가 없습니다. 기본 AGENTS.md 파일에는 프론트미터, ZIP 번들 지원 및 리소스 파일이 없는 마크다운만 포함되어 있습니다.

에이전트 지침을 사용하는 이유

에이전트 지침은 에이전트의 스킬 로드 결정에 의존하지 않고 특정 지침이 항상 컨텍스트에 있도록 하는 신뢰할 수 있는 방법을 제공합니다.

주요 이점:

• 예측성: 에이전트가 작업하는 작업에 관계없이 지침이 항상 존재합니다. 설명 일치는 필요하지 않으며 에이전트는 콘텐츠를 건너뛸 수 없습니다.

• 보장된 적용 범위: 에이전트가 작업 관련성에 따라 로드하거나 로드하지 않을 수 있는 스킬과 달리 에이전트 지침은 항상 모든 세션이 시작될 때 주입됩니다.

• 표준 정책: 에이전트 지침을 사용하여 운영 정책, 보안 지침, 코딩 표준 또는 예외 없이 모든 세션에 적용해야 하는 지침을 유지합니다.

• 대상 범위: 전역 지침을 사용하여 모든 에이전트 유형에 지침을 한 번에 적용하거나 지침이 해당 에이전트의 작업에만 관련된 경우 특정 에이전트 유형으로 지침을 제한할 수 있습니다.

에이전트 지침 작동 방식

세션이 시작되면 에이전트 서비스는 에이전트 스페이스에 대해 구성된 지침을 검색하고 세션이 시작되기 전에 에이전트 시스템 프롬프트에 콘텐츠를 주입합니다. 이는 모든 세션에서 자동으로 발생합니다. 에이전트는 로드 여부를 평가하지 않으며 항상 콘텐츠를 주입합니다.

각 새 세션은 시작 시 지침을 새로 로드합니다. 지침을 업데이트하면 저장 후 시작되는 세션에 변경 사항이 즉시 적용됩니다. 이미 진행 중인 세션은 시작할 때 로드된 콘텐츠를 계속 사용합니다.

범위 지정은 세션이 수신하는 지침을 결정합니다. 글로벌 지침은 에이전트 스페이스의 모든 에이전트 유형에 적용되므로 모든 세션에서 이를 수신합니다. 에이전트별 지침은 해당 특정 에이전트 유형의 세션에만 적용됩니다. 세션은 글로벌 지침과 관련 에이전트별 지침 모두에서 지침을 받습니다.

에이전트 유형 범위 지정

범위 지정은 지정된 지침 세트를 수신하는 에이전트 세션을 제어합니다. 두 가지 범위 지정 옵션이 있습니다.

• 글로벌 지침: 에이전트 스페이스의 모든 에이전트 유형에 적용됩니다. 모든 에이전트 세션은이 콘텐츠를 수신합니다.

• 에이전트별: 선택한 에이전트 유형의 세션에만 적용됩니다.

에이전트별 지침에 사용할 수 있는 관리형 에이전트는 다음과 같습니다.

• 채팅 - 채팅 세션 중 임시 질문 및 요청.

• 인시던트 분류 - 경보 필터링, 심각도 분류 및 초기 범위 지정.

• 인시던트 RCA - 증거 수집 및 검증을 통한 근본 원인 분석.

• 인시던트 완화 - 단기 문제 해결 및 장기 수정 권장 사항.

• 평가 - 에이전트 성능 점수 및 정책 준수 검사.

콘텐츠 크기 지침

대화 또는 조사를 시작할 때마다 에이전트는 다른 작업을 수행하기 전에 전체 지침을 읽습니다. 에이전트에는 세션당 고정된 양의 작업 메모리가 있으며 지침은이 중 일부를 사용합니다. 파일이 클수록 질문, 조사, 에이전트가 읽는 로그 및 자체 추론에 대한 공간이 줄어듭니다. 더 짧고 집중적인 지침은 에이전트에게 문제를 해결할 수 있는 더 많은 용량을 제공합니다.

• 하드 제한: 25KB

• 권장 크기: 120줄(대부분의 구성에 권장)

모든 세션에 있어야 하는 지침에 지침을 집중합니다. 특정 작업에만 적용되는 특수한 조사 절차의 경우 DevOps 에이전트 기술 대신를 사용하는 것이 좋습니다.

예제

다음 예제에서는 모든 에이전트 세션에 적용되는 조사 지침, 응답 형식 표준 및 보안 요구 사항이 포함된 잘 구성된 에이전트 지침을 보여줍니다.

# Agent Instructions

## Investigation approach
- Always check CloudWatch alarms and recent deployments before proposing a root cause.

## Response format
- Lead with a one-sentence summary of findings before listing details.
- Include the AWS region and resource identifier for any resource you reference.
- Use bullet points for lists of findings or recommendations.

## Security
- Never log, display, or suggest storing credentials or secrets in plaintext.
- When recommending IAM changes, follow least-privilege principles.

에이전트 지침 설정

에이전트 지침을 설정하기 전에 에이전트 스페이스가 있어야 합니다. 자세한 내용은 에이전트 스페이스 생성 단원을 참조하십시오.

각 에이전트에는 정확히 하나의 지침 세트가 있습니다. 새 콘텐츠를 저장하면 해당 에이전트의 기존 콘텐츠를 덮어씁니다.

전역 지침을 설정하려면(모든 에이전트에 적용):

1. 에이전트 스페이스 운영자 웹 앱에서 에이전트 페이지로 이동합니다.

2. 글로벌 지침 옆의 보기를 선택합니다.

3. 편집기에 마크다운 지침을 입력합니다.

4. 저장을 선택합니다.

특정 에이전트에 대한 지침을 설정하려면:

1. 에이전트 스페이스 운영자 웹 앱에서 에이전트 페이지로 이동합니다.

2. 관리형 에이전트에서 채팅, 인시던트 분류, 인시던트 RCA, 인시던트 완화 또는 평가와 같이 구성하려는 에이전트 옆에 있는 보기를 선택합니다.

3. 편집기에 마크다운 지침을 입력합니다.

4. 저장을 선택합니다.

에이전트 지침 관리

AWS DevOps 에이전트는 운영자 웹 앱을 통해 에이전트 지침에 대한 관리 기능을 제공합니다.

지침 보기: 에이전트 페이지로 이동하여 글로벌 지침 또는 특정 관리형 에이전트 옆에 있는 보기를 선택합니다. 편집기에 현재 콘텐츠가 표시됩니다. 미리 보기 탭을 사용하여 렌더링된 마크다운을 보거나 코드 탭을 사용하여 원시 마크다운을 확인합니다.

편집 지침: 위에 설명된 대로 에이전트를 열고 편집기에서 콘텐츠를 수정한 다음 저장을 선택합니다.

파일에서 지침 업로드: 에이전트를 연 다음 편집기에서 업로드 버튼을 선택하여 컴퓨터에서 마크다운 파일을 업로드합니다.

다운로드 지침: 에이전트를 연 다음 편집기에서 다운로드 버튼을 선택하여 현재 콘텐츠를 파일로 다운로드합니다.

삭제 지침: 에이전트를 열고 편집기에서 삭제 버튼을 선택한 다음 삭제를 확인합니다. 이 작업은 실행을 취소할 수 없습니다. 콘텐츠가 다시 필요할 경우 먼저 다운로드하는 것이 좋습니다.