사용자 지정 에이전트 실행

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

온디맨드 사용자 지정 에이전트 실행

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

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

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

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

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

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

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

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

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

Run my weekly-investigation-report agent.

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

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

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

사용자 지정 에이전트 예약

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

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

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

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

3. 트리거 탭을 선택합니다.

4. +(생성) 버튼을 선택합니다.

5. 대화 상자의 입력 필드에 일정 표현식을 입력합니다. 표현식은 다음 형식 중 하나여야 합니다.

   • 속도 표현식 - 고정된 간격으로 실행됩니다. 형식: 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 스케줄러 사용 설명서의 일정 유형을 참조하세요.

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

트리거 관리

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

트리거 일시 중지:

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

트리거 삭제:

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

호출 취소

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

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

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

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

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

Cancel the running invocation of weekly-health-report.

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

도구 호출 결과

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

도구 호출 결과는 호출 중에 에이전트가 수행한 작업에 대한 투명성을 제공합니다.

• 성공적인 도구 호출 - 에이전트가 작업을 계속하는 데 사용하는 데이터를 반환한 도구입니다. 예를 들어는 로그 항목을 query_cloudwatch_logs 반환하거나 API 응답을 use_aws 반환합니다.

• 실패한 도구 호출 - 도구가 오류를 반환했습니다. 에이전트는 다시 시도하거나, 대체 접근 방식을 시도하거나, 출력에 실패를 보고할 수 있습니다.

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