Agent 모델 선택, 맡길 일부터 정해 보세요

ClawPod Agent로 문서를 요약하거나 초안을 만들고 싶은데, 모델 이름이 많아 어디서 시작할지 막막한가요? 맡길 일을 정하고, AI 서비스를 연결한 다음, 작은 요청 하나를 보내 보세요. 처음부터 가장 좋은 모델을 찾기보다 내 작업을 제대로 처리하는지 확인하는 편이 좋습니다.

1. 모델에 맡길 역할을 고르세요

공식 Guide는 모델의 역할을 다음 네 가지로 나눕니다.[1]

역할	맡는 일
메인 · main	최종 판단과 주요 응답
서브 · sub	조사, 초안 등 보조 작업
폴백 · fallback	메인 호출이 실패했을 때 대신 응답
하트비트 · heartbeat	Agent의 주기적인 상태 점검

먼저 주요 답변을 담당할 main을 고르세요. 답변의 품질뿐 아니라 업무에 필요한 도구를 쓸 수 있는지, 비용은 적절한지도 함께 봅니다. sub에는 더 가벼운 모델을 고려할 수 있지만 민감한 판단까지 맡기지는 마세요. 이 역할들이 문서 작성 순서를 자동으로 정해 주는 것은 아니므로, 원하는 순서는 요청에 적어 주세요.

하트비트에는 어떤 모델을 쓸까요?

하트비트는 Agent가 주기적으로 상태를 살펴보는 기능입니다. 여기서는 단순 점검을 넘어 진행 중인 일을 이어가고 결과를 검토하는 운영 방식을 다룹니다.

Heartbeat가 진행 중인 업무를 이어가거나 결과 검토·복구 판단까지 수행하기 때문에, main과 동일한 모델을 기본으로 고려하세요.

위 권고는 업무 재개와 결과 검토를 맡기는 운영 범위를 전제로 합니다. 현재 공식 Guide도 main과 heartbeat에 같은 제공자의 동일한 모델을 권장합니다.[1] 필수 조건으로 단정하는 것은 아니며, 다른 구성이 필요하다면 운영 담당자와 필요한 판단·도구 사용·비용을 함께 확인하세요.

실제 점검 여부와 주기는 Agent 설정에 따라 다릅니다. 모델을 고르거나 점검 지침 파일인 HEARTBEAT.md를 작성하는 것만으로 예약 실행이 설정되지는 않습니다. 원하는 점검 목적을 운영 담당자에게 알려 실행 조건을 확인하세요.[2]

2. 선택한 모델의 AI 서비스를 연결하세요

모델을 제공하는 AI 서비스를 설정에서 **provider(제공자)**라고 부릅니다. **credential(인증 정보)**은 그 서비스에 연결하고 사용할 권한을 확인하는 정보입니다. 서비스마다 필요한 연결 방식이 다릅니다.

선택 가능한 모델은 현재 ClawPod Cloud Portal의 목록에서 확인하세요. 목록에 보여도 해당 Agent에서 쓸 수 있는 인증 정보가 준비돼야 합니다. 원하는 모델이 없다면 지침 파일에 이름을 넣지 말고 조직 관리자에게 문의하세요.[1]

main과 fallback이 서로 다른 AI 서비스를 쓴다면 양쪽 연결이 모두 필요합니다. 공식 Guide는 테스트 Room에서 각각 작동을 확인하도록 안내합니다. 로컬 모델, 즉 직접 운영하는 서버의 모델도 서버 연결 테스트 뒤에 해당 Agent의 실제 응답을 확인해야 합니다.[1]

기존 Agent를 변경할 때는 현재 역할별 서비스·모델과 인증 정보의 이름이나 식별자만 기록해 두세요. 키나 토큰 원문은 대화나 메모에 복사하지 마세요. Guide의 변경 절차는 진행 중인 작업에 미칠 영향을 확인한 뒤 ‘저장 후 재시작’을 하고 Agent가 다시 실행 가능한지 확인하는 순서입니다.[1] 팀의 변경 권한과 작업 시간을 먼저 맞추고, 화면이나 권한이 다르면 관리자에게 도움을 요청하세요.

