Skip to main content
Glama
Shopify AI Ops Agent

Shopify AI Ops Agent

🛍️ Shopify AI Operations Agent

Python 3.11+ FastAPI LangGraph License: MIT

LangGraph v1, Model Context Protocol (MCP 2026-07-28), FastAPI, PostgreSQL + pgvector, Redis, OpenTelemetry, 그리고 엄격한 Human-in-the-Loop (HITL) 리스크 거버넌스를 기반으로 구축된 프로덕션급 자율 전자상거래 운영 에이전트입니다.


📖 전체 기술 문서

심층 아키텍처, 용어, 그리고 **ASD-STE100 (Simplified Technical English)**로 작성된 아키텍처 결정 기록(ADR)에 대한 자세한 내용은 다음을 참조하세요: 👉 DOCUMENTATION.md

시각 프레젠테이션 PDF 다운로드: 👉 architecture_diagram.pdf (또는 http://localhost:8000/architecture.pdf 에서 확인 가능)


Related MCP server: MCP Shopify

🏗️ 핵심 아키텍처 불변식

  1. 실행 전 리스크 및 정책 게이트: 파괴적 삭제, 재무 예산, 아웃바운드 커뮤니케이션은 인간의 승인을 요구하는 LangGraph 인터럽트(interrupt_before)를 트리거합니다.

  2. 분리된 MCP 도구 계층: 모든 비즈니스 기능은 5개의 무상태 MCP 도구 서버(Shopify, Analytics, Meta Ads, Communications, Trend Intelligence)로 패키징됩니다.

  3. 결정적 비즈니스 분석: 재무 지표는 결정적 SQL 루틴으로 계산되어 LLM 산술 환각을 제거합니다.

  4. 조기 성공 선언 방지 센서: 에이전트는 완료를 보고하기 전에 변경 사항이 실제로 발생했는지 수학적으로 검증하기 위해 실시간 상태를 다시 조회합니다.

  5. Shift-Left 평가 및 추적: 28개의 자동화된 pytest 테스트 스위트, 17개 사례의 골든 평가 벤치마크, 그리고 독립적인 Critic Agent 감사(점수: 98.5/100, 등급: A+).


📁 리포지토리 구조

shopify-ai-ops-agent/
├── DOCUMENTATION.md           # Full technical documentation (ASD-STE100)
├── architecture_diagram.pdf   # 2-slide landscape architecture diagram
├── docker-compose.yml         # Postgres (pgvector) + Redis + Jaeger + API
├── pyproject.toml             # Dependencies & packaging
├── app/
│   ├── api/                   # FastAPI routes (agent, approvals, health)
│   ├── agent/                 # LangGraph state machine & specialized nodes
│   ├── mcp_servers/           # 5 Stateless MCP tool servers
│   ├── core/                  # Security (HMAC-SHA256), Idempotency, Database
│   ├── rag/                   # Hybrid Vector + BM25 search & brand guidelines
│   ├── static/                # Executive SaaS Cockpit UI & Command Palette
│   └── evals/                 # Golden datasets & Critic Agent audit
└── tests/                     # 28 automated unit, safety, and integration tests

🚀 빠른 시작 및 설정

1. 로컬 개발

# Install dependencies
pip install -r requirements.txt

# Start the application server & dashboard
python -m uvicorn app.api.main:app --reload --port 8000
  • 대시보드 UI: http://localhost:8000/ (Ctrl + K 를 누르면 명령 팔레트가 열립니다)

  • 대화형 API 문서: http://localhost:8000/docs

  • 아키텍처 PDF: http://localhost:8000/architecture.pdf


🧪 검증 및 평가

# Run full automated test suite (28 tests)
python -m pytest tests/ -v

# Run independent Critic Agent technical audit
python -m app.evals.judge_agent

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      A Shopify-focused MCP server that enables AI agents to manage store operations like order tracking, product discovery, and checkout link generation. It facilitates customer-facing interactions including shipping estimates and real-time inventory searches.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      A comprehensive MCP server for Shopify Admin API integration, enabling AI assistants to manage products, orders, customers, inventory, analytics, and more through natural language.
      19 npm
      20
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Hosted MCP server connecting Shopify, Klaviyo, GA4, Meta Ads, Google Ads, Xero, Gorgias and 20+ e-commerce data sources so AI assistants can answer merchant questions that span every source at once.
      -