ai:assistant_ops_manual_sample
문서의 이전 판입니다!
목차
메뉴얼샘플
에이전트가 반복 업무를 안정적으로 수행하도록 하기 위한 매뉴얼 문서 샘플입니다. 실제 운영 시에는 작업 목적, 판단 기준, 예외처리, 보고 방식까지 문서에 고정해두는 것이 좋습니다.
왜 필요한가
- 같은 작업을 여러 번 시켜도 결과 품질을 최대한 균일하게 유지할 수 있습니다.
- 크론/자동화 작업에서 문맥 누락으로 인한 오작동을 줄일 수 있습니다.
- 담당자가 바뀌어도 업무 맥락을 빠르게 이어받을 수 있습니다.
작성 원칙
- 작업 목적을 먼저 적습니다.
- 필요한 도구와 접근 경로를 명시합니다.
- 분류 기준과 예외 규칙을 숫자/시간 기준으로 고정합니다.
- 최종 보고 형식을 예시까지 포함해 둡니다.
- 비밀번호, 토큰, 개인 인증정보는 문서 본문에 직접 쓰지 않습니다.
권장 문서 구조
- 목적
- 사용 도구
- 접속/진입 경로
- 확인 기준
- 분류 기준
- 보고 방식
- 예외 처리 / 실패 사례
- 실제 작업 절차
- 구현 시 체크포인트
- 권장 산출물
예시: 출근 점검 업무 매뉴얼 구조
1. 목적
- ECOUNT 출근기록과 Google Calendar를 함께 확인해 전 직원의 당일 출근 상태를 분류합니다.
- 필요 시 지정 대상에게만 별도 안내 메시지를 보냅니다.
2. 사용 도구
- Python + Playwright
- Google Calendar
- Google Chat 발송 도구
- 사내 위키 조직도
3. 확인 기준
- 지각자: 근태 예외 사유가 없고 출근 시간이 오전 9시 30분 이후인 경우
- 근태이슈자: 오전 반차 / 오전반반차 / 연차 등 예외 사유가 확인되는 경우
- 출근누락자: 예외 사유가 없고 출근 체크가 없는 경우
- 정상출근자: 위 기준 외 정상 출근자
4. 보고 방식
- 지각자
- 근태이슈자
- 출근누락자
- 정상출근자
- 가능하면 이름과 출근시간까지 함께 정리
5. 예외 처리
- 메뉴 클릭이 실패하면 직접 해시 경로 진입 등 우회 절차를 문서화합니다.
- 저장 버튼 클릭만으로 완료 처리하지 않고 반영 여부를 재확인합니다.
- 여러 명 동시 처리보다 한 명씩 처리하는 우회안도 함께 기록합니다.
운영 팁
- 크론에서 돌릴 작업은 특히 더 자세히 씁니다.
- 구글 스프레드시트나 외부 문서를 참조해야 하면 웹 링크를 함께 남깁니다.
- 애매한 표현보다 “누가 / 언제 / 무엇을 / 어떤 기준으로”를 명확히 적는 편이 안전합니다.
참고
- 실제 출근 점검 업무용 세부 매뉴얼은 별도 운영 문서로 관리합니다.
- 이 페이지는 새로운 업무 매뉴얼을 만들 때 복사해서 시작하는 샘플 템플릿 용도입니다.
ai/assistant_ops_manual_sample.1775766792.txt.gz · 마지막으로 수정됨: (바깥 편집)