사용 가이드

본 데모의 목적·메뉴·AgentWorks 연계·MCP 도구 가이드

← 홈으로

1. 본 사이트의 목적

파이오링크 기술지원센터(TAC)의 7개 자동화 요청사항이 실제로 어떻게 동작하는지 보여주는 Phase A 프로토타입입니다. 파트너 포털·엔지니어 포털·Redmine 세 시스템과 AgentWorks가 한 흐름으로 묶이는 모습을 실제 데이터·LLM·RAG로 확인할 수 있도록 구성되어 있습니다.

  • 시연 목적 — 의사결정 단계에서 "이렇게 보일 것이다"의 추측을 줄이기 위한 실동작 프로토타입
  • 도입 검토 도구 — MCP 도구 시그니처·Gatekeeper 지점·데이터 egress 정책을 화면으로 검토 가능
  • 운영 전 단계 검증 — 운영 도입 시 어떤 API·도구 준비가 필요한지 본 문서로 합의
포털
3
파트너·엔지니어·Redmine
MCP 도구
19
3개 서버
요구사항 반영
7/7
01~07

3. AgentWorks와 어떻게 연계되어 사용되는가

본 데모는 AgentWorks의 사용 패턴을 3가지 모드로 나누어 보여줍니다.

A
채팅 위젯 임베드 — 파트너 포털
파트너 포털 우하단의 TAC 챗봇 버튼은 AgentWorks 채팅 서비스를 위젯 형태로 임베드한 형태를 가정합니다. 운영 시에는 AgentWorks가 제공하는 <iframe> 또는 Web Component로 교체됩니다. 데모에서는 정형 질의·1차 가이드의 실제 흐름을 함께 보여주기 위해 같은 백엔드를 사용해 구현해 두었습니다.
B
에이전트 사이드 패널 — 엔지니어 포털
케이스 상세 진입 시 AI 자동 분석이 자동 실행되며 Gemini가 MCP search_cases 도구로 유사 케이스를 찾아 근본 원인 가설·조치를 작성합니다. 운영에서는 AgentWorks의 "엔지니어 어시스턴트 에이전트"가 같은 역할을 합니다.
C
배치 에이전트 — 어드민 인사이트·정기 리포트
어드민 화면의 운영 인사이트와 정기 리포트는 통계 데이터를 요약·분석하는 별도의 에이전트가 주기적으로 실행되는 모습을 가정합니다. AgentWorks에서는 일·주·월 단위 스케줄 잡으로 등록되어 결과만 본 화면에 노출됩니다.
Phase A 사이클
파트너 챗봇이 모은 정형 질의 → 엔지니어 포털 케이스 등록 → AI 사이드 패널 즉시 분석 → Redmine 티켓 자동 생성 → Gatekeeper 검토 → 4종 발행 자료 작성·게시. 모든 단계가 본 데모에서 실제 동작합니다.

4. MCP 서버·도구 가이드 — 운영 도입 시 제공해야 할 도구

파이오링크의 3개 시스템은 각각 1개의 MCP 서버를 제공해야 합니다(도메인 경계 보존). 본 데모의 백엔드에 동일한 모양의 MCP 서버 3개가 mock으로 구현되어 있어 운영 도입 시 그대로 참조하시면 됩니다.

