AI 에이전트 실행 내역
AI 에이전트가 AI 에이전트 노드나 API에서 실행될 때마다 MonoChat은 해당 실행을 기록합니다. 어떤 하니스와 모델을 사용했는지, 어떤 요청을 받았는지, 모델과 도구를 어떻게 호출했는지, 예산을 얼마나 사용했는지, 그리고 어떻게 종료되었는지를 확인할 수 있습니다.
실행 내역은 설정 › 자동화 › AI 에이전트 실행 내역에서 확인할 수 있습니다. 이 메뉴 항목은 자동화 AI 에이전트 실행 조회 권한이 있는 사용자에게 표시됩니다.
실행 목록 표
| 열 | 표시 내용 |
|---|---|
| AI 하니스 | 에이전트를 실행한 하니스입니다. 마우스를 올리면 하니스 유형이 표시됩니다. |
| 상태 | 대기 중, 실행 중, 완료됨, 실패, 예산 초과, 시간 초과 또는 취소됨. 실패한 실행에 마우스를 올리면 오류가 표시됩니다. |
| 모델 호출 | 사용한 모델 호출 수 / 예산의 최대 모델 호출 수. |
| 도구 호출 | 사용한 도구 호출 수 / 예산의 최대 도구 호출 수. |
| 토큰 | 총 토큰 수. 마우스를 올리면 입력 토큰과 출력 토큰이 표시되며, 제공업체가 보고하는 경우 캐시 읽기와 쓰기도 표시됩니다. |
| 기간 | 실행에 걸린 시간. |
| 생성일 | 실행이 시작된 시점. |
각 행에는 버튼이 세 개 있습니다.
- ID 복사는 실행 ID를 복사합니다. 예를 들어
aiAgentRuns.show로 조회하거나 지원팀에 전달할 때 사용합니다. - 채팅은 해당 실행이 작업한 대화를 엽니다. 세션에 속한 실행에만 표시됩니다.
- 표시는 실행 상세 정보를 엽니다.
필터로 AI 하네스, 상태, 생성일(날짜 범위)별로 목록을 좁힐 수 있습니다. 표는 자동으로 업데이트되지 않으므로, 새 실행과 상태 변경을 불러오려면 표 머리글의 새로 고침 버튼을 사용하세요.
실행 상세 정보
표시를 누르면 AI 에이전트 실행 패널이 열립니다.
요약
| 행 | 표시 내용 |
|---|---|
| ID | 실행 ID와 복사 버튼. |
| AI 하니스 | 하니스 이름과 유형. |
| 상태 | 실행이 어떻게 종료되었는지, 또는 아직 대기 중이거나 실행 중인지. |
| 오류 | 완료되지 않은 실행의 오류 메시지. |
| 메인 모델, 대체 모델 (소프트 한도 이후), 빠른 모델 (가벼운 백그라운드 작업) | AI 모델을 사용하는 하니스에서 노드에 설정한 AI 모델. |
| 모델 (하니스의 허용된 모델 중 하나) | 호스팅 하니스의 모델. |
| 생성일, 시작 시각, 종료 일시 | 실행이 대기열에 들어가고, 시작되고, 끝난 시점. |
| 기간 | 사용한 시간 / 최대 실행 시간(초). |
| 모델 호출 | 사용한 호출 수 / 최대치. 소프트 한도가 설정된 경우 함께 표시됩니다. |
| 도구 호출 | 사용한 호출 수 / 최대치. |
| 토큰 | 입력 및 출력 토큰(캐시 토큰 포함)과 합계 / 최대 총 토큰 수. |
단계
단계에는 에이전트가 수행한 작업이 순서대로 나열되며, 오른쪽에는 실행이 시작된 후 경과한 시간이 표시됩니다.
| 단계 | 표시 내용 |
|---|---|
| 모델 호출 n | 모델, 입력 및 출력 토큰, 그리고 모델이 요청한 도구(요청된 도구: …) 또는 최종 답변. |
| 도구 호출 | 도구 이름과 소요 시간. |
| 대체 모델로 전환됨 | 실행이 소프트 한도에 도달하여 대체 모델로 계속 진행되었습니다. |
| 중간 메시지 | 에이전트가 작업 중에 작성한 메시지로, 고객에게 전송되었거나 귓속말로 추가된 것입니다. |
| 재시도 | 재시도된 실패한 모델 호출과 해당 오류. |
하니스가 단계를 보고하지 않으면 패널에 "이 실행에 기록된 단계가 없습니다."라고 표시됩니다.
지침, 입력, 결과, JSON 데이터
- 지침: 에이전트가 받은 노드의 지침입니다.
- 입력: 태그가 이미 채워진 작업 내용입니다.
- 결과: 에이전트의 최종 답변입니다.
- JSON 데이터: 실행 기록 전체입니다. 복사 버튼으로 개발자 또는 MonoChat 지원팀과 공유하세요.
에이전트 디버깅
| 확인되는 내용 | 점검할 사항 |
|---|---|
| 모델 호출이 최대치에 도달한 예산 초과 | 단계를 살펴보세요. 에이전트가 결론에 이르지 못하고 계속 도구를 호출한다면 지침과 도구 설명을 더 정확하게 작성하세요. 작업에 실제로 더 많은 단계가 필요하다면 최대 모델 호출 수를 늘리세요. |
| 토큰이 최대치에 도달한 예산 초과 | 긴 대화 기록이나 큰 도구 결과가 토큰 예산을 가득 채웁니다. 메시지 기록 한도를 낮추거나, 도구가 반환하는 데이터를 줄이거나, 최대 총 토큰 수를 늘리세요. |
| 도구 호출이 최대치에 도달한 예산 초과 | 에이전트가 허용된 것보다 많은 도구를 요청했습니다. 최대 도구 호출 수를 늘리거나, 지침에서 어떤 상황에 어떤 도구를 사용할지 알려 주세요. |
| 시간 초과 | 단계에서 도구 호출 소요 시간을 확인하세요. 느린 API나 MCP 서버가 **최대 실행 시간(초)**을 소진합니다. |
| "이 워크스페이스에서 AI 범위 또는 MCP 도구를 찾을 수 없습니다."라는 메시지와 함께 실패 | 노드에 연결된 범위 또는 MCP 도구가 삭제되었습니다. 노드의 도구 설정을 업데이트하세요. |
| "AI 하네스에서 허용하는 모델 중 하나를 선택해 주세요."라는 메시지와 함께 실패 | 노드의 모델이 호스팅 하니스의 허용된 모델에서 제거되었습니다. |
| "이 서버에서는 이 하니스를 사용할 수 없습니다."라는 메시지와 함께 실패 | 이 하니스는 MonoChat의 에이전트 러너가 필요한데 사용할 수 없습니다. 다른 하니스를 선택하세요. |
| 고객이 답변을 받지 못함 | 실행이 완료됨 상태인지, 노드에서 답변 보내기가 켜져 있는지, 결과가 비어 있지 않은지 확인하세요. |
| 고객이 원하지 않은 "생각 중" 메시지를 봄 | 중간 메시지를 고객에게 전달을 끄세요. 그러면 해당 메시지는 팀을 위한 귓속말로만 남습니다. |
팁
예산을 변경하기 전에 같은 노드의 실행 몇 건을 비교해 보세요. 에이전트에게 더 많은 여유가 필요한지, 더 나은 지침이 필요한지 단계에서 확인할 수 있습니다.