차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

--- ai:assistant_ops_cron [2026-04-09 14:47] – 요청 문구와 기존 구체적 예시 중심으로 크론잡 문서 재정리 [기존 위키에서 이전] 172.19.176.1
+++ ai:assistant_ops_cron [2026-10-30 14:55] (현재) – 바깥 편집 127.0.0.1
@@ 줄 1: / 줄 1: @@
 ====== 크론잡 ======
-멀티에이전트환경에서 크론잡은 목적지에대한 정보가 없으면 남한테 결과보고가 가는경우가 있다.
+멀티에이전트 환경에서 크론잡 등록 시에는 목적지에 대한 정보를 반드시 포함해야 한다.
-대화가 길어져서 컨텍스트가 길면 과거 대화내용 참조가 힘들어져 두루뭉술하게 작성한 크론잡은 실패할 확률이 높다.
-그에 대비해서 메뉴얼md 문서를 매우 자세히 기술해두었다가 크론잡이 돌 때 그 문서를 읽도록 지침에 추가하면 오차없이 균일한 결과를 낼수있다.
-복잡한 작업을 해야하는 크론잡같은경우에는 업무 단계를 나누어 쪼개서 작업시키는게 좋다.
-===== 예시 1: 스프레드시트 요약 보고 =====
+메뉴얼.md 문서는 작업자가 그대로 따라도 오차가 없도록 자세히 작성해야 한다.
-예를 들어 매일 오전 9시에,
-특정 Google 스프레드시트의 전일 실적 현황을 읽어 윤성용 대리 개인 Google Chat DM으로 보내는 크론이 있다고 가정합니다.
-작업 조건:
+복잡한 작업을 수행하는 크론잡은 업무 단계를 나누어 설계해야 한다.
-  * 실행 시각: 매일 09:00
-  * 실행 에이전트: sungyong
-  * 채널: googlechat
-  * accountId: acc_sungyong
-  * 목적지 chat_id: googlechat:spaces/i_UnlSAAAAE
-  * 대상 문서: 전일 실적 스프레드시트
-  * 결과 형식: 3줄 요약 + 이슈 항목 bullet
-좋지 않은 방식:
+구글드라이브 스프레드시트를 참조할 때에는 웹버전 페이지 주소를 함께 기재해야 한다.
-  * 스프레드시트를 읽는다
-  * 여러 표를 한 번에 해석한다
-  * 결과를 바로 요약한다
-  * 바로 DM으로 보낸다
-이 방식의 문제:
+결과 보고 및 진척 상황 확인을 위해 외부 스프레드시트에 기록하도록 설계해야 한다.
-  * 표 구조를 잘못 읽어도 중간 점검이 없음
-  * 어느 표에서 오류가 났는지 추적이 어려움
-  * 목적지 검증 없이 발송될 수 있음
-권장 방식:
+메뉴얼은 크론잡 등록 전 수 번 테스트하면서 시행착오를 직접 업데이트하라고 지시한다.
-  * 1단계: 지정된 스프레드시트에서 오늘 읽어야 할 시트 이름과 범위를 확인한다
-  * 2단계: 시트 안의 ''◆'' 문자를 기준으로 큰 표를 분리한다
-  * 3단계: 각 큰 표 안에서 ''▶'', ''■'', ''▷'' 구조를 분석해 내부 헤더와 내부표를 정리한다
-  * 4단계: 각 표별로 핵심 수치, 누락값, 이상값만 추출한다
-  * 5단계: 표별 추출 결과를 임시 JSON 또는 중간 텍스트 결과로 저장한다
-  * 6단계: 저장된 중간 결과를 읽어 최종 보고 형식(3줄 요약 + 이슈 목록)으로 변환한다
-  * 7단계: 발송 직전에 accountId, chat_id, 채널이 문서에 적힌 값과 일치하는지 다시 검증한다
-  * 8단계: 검증이 끝난 경우에만 DM 발송한다
-예시 보고 형식:
+크론잡을 수행해야 할 때 사용해야 하는 도구를 명시해야 한다. 어떤 도구를 사용해야 할지 모를 때에는 비서에게 지시하고 어떤 도구를 사용했는지 물어보면 된다.
-  * 전일 매출 합계: 12,430,000원
-  * 출고 지연 건수: 3건
-  * 확인 필요 이슈: 재고 누락 1건 / 정산 미반영 2건
-===== 예시 2: 정기 알림 + 예외 감지 =====
-예를 들어 평일 오후 6시에,
-사내 운영 데이터에서 이상 징후가 있는 항목만 골라 운영 담당자에게 알림을 보내는 크론이 있다고 가정합니다.
-작업 조건:
-  * 실행 시각: 평일 18:00
-  * 실행 에이전트: sungyong
-  * 채널: googlechat
-  * accountId: acc_sungyong
-  * 목적지 chat_id: googlechat:spaces/i_UnlSAAAAE
-  * 입력 데이터: 당일 주문 / 재고 / 정산 상태 데이터
-  * 발송 조건: 예외 항목이 1건 이상일 때만 발송
-좋지 않은 방식:
-  * 데이터를 읽는다
-  * 이상한 것 같으면 적당히 골라낸다
-  * 바로 알림 문구를 만들어 발송한다
-이 방식의 문제:
-  * "이상"의 기준이 모호함
-  * 어떤 조건으로 발송됐는지 재현이 어려움
-  * 예외 없음에도 불필요한 메시지가 나갈 수 있음
-권장 방식:
-  * 1단계: 주문/재고/정산 데이터를 각각 지정된 소스에서 조회한다
-  * 2단계: 데이터 형식을 통일해 하나의 비교 가능한 목록으로 정리한다
-  * 3단계: 아래 기준으로 예외 후보를 추린다
-    * 주문 상태가 출고대기인데 24시간 이상 변화 없음
-    * 재고 수량이 0 이하인데 판매 가능 상태로 표시됨
-    * 정산 완료 예정일이 지났는데 정산 상태가 미완료임
-  * 4단계: 예외 후보 중 중복 항목을 제거하고 실제 발송 대상만 남긴다
-  * 5단계: 예외 건수가 0건이면 발송하지 않고 로그만 남긴다
-  * 6단계: 예외 건수가 1건 이상이면 항목별로 짧은 요약 문구를 만든다
-  * 7단계: 발송 직전에 목적지 chat_id와 accountId를 재검증한다
-  * 8단계: 검증 완료 후에만 운영 담당자에게 발송한다
-예시 알림 형식:
-  * [운영 예외 3건]
-  * 주문 10293: 출고대기 31시간 지속
-  * 상품 DR-201: 재고 0인데 판매 가능으로 노출
-  * 정산건 ST-88: 예정일 경과, 아직 미완료