Partner Portal MCP4 tools
파트너 포털 → AgentWorks
파트너 권한·담당 고객사 컨텍스트 + 케이스 인계
list_partners전체 파트너 목록 (관리·시연용)
resolve_partner(session_token) — 현재 로그인된 파트너 식별
list_authorized_customers(partner_id) — 권한 내 고객사만 반환
list_partner_users(partner_id) — 파트너 직원 명부
+ 운영 도입 시 추가: 운영 도입 시 추가 필요: submit_case_draft (케이스 초안 인계), upload_artifact (파일 업로드 + egress 통제), notify_partner (메일·SMS·Slack 발송)
Engineer Portal MCP8 tools
TAC 엔지니어 포털 → AgentWorks
케이스 CRUD + RAG 검색 + 고객사 이력 + AI 코멘트
search_cases(query, top_k, device_model?, category?, customer_id?) — ★ 요구 01: pgvector 코사인 유사도
get_case(case_id) — 본문·메타·해결안
list_devices_of_customer(customer_id) — 등록 장비·펌웨어
get_customer_history(customer_id, time_range?) — ★ 요구 07: 누적 케이스 이력
list_customers전체 고객사 (관리용)
list_engineersTAC 엔지니어 명부
create_case(payload, source?, draft_id?) — 파트너 챗봇이 호출
add_case_comment(case_id, author_type, body) — AI 분석 결과를 코멘트로 첨부
+ 운영 도입 시 추가: 운영 도입 시 추가 필요: attach_analysis (요구 02 파일 분석), draft_notice / publish_notice (요구 03 — Gatekeeper 필수), classify_draft (요구 04 자동 분류)
Redmine MCP7 tools
Redmine → AgentWorks
티켓 CRUD + 메타 + 케이스 연동
list_trackersInquiry · Incident · Bug · Feature Request
list_statuses신규·진행·해결·종료 등 워크플로 상태
list_prioritiesLow · Normal · High · Urgent · Immediate
search_issues(query, tracker?, status?, project?, custom_fields?)
get_issue(issue_id) — 본문·작업일지·관계
create_issue_from_case(case_id, tracker, custom_fields) — 케이스 등록 시 자동 호출
add_issue_comment(issue_id, body, private?)
+ 운영 도입 시 추가: 운영 도입 시 추가 필요: update_issue (상태·담당자 변경), link_tickets (중복 이슈 병합 - 요구 04-c), query_stats (요구 05 통계 소스)
제공 책임 분담
파이오링크 측은 위 도구들을 노출하는 MCP 서버 3개만 운영하면 됩니다. 에이전트·UI·프롬프트는 AgentWorks 측이 담당. MCP 서버는 보안·감사·마스킹의 단일 지점으로 활용해야 데이터 egress 통제가 가능합니다.

5. 도입 로드맵·정책

A
2~4주 — 본 데모 범위
  • 06 파트너 챗봇 + 01 유사 이슈 RAG
  • MCP Phase 1 (Redmine + Engineer Portal 기본 도구)
현재
B
4~8주 — 자동화 확장
  • 04 자동 분류·Slack·Redmine 동기화
  • 02 파일 분석(.tsa/.dump 파서 추가)
  • 07 고객사 이력 메타데이터 정합화
C
8~12주 — 발행·통계
  • 03 Notice 초안 + Gatekeeper 안정화
  • 05 정기 통계 리포트 자동화·구독
Gatekeeper — 반드시 사람 검토
다음 지점에서는 AI가 단독으로 진행할 수 없습니다:
  • 케이스 등록 초안 → 엔지니어 검토 후 등록
  • 1차 원인 분석 보고서 → 검증 후 코멘트로 첨부
  • 파트너 공유 게시글 → 승인 후 외부 노출
  • 장애 Notice → 검토 후 게시 (요구 03)
  • RMA 승인 → 보증 확인 후 처리
데이터 egress 통제
운영 시 외부 LLM에 데이터를 보내기 전 MCP 서버 단에서 마스킹·감사 로그를 강제합니다. 시연 데모는 텍스트 직접 전달이지만, 실제 운영에서는 PII·로그 raw 데이터는 파이오링크 측 저장소에 보관하고 요약·참조 정보만 송신해야 합니다.

부록 — 참고 자료

  • D:\내 드라이브\파이오링크 기술지원센터 에이전트웍스 도입\ — 워크스페이스(요구사항 분석, MCP 검토, 와이어프레임, 빌드 결과)
  • AIAgent도입준비v2.pdf — 마인드맵 원본 (Phase 1~4 워크플로우)
  • /admin/policies — Gatekeeper·egress·AI 사용량 정책 화면