7.1. 운영 점검
개요
운영 점검은 문제가 있는 곳을 정해진 순서로 찾아 가는 일입니다. 대시보드에서 숫자를 보고, 숫자가 0 이 아니면 예약 작업, 메신저 연결, API 키·토큰 화면에서 원인을 확인합니다.
권한: 관리자. 대시보드 위쪽의 전체 구역과 이 장의 조치(게이트웨이 시작·중지 등)는 관리자만 할 수 있습니다.
용어는 A.3. 용어 사전에 있습니다. 이 장에서 쓰는 말은 다음과 같습니다.
- AI 에이전트 작업공간: 사용자마다 하나씩 만들어지는 AI 에이전트의 일터입니다. 설정, 스킬, 기억, 파일이 들어 있습니다.
- 프로파일: 작업공간 안의 AI 에이전트 한 명의 설정 묶음입니다.
- 게이트웨이: AI 에이전트가 메신저와 예약 작업을 받는 통로입니다.
언제 점검하나
| 상황 | 할 일 |
|---|---|
| 정기 점검(하루 한 번 또는 주 한 번) | 1단계로 대시보드의 숫자를 봅니다. 모두 0 이면 끝납니다. 0 이 아닌 숫자가 있으면 해당 단계로 갑니다. |
| 「AI 에이전트가 답하지 않는다」는 신고 | 1단계 「운영 정보」의 LiteLLM 상태와 해당 작업공간의 준비 상태를 봅니다. 그다음 A.2. 문제 해결을 봅니다. |
| 「알림이나 예약 작업이 오지 않는다」는 신고 | 2단계와 3단계를 봅니다. |
| 「키가 만료됐다」는 신고 | 4단계를 봅니다. |
메뉴 숫자 읽기
왼쪽 메뉴의 숫자는 점검이 필요한 곳을 알려 줍니다.
| 메뉴 | 숫자 색 | 뜻 |
|---|---|---|
| 채팅 | 주황 | 답이나 승인을 기다리는 대화 수 |
| 프로파일 | 주황 | 관리자의 처리를 기다리는 요청 수 |
| 스킬 허브 | 회색 | 새 버전으로 올릴 수 있는 스킬 수 |
| 예약 작업 | 빨강 | 지금도 실패 중인 문제와 마지막 실행이 실패한 작업 |
| API 키·토큰 | 빨강 | 만료된 키·토큰 |
| Claude Code 연결 | 빨강 | 본인이 만든 연결 중 7일 안에 끝나는 수동 토큰 |
묶음 제목에는 안에 있는 숫자의 합이 나옵니다. 스킬 허브의 회색 숫자는 고장이 아니라서 묶음 제목에는 더하지 않습니다. 「Claude Code 연결」 숫자는 본인 연결만 셉니다. 다른 사람의 연결은 7.4. Claude Code 연결 관리에서 확인합니다.
점검 순서
| 순서 | 화면 | 보는 것 |
|---|---|---|
| 1 | 대시보드 | 전체 AI 에이전트 작업공간의 상태와 문제 수 |
| 2 | 자동화 › 예약 작업 | 실패하거나 멈춘 작업 |
| 3 | 자동화 › 메신저 연결 | 게이트웨이와 메신저 연결 상태 |
| 4 | 설정 › API 키·토큰 | 만료됐거나 곧 만료되는 값 |
예약 작업, 메신저 연결, API 키·토큰 화면은 「지금 보는 AI 에이전트 작업공간」의 내용을 보여 줍니다. 다른 작업공간을 점검하려면 먼저 작업공간을 바꿉니다. 상단 막대의 「AI 에이전트 작업공간 바 꾸기」나 대시보드의 표를 씁니다.
1단계: 대시보드 보기
「대시보드」 위쪽 「전체 AI 에이전트 작업공간」 구역의 숫자 카드 네 개를 봅니다. 구역 전체의 읽는 법은 1.3. 관리자 대시보드에 있습니다. 0 이 아닌 카드를 누르면 다음 단계로 이어집니다.
| 카드 | 뜻 | 누르면 | 다음 단계 |
|---|---|---|---|
| AI 에이전트 작업공간 준비 | 준비된 작업공간 수 / 전체 수 | 「AI 에이전트 작업공간」 화면 | 3.2. 작업공간 상태와 다시 시작 |
| 실패·멈춘 작업 | 마지막 실행이 실패한 작업과 멈춘 작업의 합 | 표를 해당 작업공간으로 거름 | 2단계 |
| 문제 있는 프로파일 | 메신저 연결에 문제가 있는 프로파일 수 | 표를 해당 작업공간으로 거름 | 3단계 |
| 만료된 API 키·토큰 | 만료됐거나 곧 만료되는 키·토큰 수 | 「API 키·토큰」 화면 | 4단계 |
숫자 대신 줄 표시(-)가 나오면 첫 수집 전입니다. 「N개 중 N개 기준 · N개 수집 실패」가 나오면 합계에서 일부 작업공간이 빠졌습니다. 그 문구를 누르면 수집에 실패한 작업공간만 거릅니다. 거름을 풀려면 표 위의 거름 표시에서 닫기를 누릅니다.
표의 행을 누르면 그 작업공간으로 바뀌고 아래쪽 「지금 AI 에이전트 작업공간」 구역으로 이동 합니다. 준비되지 않은 작업공간은 바뀌지 않습니다.
운영 정보 읽기
위쪽 구역의 「운영 정보」 한 줄에 서비스 상태가 나옵니다.
| 운영 정보 문구 | 뜻 | 조치 |
|---|---|---|
| LiteLLM 정상 | 모델 서버에 연결됩니다. | 없음 |
| LiteLLM 연결 안 됨 | 모델 서버에 닿지 않습니다. 대화 답이 나오지 않을 수 있습니다. | 운영자에게 알립니다. 4.1. 모델과 A.2. 문제 해결을 봅니다. |
| 스킬 허브 배달기 정상 | 스킬 설치 요청을 처리하는 도우미가 동작합니다. | 없음 |
| 스킬 허브 배달기 멈춤 | 스킬 설치 요청이 처리되지 않습니다. | 운영자에게 알립니다. A.2. 문제 해결을 봅니다. |
그림 7.1-1. 「운영 정보」 한 줄
참고: 대시보드의 숫자는 주기적으로 수집한 값입니다. 문제를 고쳐도 숫자가 바로 줄지 않을 수 있습니다. 「다음 수집」 시각이 나오면 첫 수집 전입니다.
성공하면 네 숫자가 모두 0 이고 「LiteLLM 정상」이 보입니다. 숫자가 줄지 않으면 수집 시각이 지난 뒤 다시 엽니다.
2단계: 예약 작업 확인하기
- 점검할 AI 에이전트 작업공간으로 바꿉니다.
- 왼쪽 메뉴의 「자동화 › 예약 작업」을 엽니다. 메뉴에 빨간 숫자가 있으면 지금도 실패 중인 문제가 있다는 뜻입니다.
- 아래 탭을 차례로 봅니다.
그림 7.1-2. 예약 작업 화면
| 탭 | 내용 |
|---|---|
| 마지막 실행 실패 | 마지막 실행이 실패한 작업 |
| 실패 중인 문제 | 지금도 실패가 이어지는 문제 |
| 멈춘 작업 | 정해진 실행 시각이 지났는데 실행되지 않은 작업 |
| 알림 없는 작업 | 알림 대상이 없어 실패해도 알림이 가지 않는 작업 |
| 이미 해결된 문제 | 「확인했습니다」만 누르면 「확인할 것」에서 빠지는 문제 |
- 행을 눌러 실패 이유와 실행 기록을 확인합니다.
예약 작업을 중지하거나 고치는 일은 관리자, 작업공간 주인, 팀 관리자가 할 수 있습니다. 「멈춘 작업」이 여러 개이면 3단계로 가서 게이트웨이가 중지됐는지 봅니다. 성공하면 「실패 중인 문 제」 탭이 비어 있습니다.
3단계: 메신저 연결 확인하기
- 왼쪽 메뉴의 「자동화 › 메신저 연결」을 엽니다. 이 화면은 읽기 전용이고 토큰 값은 읽지 않습니다.
- 「주의 채널」과 「확인할 것」을 봅니다.
- 게이트웨이가 「중지됨」이면 그 프로파일의 예약 작업과 메신저 연결이 동작하지 않습니다. 프로파일의 서랍(오른쪽에서 열리는 상세 창)을 열고 「개요」 탭 「게이트웨이」 구역의 「시작」을 누릅니다. 게이트웨이 시작·중지는 관리자만 할 수 있습니다. 관리자가 아니면 같은 자리에 「관리자만 바꿀 수 있습니다.」가 보입니다.
- 게이트웨이는 「실행 중」인데 메신저가 끊겼으면 프로파일 상세 창의 「채널」 탭에서 다시 연결합니다.
그림 7.1-3. 메신저 연결 화면
작업공간의 기본 게이트웨이를 함께 쓰는 프로파일에는 「시작」과 「중지」가 없고 「재시작」만 있습니다. 재시작하면 그 작업공간의 모든 프로파일의 채널과 예약 작업이 잠시 멈춥니다. 요청 뒤 상태가 바뀌기까지 몇 초 걸립니다.
성공하면 게이트웨이 상태가 「실행 중」으로 바뀝니다. 바뀌지 않으 면 운영자에게 알립니다.
참고: 사용자가 게이트웨이를 켜 달라고 하면 관리자가 대신 합니다. 어느 프로파일인지 이름을 물어 같은 방법으로 시작합니다.
4단계: API 키·토큰 만료 확인하기
- 왼쪽 메뉴의 「설정 › API 키·토큰」을 엽니다. 메뉴에 빨간 숫자가 있으면 만료된 값이 있습니다.
- 「만료·만료 임박」 카드를 누릅니다. 카드 아래에 「14일 이내 포함」이 나옵니다.
- 「빈 값」 카드로 이름만 있고 값이 비어 있는 항목도 확인합니다.
- 행을 누르면 값을 넣는 곳을 알려 줍니다.
그림 7.1-4. API 키·토큰 화면
값은 화면에 나오지 않습니다. 이름, 위치, 채워져 있는지, 만료일, 같은 값의 중복 여부만 보여 줍니다. 상태·담당·메모 기록은 관리자만 남깁니다. 만료된 값을 새로 넣는 일은 그 키를 쓰는 사용자나 관리자가 합니다. 성공하면 「만료·만료 임박」 카드가 0 이 됩니다.
그림 7.1-5. API 키·토큰 서랍