BRYZE 위키

회사와 브랜드의 기준, 함께 쌓는 지식

사용자 도구

사이트 도구


ai:assistant_ops_manual_sample

문서의 이전 판입니다!


메뉴얼샘플

에이전트가 반복 업무를 안정적으로 수행하도록 하기 위한 매뉴얼 문서 샘플입니다. 실제 운영 시에는 작업 목적, 판단 기준, 예외처리, 보고 방식까지 문서에 고정해두는 것이 좋습니다.

왜 필요한가

  • 같은 작업을 여러 번 시켜도 결과 품질을 최대한 균일하게 유지할 수 있습니다.
  • 크론/자동화 작업에서 문맥 누락으로 인한 오작동을 줄일 수 있습니다.
  • 담당자가 바뀌어도 업무 맥락을 빠르게 이어받을 수 있습니다.

작성 원칙

  • 작업 목적을 먼저 적습니다.
  • 필요한 도구와 접근 경로를 명시합니다.
  • 분류 기준과 예외 규칙을 숫자/시간 기준으로 고정합니다.
  • 최종 보고 형식을 예시까지 포함해 둡니다.
  • 비밀번호, 토큰, 개인 인증정보는 문서 본문에 직접 쓰지 않습니다.

권장 문서 구조

  1. 목적
  2. 사용 도구
  3. 접속/진입 경로
  4. 확인 기준
  5. 분류 기준
  6. 보고 방식
  7. 예외 처리 / 실패 사례
  8. 실제 작업 절차
  9. 구현 시 체크포인트
  10. 권장 산출물

예시: 출근 점검 업무 매뉴얼 구조

1. 목적

  • ECOUNT 출근기록과 Google Calendar를 함께 확인해 전 직원의 당일 출근 상태를 분류합니다.
  • 필요 시 지정 대상에게만 별도 안내 메시지를 보냅니다.

2. 사용 도구

  • Python + Playwright
  • Google Calendar
  • Google Chat 발송 도구
  • 사내 위키 조직도

3. 확인 기준

  • 지각자: 근태 예외 사유가 없고 출근 시간이 오전 9시 30분 이후인 경우
  • 근태이슈자: 오전 반차 / 오전반반차 / 연차 등 예외 사유가 확인되는 경우
  • 출근누락자: 예외 사유가 없고 출근 체크가 없는 경우
  • 정상출근자: 위 기준 외 정상 출근자

4. 보고 방식

  • 지각자
  • 근태이슈자
  • 출근누락자
  • 정상출근자
  • 가능하면 이름과 출근시간까지 함께 정리

5. 예외 처리

  • 메뉴 클릭이 실패하면 직접 해시 경로 진입 등 우회 절차를 문서화합니다.
  • 저장 버튼 클릭만으로 완료 처리하지 않고 반영 여부를 재확인합니다.
  • 여러 명 동시 처리보다 한 명씩 처리하는 우회안도 함께 기록합니다.

운영 팁

  • 크론에서 돌릴 작업은 특히 더 자세히 씁니다.
  • 구글 스프레드시트나 외부 문서를 참조해야 하면 웹 링크를 함께 남깁니다.
  • 애매한 표현보다 “누가 / 언제 / 무엇을 / 어떤 기준으로”를 명확히 적는 편이 안전합니다.

참고

  • 실제 출근 점검 업무용 세부 매뉴얼은 별도 운영 문서로 관리합니다.
  • 이 페이지는 새로운 업무 매뉴얼을 만들 때 복사해서 시작하는 샘플 템플릿 용도입니다.
ai/assistant_ops_manual_sample.1775766792.txt.gz · 마지막으로 수정됨: (바깥 편집)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki