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

# 사용자 지정 에이전트 실행
<a name="custom-agents-executing-custom-agents"></a>

온디맨드 방식으로 사용자 지정 에이전트를 실행하거나 트리거를 구성하여 자동으로 실행할 수 있습니다.

## 온디맨드 사용자 지정 에이전트 실행
<a name="running-a-custom-agent-on-demand"></a>

에이전트 세부 정보 페이지 또는 채팅을 통해 즉시 사용자 지정 에이전트를 실행할 수 있습니다.

**세부 정보 페이지에서 사용자 지정 에이전트를 실행하려면:**

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

1. 실행할 사용자 지정 에이전트를 선택합니다.

1. 구성된 지침에 따라 에이전트를 실행하려면 **지금 실행**을 선택합니다.

특정 실행에 대한 추가 컨텍스트를 제공하려면 **지금 실행** 옆의 드롭다운 화살표를 선택하고이 호출에서 에이전트가 집중해야 할 사항을 설명하는 프롬프트를 입력한 다음 **프롬프트로 실행**을 선택합니다. 프롬프트는 시스템 프롬프트와 함께 추가 컨텍스트로 에이전트에 전달됩니다.

실행이 시작되면 새 호출이 **기록** 탭에 "Pending start" 상태로 나타납니다. 실시간으로 궤적을 보려면 호출을 선택합니다.

**채팅을 사용하여 사용자 지정 에이전트를 실행하려면**

채팅에 에이전트를 이름으로 실행하도록 요청합니다. 예제:

```
Run my weekly-investigation-report agent.
```

```
Run certificate-checker and focus on certificates expiring in the next 7 days.
```

채팅 메시지에 추가 컨텍스트를 제공하면 채팅은 이를 해당 실행에 대한 프롬프트로 전달합니다. 추가 컨텍스트를 제공하지 않으면 에이전트는 구성된 시스템 프롬프트로만 실행됩니다.

사용자 지정 에이전트는 한 번에 하나의 호출만 실행할 수 있습니다. 에이전트가 이미 실행 중인 경우 다른 호출을 시작하기 전에 현재 호출이 완료되거나 시간 초과되거나 취소될 때까지 기다려야 합니다.

## 사용자 지정 에이전트 예약
<a name="scheduling-custom-agents"></a>

트리거를 사용하면 정의된 조건에 따라 사용자 지정 에이전트를 자동으로 실행할 수 있습니다. AWS DevOps 에이전트는 현재 일정 기반 트리거를 지원하며,이 트리거는 EventBridge 호환 cron 또는 rate 표현식을 사용하여 반복 간격으로 에이전트를 실행합니다.

**일정 트리거를 생성하려면:**

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

1. 예약할 사용자 지정 에이전트를 선택합니다.

1. **트리거** 탭을 선택합니다.

1. **\+**(생성) 버튼을 선택합니다.

1. 대화 상자의 입력 필드에 일정 표현식을 입력합니다. 표현식은 다음 형식 중 하나여야 합니다.
   + **속도 표현**식 - 고정된 간격으로 실행됩니다. 형식: `rate(value unit)` 예시:
     + `rate(1 hour)` - 매시간
     + `rate(30 minutes)` - 30분마다
     + `rate(7 days)` - 7일마다
   + **Cron 표현**식 - 특정 일정에 따라 실행됩니다. 형식: `cron(minutes hours day-of-month month day-of-week year)` 예시:
     + `cron(0 9 ? * MON-FRI *)` - 평일 오전 9:00 UTC
     + `cron(0 0 1 * ? *)` - 매월 1일 자정 UTC
     + `cron(0 */6 ? * * *)` - 6시간마다

표현식이 유효하면 녹색 확인 메시지가 나타납니다.

1. **생성(Create)**을 선택합니다.

cron 표현식의 경우 정확히 day-of-month 또는 day-of-week 중 하나가 `?` (물음표)여야 합니다. 일정 표현식 구문에 대한 자세한 내용은 *Amazon EventBridge 스케줄러 사용 설명서*의 [일정 유형을](https://docs.aws.amazon.com/scheduler/latest/UserGuide/schedule-types.html) 참조하세요.

생성 후 트리거가 목록에 나타나 표현식, 생성 날짜 및 예약된 다음 런타임을 표시합니다.

## 트리거 관리
<a name="managing-triggers"></a>

**트리거** 탭에는 사용자 지정 에이전트에 대해 구성된 모든 트리거가 표시됩니다. 각 트리거에 대해 일정 표현식, 일정 표현식이 생성된 시간 및 다음 실행 시기를 확인할 수 있습니다.

**트리거 일시 중지:**

트리거를 삭제하지 않고 일시적으로 중지하려면 트리거 옆의 토글 스위치를 끕니다. 트리거 상태가 "일시 중지됨"으로 변경되고 다시 활성화될 때까지 더 이상 실행되지 않습니다. 토글을 다시 켜서 일정을 재개합니다.

**트리거 삭제:**

트리거를 영구적으로 제거하려면 제거하려는 트리거 옆에 있는 삭제 아이콘(휴지통)을 선택합니다. 표시되는 대화 상자에서 삭제를 확인합니다. 삭제된 트리거는 복구할 수 없습니다.

## 호출 취소
<a name="canceling-an-invocation"></a>

호출 궤적 보기 또는 채팅을 통해 실행 중인 호출을 취소할 수 있습니다.

**궤적 보기에서 실행 중인 호출을 취소하려면:**

1. **기록** 탭에서 실행 중인 호출을 선택합니다.

1. 궤적 보기 상단에서 **취소**를 선택합니다.

**채팅을 사용하여 실행 중인 호출을 취소하려면**

```
Cancel the running invocation of weekly-health-report.
```

호출 상태가 “취소됨”으로 변경됩니다. 취소 전에 완료된 모든 작업은 궤적에 보존됩니다. 취소 발생 시 진행 중인 도구 호출은 여전히 완료될 수 있습니다.

## 도구 호출 결과
<a name="tool-call-results"></a>

호출 중에 사용자 지정 에이전트는 MCP 도구를 호출하여 데이터를 수집하고, 작업을 수행하고, 출력을 생성합니다. 각 도구 호출과 그 결과는 호출 궤적에 기록됩니다.

도구 호출 결과는 호출 중에 에이전트가 수행한 작업에 대한 투명성을 제공합니다.
+ **성공적인 도구 호출** - 에이전트가 작업을 계속하는 데 사용하는 데이터를 반환한 도구입니다. 예를 들어는 로그 항목을 `query_cloudwatch_logs` 반환하거나 API 응답을 `use_aws` 반환합니다.
+ **실패한 도구 호출** - 도구가 오류를 반환했습니다. 에이전트는 다시 시도하거나, 대체 접근 방식을 시도하거나, 출력에 실패를 보고할 수 있습니다.

호출 궤적에서 개별 도구 호출 및 결과를 검사하여 에이전트의 동작을 이해하고, 에이전트가 올바른 리소스에 액세스했는지 확인하고, 예상치 못한 결과를 해결할 수 있습니다. 궤적 보기에 대한 자세한 내용은 [호출 궤적 보기를 참조하세요](custom-agents-managing-custom-agents.md).