View a markdown version of this page

사용자 지정 에이전트 생성 - AWS DevOps 에이전트
양식을 사용하여 사용자 지정 에이전트 생성채팅을 사용하여 사용자 지정 에이전트 생성리포지토리에서 사용자 지정 에이전트 가져오기커뮤니티 사용자 지정 에이전트시스템 프롬프트 작성도구 구성Release Manager 도구기술 구성

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

사용자 지정 에이전트 생성

DevOps Agent 웹 앱의 양식을 사용하거나 채팅의 안내 대화를 통해 사용자 지정 에이전트를 생성할 수 있습니다. 두 방법 모두 에이전트 스페이스에 동일한 사용자 지정 에이전트 구성이 저장됩니다.

사용자 지정 에이전트를 생성하기 전에 하나 이상의 연결된 통합이 있는 에이전트 공간이 있어야 합니다. 자세한 내용은 에이전트 스페이스 생성 단원을 참조하십시오.

양식을 사용하여 사용자 지정 에이전트 생성

이 양식을 사용하면 이름, 시스템 프롬프트 및 선택적 기술을 지정하여 사용자 지정 에이전트를 빠르게 생성할 수 있습니다. 에이전트에 MCP 도구를 할당하려면 에이전트를 생성한 후 채팅을 사용합니다.

양식을 사용하여 사용자 지정 에이전트를 생성하려면:

  1. DevOps Agent 웹 앱에서 에이전트 페이지로 이동합니다.

  2. 사용자 지정 에이전트 섹션에서 에이전트 생성을 선택합니다.

  3. 대화 상자에서 양식을 선택합니다.

  4. 양식을 작성합니다.

    • 이름 - 에이전트의 고유 식별자입니다. 소문자, 숫자 및 하이픈만 사용합니다(최대 64자). 하이픈으로 시작하거나 끝나지 않아야 합니다. 예시: weekly-health-report

    • 시스템 프롬프트 - 에이전트가 수행하는 작업과 작동 방식을 정의하는 지침으로, 마크다운(최소 10자, 최대 50,000자)으로 작성됩니다. 효과적인 프롬프트 작성에 대한 지침은 시스템 프롬프트 작성을 참조하세요.

    • 기술(선택 사항) - 에이전트 스페이스에서 에이전트에게 추가 도메인 지식 또는 기능을 제공하는 기술을 선택합니다. 검색 필드를 사용하여 이름별로 스킬을 찾습니다.

  5. Create agent(에이전트 생성)을 선택합니다.

생성 후 구성을 보거나, 에이전트를 실행하거나, 트리거를 설정할 수 있는 에이전트의 세부 정보 페이지로 리디렉션됩니다.

채팅을 사용하여 사용자 지정 에이전트 생성

채팅은 사용자 지정 에이전트를 생성하기 위한 안내식 대화 환경을 제공합니다. 이 방법은 에이전트에 MCP 도구를 할당하거나 시스템 프롬프트를 작성하는 데 도움이 필요한 경우에 권장됩니다.

채팅을 사용하여 사용자 지정 에이전트를 생성하려면:

  1. DevOps Agent 웹 앱에서 에이전트 페이지로 이동합니다.

  2. 사용자 지정 에이전트 섹션에서 에이전트 생성을 선택합니다.

  3. 대화 상자에서 채팅을 선택합니다. 대화 상자가 닫히고 채팅 패널에서 미리 작성된 메시지와 함께 새 대화가 열립니다.

  4. 채팅은 협업 프로세스를 안내합니다.

    • 의도 설명 - 에이전트의 목적과 범위를 확인합니다.

    • 중복 검사 - 에이전트 스페이스에 유사한 에이전트가 이미 없는지 확인합니다.

    • 도구 및 기술 선택 - 에이전트에게 필요한 MCP 도구 및 기술을 제안하고 사용자에게 확인을 요청합니다.

    • 출력 유형 - 에이전트가 텍스트 응답, 아티팩트 또는 추천을 생성할지 여부를 결정합니다.

    • 시스템 프롬프트 초안 - 시스템 프롬프트를 작성하고 검토를 위해 표시합니다. 만족할 때까지 반복할 수 있습니다.

    • 확인 - 에이전트를 생성하기 전에 이름을 제안하고 모든 설정을 확인합니다.

