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)**リスクガバナンスを備えた、本番グレードの自律型Eコマース運用エージェントです。


📖 完全な技術ドキュメント

詳細なアーキテクチャ、用語、および**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. シフトレフト評価とトレーシング: 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.
      -