기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 사용자 지정 에이전트 생성
DevOps Agent 웹 앱의 양식을 사용하거나 채팅의 안내 대화를 통해 사용자 지정 에이전트를 생성할 수 있습니다. 두 방법 모두 에이전트 스페이스에 동일한 사용자 지정 에이전트 구성이 저장됩니다.
사용자 지정 에이전트를 생성하기 전에 하나 이상의 연결된 통합이 있는 에이전트 공간이 있어야 합니다. 자세한 내용은 [에이전트 스페이스 생성](getting-started-with-aws-devops-agent-creating-an-agent-space.md) 단원을 참조하십시오.
## 양식을 사용하여 사용자 지정 에이전트 생성
이 양식을 사용하면 이름, 시스템 프롬프트 및 선택적 기술을 지정하여 사용자 지정 에이전트를 빠르게 생성할 수 있습니다. 에이전트에 MCP 도구를 할당하려면 에이전트를 생성한 후 채팅을 사용합니다.
**양식을 사용하여 사용자 지정 에이전트를 생성하려면:**
1. DevOps **Agent** 웹 앱에서 에이전트 페이지로 이동합니다.
1. **사용자 지정 에이전트** 섹션에서 **에이전트 생성을** 선택합니다.
1. 대화 상자에서 **양식을** 선택합니다.
1. 양식을 작성합니다.
+ **이름** - 에이전트의 고유 식별자입니다. 소문자, 숫자 및 하이픈만 사용합니다(최대 64자). 하이픈으로 시작하거나 끝나지 않아야 합니다. 예시: `weekly-health-report`
+ **시스템 프롬프트** - 에이전트가 수행하는 작업과 작동 방식을 정의하는 지침으로, 마크다운(최소 10자, 최대 50,000자)으로 작성됩니다. 효과적인 프롬프트 작성에 대한 지침은 [시스템 프롬프트 작성을 참조하세요](#writing-a-system-prompt).
+ **기술**(선택 사항) - 에이전트 스페이스에서 에이전트에게 추가 도메인 지식 또는 기능을 제공하는 기술을 선택합니다. 검색 필드를 사용하여 이름별로 스킬을 찾습니다.
1. **Create agent(에이전트 생성)**을 선택합니다.
생성 후 구성을 보거나, 에이전트를 실행하거나, 트리거를 설정할 수 있는 에이전트의 세부 정보 페이지로 리디렉션됩니다.
## 채팅을 사용하여 사용자 지정 에이전트 생성
채팅은 사용자 지정 에이전트를 생성하기 위한 안내식 대화 환경을 제공합니다. 이 방법은 에이전트에 MCP 도구를 할당하거나 시스템 프롬프트를 작성하는 데 도움이 필요한 경우에 권장됩니다.
**채팅을 사용하여 사용자 지정 에이전트를 생성하려면:**
1. DevOps **Agent** 웹 앱에서 에이전트 페이지로 이동합니다.
1. **사용자 지정 에이전트** 섹션에서 **에이전트 생성을** 선택합니다.
1. 대화 상자에서 **채팅**을 선택합니다. 대화 상자가 닫히고 채팅 패널에서 미리 작성된 메시지와 함께 새 대화가 열립니다.
1. 채팅은 협업 프로세스를 안내합니다.
+ **의도 설명** - 에이전트의 목적과 범위를 확인합니다.
+ **중복 검사** - 에이전트 스페이스에 유사한 에이전트가 아직 없는지 확인합니다.
+ **도구 및 기술 선택** - 에이전트에게 필요한 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.
```
## 시스템 프롬프트 작성
시스템 프롬프트는 사용자 지정 에이전트에서 가장 중요한 부분입니다. 에이전트의 목적, 접근 방식, 제약 조건 및 예상 출력을 정의합니다. 잘 작성된 프롬프트는 일관되고 신뢰할 수 있는 결과를 생성합니다.
**다음 섹션을 사용하여 시스템 프롬프트를 구성합니다.**
+ **목표** - 에이전트가 한 문장 또는 짧은 단락으로 수행해야 하는 작업입니다.
+ **접근** 방식 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_investigations``query_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.
```
도구를 선택할 때는 최소 권한 원칙을 따릅니다. 에이전트가 작업을 수행하는 데 필요한 도구만 할당합니다. 이렇게 하면 의도하지 않은 작업의 위험이 줄어들고 에이전트가 집중할 수 있습니다.
## 스킬 구성
스킬은 사용자 지정 에이전트에게 추가 도메인 지식, 조사 절차 또는 전문 기능을 제공합니다. 사용자 지정 에이전트가 실행되면 할당된 스킬을 로드하고 호출 중에 해당 지침을 참조할 수 있습니다.
생성 중에 스킬을 할당하거나(양식 또는 채팅 사용) 나중에 에이전트를 편집하여 스킬을 추가할 수 있습니다. 사용자 지정 에이전트에 할당된 스킬은 에이전트 스페이스에 이미 있어야 합니다. 스킬 생성에 대한 자세한 내용은 섹션을 참조하세요[DevOps 에이전트 기술](about-aws-devops-agent-devops-agent-skills.md).
또한 사용자 지정 에이전트에는 스킬 할당이 필요하지 않은 아티팩트 및 권장 사항을 생성할 수 있는 기능이 내장되어 있습니다. 자세한 내용은 [사용자 지정 에이전트 출력](custom-agents-custom-agent-outputs.md) 단원을 참조하십시오.
사용자 지정 에이전트당 최대 200개의 스킬을 할당할 수 있습니다. 컨텍스트 소비를 줄이고 에이전트 포커스를 개선하려면 에이전트의 목적과 관련된 기술을 선택합니다.