3. 작은 문서 요청으로 답변을 확인하세요

실제 고객 자료 대신 아래 가상 안내문을 테스트 Room에 붙여 넣어 보세요. 민감한 자료나 외부 작업 없이 원문을 잘 따르는지 확인할 수 있습니다.

보낼 요청 — 가상 예시

다음은 테스트용 가상 안내문입니다.

“봄빛팀은 목요일 오후 2시에 30분간 주간 회의를 합니다. 참석자는 수요일 오후 5시까지 안건을 공유 문서에 적습니다. 회의실은 아직 정하지 않았습니다.”

위 안내문만 근거로 ① 회의 일정 ② 참석자가 할 일 ③ 아직 정해지지 않은 사항을 각각 한 줄로 요약해 주세요. 없는 정보를 보태지 마세요. 외부 검색, 도구 실행, 설정 변경, 메시지 발송은 하지 마세요.

기대 결과 — 가상 예시이며 실제 실행 결과가 아닙니다

회의 일정: 목요일 오후 2시부터 30분간 주간 회의를 합니다.

참석자가 할 일: 수요일 오후 5시까지 공유 문서에 안건을 적습니다.

미정 사항: 회의실은 아직 정해지지 않았습니다.

받은 답변에서 회의는 목요일 오후 2시·30분, 안건 제출은 수요일 오후 5시까지, 회의실은 미정으로 되어 있는지 확인하세요. 회의실을 지어냈다면 그 문장을 틀린 부분으로 표시하고 원문만으로 수정하도록 요청하세요. 수정된 답변도 같은 기준으로 다시 비교합니다.

이 시험으로 확인하는 것은 이 문서의 답변 품질입니다. 업무에 도구가 필요하다면 허용된 범위에서 작고 되돌릴 수 있는 작업으로 따로 확인하세요. 실제 사용된 모델은 답변 속 자기소개가 아니라 운영 담당자가 확인할 수 있는 실행 기록으로 대조합니다.

fallback도 구분해서 확인해야 합니다. main의 응답 성공이 fallback의 작동까지 증명하지는 않습니다. 대체 모델이 따로 응답하는지와 main 실패 때 실제로 대체되는지는 다른 확인입니다. 전환 확인이 필요하면 운영 담당자에게 승인된 비운영 환경 검증을 요청하세요. 운영 키를 망가뜨리거나 장애를 일부러 만들지는 마세요.

4. 응답이 없거나 변경 뒤 문제가 생기면 관리자에게 문의하세요

오류가 나면 비밀값을 뺀 오류 문구, 발생 시각, 대상 Agent, 바꾼 역할을 관리자에게 전달하세요. 선택한 AI 서비스의 인증 정보가 유효하고 해당 Agent에서 사용 가능한지 확인하는 데 도움이 됩니다. 로컬 모델이라면 서버 접근과 모델 준비 상태도 함께 확인합니다.[1]

변경 뒤 문제가 생겼다면 여러 역할을 한꺼번에 바꾸지 마세요. 변경 전 기록을 보고 마지막으로 정상 작동한 설정으로 되돌릴지 관리자와 결정합니다. 필요한 승인과 작업 영향을 확인해 복구한 뒤, Agent 상태와 앞의 작은 요청을 다시 확인하세요.

모델을 비교할 때는 같은 요청으로 답변을 살펴보고 비용과 응답 시간도 기록해 보세요. Guide는 Analytics에서 비용·오류·응답 지연을 추적하도록 안내합니다.[1] 처음에는 이 가상 문서 한 건부터 시작해도 충분합니다. 결과가 만족스러우면 실제 맡길 업무에 가까운 작은 요청으로 확인 범위를 넓혀 가세요.

출처

ClawPod Guide — Provider와 model 선택 — 역할, AI 서비스 연결, 변경 절차, 로컬 모델과 응답 확인.
ClawPod Guide — HEARTBEAT.md와 주기 점검 — 점검 지침과 실행 조건.

Source: ClawPod Guide — guides/select-models; guides/configure-heartbeat