언제든지 채팅에 직접 요청하여 사용자 지정 에이전트를 생성할 수도 있습니다. 예제:

Create an agent that generates a weekly report of all investigations from the past week.
Create a custom agent for checking certificate expiration across all accounts.
Make me an agent that audits DynamoDB table configurations daily.

리포지토리에서 사용자 지정 에이전트 가져오기

GitHub 리포지토리의 마크다운 파일에서 직접 사용자 지정 에이전트의 시스템 프롬프트를 가져올 수 있습니다. 파일 콘텐츠는 에이전트의 시스템 프롬프트가 됩니다. 버전 관리에서 에이전트 프롬프트를 관리하고 단일 작업으로 가져올 수 있습니다.

사전 조건:

  • 에이전트 스페이스와 연결된 GitHub 계정입니다. GitHub 계정을 연결하려면 섹션을 참조하세요GitHub 연결. 모든 GitHub 계정 연결을 사용하면 퍼블릭 리포지토리에서 가져올 수 있습니다. 프라이빗 리포지토리의 경우 연결된 계정에 리포지토리에 대한 읽기 액세스 권한이 있어야 합니다. 데이터 레지던시 연결이 있는 GitHub Enterprise Server 및 GitHub Enterprise Cloud도 지원됩니다.

  • 시스템 프롬프트가 포함된 GitHub 리포지토리의 마크다운 파일(.md)입니다.

리포지토리에서 사용자 지정 에이전트를 가져오려면:

  1. DevOps Agent 웹 앱에서 에이전트 페이지로 이동합니다.

  2. 사용자 지정 에이전트 섹션에서 에이전트 생성을 선택합니다.

  3. 대화 상자에서 가져오기를 선택합니다. 대화 상자가 GitHub에서 가져오기 보기로 변경됩니다.

  4. 양식을 작성합니다.

    • 이름 - 에이전트의 고유 식별자입니다. 소문자, 숫자 및 하이픈만 사용합니다(최대 64자). 하이픈으로 시작하거나 끝나지 않아야 합니다.

    • 리포지토리 URL - 에이전트의 시스템 프롬프트가 포함된 단일 마크다운(.md) 파일에 대한 링크입니다. 예를 들어 https://github.com/my-org/my-repo/blob/main/my-agent.md입니다. 데이터 레지던시가 있는 GitHub Enterprise Server 또는 GitHub Enterprise Cloud의 경우 인스턴스 URL을 대신 사용합니다. 예를 들어 https://github.example.com/my-org/my-repo/blob/main/my-agent.md입니다. URL이 로 끝나지 않으면 경고.md가 나타납니다. 파일이 마크다운이 아닌 경우 가져오기가 실패합니다.

    • 기술(선택 사항) - 에이전트 스페이스에서 기술을 선택하여 에이전트에게 추가 도메인 지식 또는 기능을 제공합니다.

  5. 에이전트 가져오기를 선택합니다.

리포지토리 파일은 시스템 프롬프트만 제공합니다. 이름과 스킬은 양식에서 가져옵니다.

생성 후 구성을 보거나, 에이전트를 실행하거나, 트리거를 설정할 수 있는 에이전트의 세부 정보 페이지로 리디렉션됩니다.

가져온 에이전트 보기:

가져온 에이전트는 마지막으로 동기화된 타임스탬프 및 GitHub의 소스 파일에 대한 링크와 함께 에이전트 세부 정보 페이지의 이름 옆에 GitHub에서 동기화된 배지를 표시합니다. 사용자 지정 에이전트 목록에서 가져온 에이전트에는 소스 파일에 대한 링크가 포함됩니다.

