AI 에이전트가 쓸 도구와 실패할 때 멈출 조건을 정합니다 | DAKER 커뮤니티

AI 에이전트에 모든 도구를 연결하면 작업이 실패했을 때 원인을 찾기 어려울 수 있습니다. AI 에이전트는 도구를 사용하며 작업을 수행하는 AI입니다. 실행 전에 필요한 도구를 고르고, 허용할 동작과 실패할 때 멈출 조건을 적습니다.

이 글은 DAKER 학습 자료 에이전틱 기초 중급 ② — 하네스: 도구 고르기·실패·안전 범위를 바탕으로, 필요한 도구만 연결하고 사용 범위를 정하는 방법을 정리합니다.

도구를 많이 연결하면 실패 원인을 구분하기 어렵습니다

하네스는 AI가 사용할 도구와 실행 규칙을 뜻합니다. 검색·파일 처리·명령 실행 도구를 한꺼번에 연결하고 오류 메시지를 제대로 확인하지 않으면 실패 원인을 놓치기 쉽습니다. 어떤 동작이 허용 범위를 벗어났는지도 기록해야 합니다.

• 필요 없는 도구까지 전부 연결합니다.
• 실패 원인을 확인하지 않고 같은 도구를 바로 다시 실행합니다.
• 허용하는 동작과 금지하는 동작을 글로 남기지 않습니다.

도구별 허용 동작과 중단 조건을 정합니다

Superpowers식 실행에서는 역할과 허용 범위를 먼저 나눕니다. 오늘 쓸 도구만 고르고, 실패하면 어떤 조건에서 멈출지 한 줄로 적습니다. 도구 사용 권한을 늘리기 전에 중단 조건을 분명하게 정합니다.

1. 오늘 필요한 도구만 목록으로 적습니다.
2. 각 도구의 허용 동작과 금지 동작을 한 줄씩 적습니다.
3. 실패했을 때 다시 시도할 횟수와 보고 방식을 정합니다.
4. 허용 범위를 벗어난 도구 실행 요청이 있으면 실행을 멈추고 기록합니다.

네 칸 만화로 도구 설정 과정을 확인합니다

네 칸은 모든 도구를 연결해 실패 원인을 구분하기 어려워지는 상황을 보여 줍니다. 이어서 도구 수를 줄이고 허용 범위를 정하는 과정을 설명합니다. 핵심은 실행 전에 도구별 사용 범위를 정하는 것입니다.

자주 묻는 질문에 답합니다

도구를 줄이면 할 수 있는 일이 줄어드는지 설명합니다. 처음에는 할 수 있는 일이 제한됩니다. 다만 실패 원인을 확인할 수 있어야 다음 도구를 안전하게 추가할 수 있습니다.

실패 후 다시 시도할 횟수를 설명합니다. 적절한 횟수는 과제마다 다릅니다. 이번 연습에서는 실행 전에 횟수를 정해 적어 둡니다.

원문 학습 자료: https://daker.ai/public/learning/materials/agentic-harness-tools-failure-safety

오늘은 사용을 허용할 도구 세 개를 노트에 적습니다. 실패했을 때 멈출 조건도 한 줄로 남깁니다.