Hook 액션

Agent Hooks는 "에이전트 프롬프트"("Ask Kiro")와 "셸 명령" 액션을 모두 지원합니다. Hook을 트리거하는 특정 이벤트를 선택한 후, hook이 트리거될 때 Kiro가 수행할 작업을 결정할 수 있습니다.

Agent Prompt 액션

이 액션을 사용하면 hook이 트리거될 때마다 에이전트에게 전송되는 프롬프트를 정의할 수 있습니다. 에이전트는 채팅 패널에서 제공된 프롬프트와 동일하게 이 프롬프트에 응답하고 실행합니다.

PromptSubmit 트리거의 경우, 이 액션을 "Add to prompt"라고 합니다. Hook에 지정된 프롬프트가 사용자 프롬프트에 추가되고, 결합된 프롬프트가 에이전트에게 전송됩니다.

Shell Command 액션

이 액션을 사용하면 hook이 트리거될 때마다 실행되는 셸 명령을 정의할 수 있습니다.

명령이 성공을 나타내는 종료 코드 "0"을 반환하면, 명령의 stdout 출력이 에이전트의 컨텍스트에 추가됩니다.

명령이 다른 종료 코드를 반환하면, 명령의 stderr 출력이 에이전트에게 전송되고, 에이전트는 hook이 오류를 반환했음을 알림 받습니다. 또한 Pre Tool Use hook의 경우 도구 호출이 차단되고, Prompt Submit hook의 경우 사용자 프롬프트 제출이 차단됩니다.

실행 타임아웃을 지정할 수 있습니다. 기본 타임아웃은 60초입니다. 타임아웃을 비활성화하려면 0으로 설정하세요.

참고

이 액션은 현재 파일 및 수동 트리거에 사용할 수 없습니다.

액션 타입 선택

트리거 이벤트에 대한 응답으로 자연어를 사용하여 에이전트에게 컨텍스트를 기반으로 특정 작업을 수행하도록 지시하려는 경우 Agent Prompt 액션을 사용해야 합니다.

에이전트의 현재 컨텍스트에 의존하지 않는 특정 명령을 실행하거나 결정론적 작업 세트를 수행하려는 경우 Shell Command 액션을 사용해야 합니다.

Agent Prompt 액션은 새로운 에이전트 루프를 트리거하므로 크레딧을 소비하는 반면, Shell Command 액션은 크레딧을 소비하지 않습니다. Shell Command 액션은 PC에서 로컬로 실행되고 LLM을 사용하지 않으므로 일반적으로 Agent Prompt 액션보다 빠릅니다.