가져온 에이전트를 편집하면 시스템 프롬프트에 소스 파일에 연결되는 힌트와 함께 읽기 전용 레이블이 표시됩니다. 이름과 스킬은 편집 가능한 상태로 유지됩니다.

가져온 에이전트 동기화:

리포지토리에서 마크다운 파일을 업데이트할 때 가져온 에이전트의 세부 정보 페이지를 열고 동기화를 선택하여 최신 시스템 프롬프트를 가져옵니다.

제약 조건:

  • URL 형식 - GitHub Enterprise Server 및 데이터 레지던시가 있는 GitHub Enterprise Cloud를 포함하여 GitHub URLs만 허용됩니다. 연결된 GitHub 계정은 URL 호스트와 일치해야 합니다. 예를 들어 github.example.com 연결은 github.example.com URLs에서만 가져올 수 있으며 github.com URLs에서는 가져올 수 없습니다.

  • 마크다운 파일 필요 - URL은 단일 .md 파일을 가리켜야 합니다.

  • 최대 파일 크기 - 파일은 1MB(GitHub API 제한)를 초과해서는 안 됩니다.

  • GitHub 계정 필요 - 에이전트를 가져오려면 에이전트 스페이스에 연결된 GitHub 계정이 있어야 합니다. 프라이빗 리포지토리의 경우 계정에 읽기 액세스 권한이 있어야 합니다.

커뮤니티 사용자 지정 에이전트

AWS DevOps 에이전트 도구 리포지토리에는 상태 보고서, 운영 검토 및 서비스 할당량 모니터링과 같은 반복적인 운영 작업을 위해 사전 구축된 사용자 지정 에이전트 구성이 포함되어 있습니다. 리포지토리는 AWS DevOps 에이전트 서비스 팀에서 유지 관리하며, 모든 기여는 추가되기 전에 동일한 보안 검토 표시줄을 거칩니다. 사용 가능한 항목을 찾아보려면 GitHub 웹 사이트에서 사용자 지정 에이전트 카탈로그를 참조하세요.

커뮤니티 사용자 지정 에이전트를 사용하려면 에이전트 페이지의 리포지토리에서 가져오기 흐름을 사용하여 리포지토리에서 가져옵니다. 에이전트의 마크다운 파일의 URL을 복사하여 리포지토리 URL로 붙여 넣습니다. 자세한 내용은 리포지토리에서 사용자 지정 에이전트 가져오기를 참조하세요.

시스템 프롬프트 작성

시스템 프롬프트는 사용자 지정 에이전트에서 가장 중요한 부분입니다. 에이전트의 목적, 접근 방식, 제약 조건 및 예상 출력을 정의합니다. 잘 작성된 프롬프트는 일관되고 신뢰할 수 있는 결과를 생성합니다.

다음 섹션을 사용하여 시스템 프롬프트를 구성합니다.

  • 목표 - 에이전트가 한 문장 또는 짧은 단락으로 수행해야 하는 작업입니다.

  • 접근 방식 Step-by-step 절차입니다.

  • 제약 조건 - 에이전트가 수행해야 하는 작업과 해서는 안 되는 작업에 대한 경계입니다. 예를 들어 읽기 전용 액세스, 고려할 시간 범위 또는 제외할 서비스입니다.

  • 출력 - 에이전트가 생성해야 하는 것과 형식입니다. 텍스트를 생성할지, 아티팩트를 생성할지 또는 권장 사항을 생성할지 지정합니다.

시스템 프롬프트 예제:

You are a DevOps reporting agent specializing in summarizing investigation activity.

## Goal
Generate a concise weekly report of all investigations from the past 7 days.

## Approach
1. Call `list_investigations` to fetch investigations from the last 7 days.
2. For each investigation, retrieve its title, status, root cause, and resolution time.
3. Group investigations by status and root cause category.
4. Identify trends: services most affected, average resolution time, recurring root causes.

## Constraints
- Only include investigations from the past 7 days.
- Read-only access — do not modify, close, or reassign investigations.

