이 문서는 멀티 에이전트 환경에서 크론잡을 설계·운영하는 사람이 반드시 확인해야 할 주의사항을 정리한 가이드입니다. 핵심 목적은 자동 실행은 되었지만 결과가 잘못된 대상에게 전달되는 사고를 줄이는 것입니다.

특히 여러 에이전트가 함께 동작하는 환경에서는, 단순히 작업이 성공했는지만 볼 것이 아니라 어느 에이전트가 실행했는지, 어느 계정으로 동작했는지, 누구에게 결과가 전달되는지를 사람이 명확하게 통제해야 합니다.

크론잡은 한 번 설정해두면 반복 실행됩니다. 따라서 설정이 잘못된 상태로 배포되면 같은 문제가 계속 반복될 수 있습니다.

멀티 에이전트 환경에서는 특히 아래와 같은 사고가 발생할 수 있습니다.

• A 사용자를 위한 결과가 B 사용자에게 전달됨
• 테스트용 메시지가 실제 운영 채널로 발송됨
• 다른 에이전트의 계정/설정을 참조해 잘못 동작함
• 대상 정보가 비어 있는데도 기본값으로 발송됨

이 문서는 이런 종류의 운영 실수를 예방하기 위한 사람 중심 체크리스트입니다.

크론잡은 누가 실행하느냐보다, 결과가 정확히 어디로 가느냐를 더 엄격하게 관리해야 합니다.

운영자가 반드시 지켜야 할 기본 원칙은 아래와 같습니다.

• 목적지 정보가 불명확하면 보내지 않는다.
• 기본값에 기대지 않는다.
• 최근 대화나 마지막 세션 정보를 재사용하지 않는다.
• 이름이 아니라 식별자 기준으로 목적지를 관리한다.
• 테스트와 운영 목적지를 절대 섞지 않는다.

즉, 애매하면 발송하지 않는 것이 일단 보내고 나중에 수정하는 것보다 훨씬 안전합니다.

가장 위험한 경우는 결과를 보낼 대상 정보가 빠져 있는데, 시스템이 임의의 기본값이나 이전 컨텍스트를 사용해 메시지를 보내는 경우입니다.

예시:

• chat_id 없이 발송
• accountId 없이 발송
• 대상 세션 정보 없이 마지막 세션에 의존

이 경우 운영자는 왜 저 사람에게 갔는지 원인을 추적하기 어렵고, 수신자는 예상하지 못한 메시지를 받게 됩니다.

처음에는 테스트 채널로 보내던 크론잡이, 설정 변경 후 운영 채널로 그대로 나가는 경우가 있습니다.

예시:

• 테스트용 목적지를 운영 목적지로 덮어씀
• 검증용 계정으로 만들었는데 실제 계정으로 전송됨

멀티 에이전트 환경에서는 비슷한 이름의 세션이나 설정이 존재할 수 있습니다. 이때 마지막 값 재사용 방식은 매우 위험합니다.

예시:

• 다른 에이전트의 accountId 사용
• 다른 세션의 delivery context 재사용
• 동일 이름 사용자 간 혼동

크론잡을 설계하거나 검토할 때 아래 정보는 필수 항목으로 봐야 합니다.

• 실행 에이전트 ID
• 채널 종류 (예: googlechat, discord, telegram)
• accountId
• 정확한 목적지 식별자 (chat_id 또는 sessionKey 등)
• 개인 대상인지 그룹 대상인지
• 목적지 누락 시 어떻게 처리할지
• 실패 시 재시도 여부
• 중복 발송 방지 기준

이 항목 중 하나라도 비어 있다면, 운영 관점에서는 완성되지 않은 크론으로 보는 것이 안전합니다.

사람 이름, 채널 이름, 별칭은 바뀌거나 중복될 수 있습니다. 가능하면 아래처럼 식별자를 직접 관리하는 편이 안전합니다.

• 이름보다 chat_id
• 별칭보다 sessionKey
• 감으로 아는 계정보다 accountId

목적지가 비어 있거나 애매한데도 발송되게 두면 사고 가능성이 큽니다. 운영자는 전송 실패를 두려워하기보다 오발송을 더 위험하게 봐야 합니다.

즉,

• 목적지 없음 → 발송 금지
• accountId 없음 → 발송 금지
• 채널 불명확 → 발송 금지

이런 규칙이 기본이어야 합니다.

테스트 중인 크론잡은 반드시 별도 목적지에서 검증해야 합니다.

권장 방식:

• 테스트용 채널 별도 운영
• 테스트용 accountId 별도 확인
• 실제 대상과 동일한 이름을 가진 테스트 대상을 만들지 않기

가능하면 크론잡을 아래처럼 나눠 생각하는 것이 좋습니다.

• 1단계: 정보 조회 / 분석 / 정리
• 2단계: 목적지 검증 / 발송

이렇게 하면 조회는 성공했더라도, 목적지 검증에 실패하면 발송만 중단할 수 있습니다.

아래 항목은 실제 배포 전에 반드시 사람이 확인해야 합니다.

• 이 크론은 어떤 에이전트가 실행하는가?
• 어떤 계정으로 메시지를 보내는가?
• 목적지 식별자가 정확히 입력되어 있는가?
• 목적지가 개인인지 그룹인지 명확한가?
• 목적지 정보가 없을 때 발송이 막히는가?
• 테스트 채널에서 먼저 검증했는가?
• 동일 메시지 중복 전송 방지 기준이 있는가?
• 문제가 생기면 즉시 중단할 수 있는가?

이 체크리스트를 통과하지 못하면 운영 배포를 보류하는 것이 안전합니다.

아래 방식은 편해 보여도 멀티 에이전트 환경에서는 사고 가능성이 높습니다.

• 최근 대화 상대를 목적지로 간주하는 방식
• 마지막 활성 세션을 재사용하는 방식
• 사람 이름만 보고 목적지를 고르는 방식
• 기본 계정에 의존하는 방식
• 테스트와 운영을 같은 채널에서 진행하는 방식
• 실패 원인 기록 없이 자동 재시도만 반복하는 방식

크론잡을 만들 때는 최소한 아래 수준으로 문서화하는 것이 좋습니다.

• 실행 에이전트: sungyong
• 채널: googlechat
• accountId: acc_sungyong
• 목적지 chat_id: googlechat:spaces/XXXXX
• 대상 유형: 개인 DM / 그룹 채널
• 목적지 누락 시 동작: 발송 금지 및 로그 기록
• 중복 방지 기준: 동일 키 1회만 전송
• 테스트 목적지: 별도 검증 채널 사용

이 문서화가 되어 있어야, 나중에 문제가 생겼을 때 운영자가 원인을 빠르게 추적할 수 있습니다.

멀티 에이전트 환경에서 크론잡 운영의 핵심은 자동 실행 자체가 아니라, 정확한 계정과 정확한 목적지로만 안전하게 보내는 것입니다.

특히 목적지 정보가 불명확한 상태에서는 보내지 않는 것이 기본 원칙이며, 이 원칙이 오발송과 운영 사고를 줄이는 가장 중요한 안전장치입니다.