## Output
Produce a single artifact titled "Weekly Investigation Report" containing:
- A table listing each investigation with title, status, and resolution time.
- A chart showing investigation counts by root cause category.
- A summary paragraph with key trends and recommendations.

효과적인 시스템 프롬프트를 위한 팁:

  • 도구에 대해 구체적으로 설명 - 에이전트가 호출할 도구를 알 수 있도록 도구 이름(예: , use_aws, list_investigationsquery_cloudwatch_logs)을 직접 참조합니다.

  • 성공 기준 정의 - 에이전트가 완료 시점을 알 수 있도록 좋은 출력이 어떻게 보이는지 설명합니다.

  • 경계 설정 - 의도하지 않은 작업을 방지하기 위해 에이전트가 해서는 안 되는 일을 명시적으로 설명합니다.

  • 마크다운 형식 사용 - 헤더, 목록 및 코드 블록을 사용하면 에이전트가 프롬프트를 더 쉽게 구문 분석하고 따를 수 있습니다.

도구 구성

MCP 도구는 사용자 지정 에이전트가 호출 중에 수행할 수 있는 작업을 결정합니다. 연결된 AWS 계정, 관찰성 플랫폼, CI/CD 파이프라인, 티켓팅 시스템, 사용자 지정 MCP 서버의 도구를 포함하여 에이전트 스페이스에서 사용할 수 있는 전체 세트에서 도구를 선택합니다.

도구는 채팅을 통해서만 구성할 수 있습니다. 에이전트를 생성할 때 도구를 할당하려면 채팅 생성 방법을 사용합니다. 기존 에이전트에서 도구를 추가하거나 변경하려면 채팅에 에이전트 업데이트를 요청합니다. 예제:

Add the query_cloudwatch_logs and use_aws tools to my weekly-health-report agent.
Update certificate-checker to also use the list_resources tool.
Remove the use_kubectl tool from cluster-audit-agent.

도구를 선택할 때는 최소 권한 원칙을 따릅니다. 에이전트가 작업을 수행하는 데 필요한 도구만 할당합니다. 이렇게 하면 의도하지 않은 작업의 위험이 줄어들고 에이전트가 집중할 수 있습니다.

Release Manager 도구

사용자 지정 에이전트는 Release Manager 도구에 액세스할 수 있습니다. 이러한 도구를 사용하면 에이전트가 Release Manager 작업을 생성, 나열, 가져오기 및 취소할 수 있습니다. 에이전트는 릴리스 준비 검토 보고서를 분석하여 조사 결과 및 권장 조치를 표시할 수도 있습니다.

Release Manager 도구를 사용하려면 Chat을 통해 사용자 지정 에이전트에 할당합니다. 예제:

Add the release manager tools to my release-pipeline-agent.

릴리스 관리 기능에 대한 자세한 내용은 섹션을 참조하세요릴리스 관리.

기술 구성

스킬은 사용자 지정 에이전트에게 추가 도메인 지식, 조사 절차 또는 전문 기능을 제공합니다. 사용자 지정 에이전트가 실행되면 할당된 기술을 로드하고 호출 중에 해당 지침을 참조할 수 있습니다.

생성 중에 스킬을 할당하거나(양식 또는 채팅 사용) 나중에 에이전트를 편집하여 스킬을 추가할 수 있습니다. 사용자 지정 에이전트에 할당된 스킬은 에이전트 스페이스에 이미 있어야 합니다. 스킬 생성에 대한 자세한 내용은 섹션을 참조하세요DevOps 에이전트 기술.

또한 사용자 지정 에이전트에는 스킬 할당이 필요하지 않은 아티팩트 및 권장 사항을 생성할 수 있는 기능이 내장되어 있습니다. 자세한 내용은 사용자 지정 에이전트 출력 단원을 참조하십시오.

사용자 지정 에이전트당 최대 200개의 스킬을 할당할 수 있습니다. 컨텍스트 소비를 줄이고 에이전트 집중도를 높이려면 에이전트의 목적과 관련된 기술을 선택합니다.