DeskKit — Razorpay AI Buildathon 向けエージェンティックコマース

Track 1: AIグロース & エージェンティックコマース

AIバイヤーがマーチャント（DeskKit）とエンドツーエンドで取引できるようにする自律型調達エージェントです。すべてのマネーアクションは説明可能・上限付き・承認ゲート付きで、ライブの監査証跡も備わります。

できること

DeskKit は Razorpay 上の小さなオフィス用品マーチャントです。このプロジェクトは、以下のことを行う AI エージェントを構築します：

• MCP ツールインターフェースを介して DeskKit のカタログを閲覧します（エージェントが読み取り可能なカタログ）

• 購入について推論し、実際の Razorpay テストモード注文を実行します

• 厳格な月次予算を2段階のゲートで適用します：₹3,000 未満は自動承認、それを超える場合は手動承認が必要、₹5,000/月 を超える場合はハードブロック

• 支出をセッション間で永続化します — 予算は実行ごとにリセットされるのではなく、実際に月次制限として機能します

• 購入成功後、関連商品を積極的に提案します（アップセル/クロスセル）

• 2つ目の AI エージェントが含まれており、調達リクエストを自律的に生成します — 人間対エージェントだけでなく、真のエージェント間コマースを実証します

すべての決定は LangSmith でトレースされ、完全な監査証跡が残ります。また、承認済み/保留中/ブロック済みの件数と注文履歴を表示する Monthly Ledger ダッシュボード にライブで可視化されます。

Related MCP server: Cashfree CLI

このトラックに合致する理由

"すべてのマネーアクションは説明可能・上限付き・承認ゲート付きであること。監査証跡を示し、1つの障害を優雅に処理すること。"

このプロジェクトは、4つの異なる障害/エッジケースを優雅に処理します：予算ブロック、承認ゲート、カタログにない商品のリクエスト、過大なスコープのエージェント間リクエストの部分的な履行 — それぞれ明確な理由と現実的な代替案を示し、黙って失敗したり強制的に上書きしたりすることはありません。

アーキテクチャ

リクエスタエージェント（AIバイヤー） ──> LangGraph ReAct Agent ──> MCP ツールレイヤー ──> Razorpay テストモード API │ │ │ ├── get_catalog │ └── create_order（予算ゲート付き） │ └──> LangSmith（監査証跡）

技術スタック

• FastAPI — バックエンド + UI

• LangGraph（ReAct エージェントパターン）— 推論とツールオーケストレーション

• MCP（Model Context Protocol） — カタログとチェックアウトをエージェントが呼び出し可能なツールとして公開

• Groq（openai/gpt-oss-120b） — LLM 推論

• Razorpay Python SDK — 実際のテストモード支払い注文

• LangSmith — 可観測性と監査証跡

• 永続的な JSON ベースの支出追跡

ローカルでの実行

python -m venv venv
venv\Scripts\activate          # on Windows
pip install -r requirements.txt

.env ファイルを次の内容で作成します： RAZORPAY_KEY_ID=your_test_key RAZORPAY_KEY_SECRET=your_test_secret GROQ_API_KEY=your_groq_key LANGSMITH_API_KEY=your_langsmith_key LANGSMITH_TRACING=true LANGSMITH_PROJECT=deskkit-buildathon

次に実行します：

uvicorn main:app --reload

http://127.0.0.1:8000 にアクセスしてください。

デモ

指示を入力するか（例："USB-C ケーブルを10本とノートパソコンスタンドを1台購入"）、または リクエスタエージェントのシミュレート をクリックすると、2つ目の AI が独自の購入リクエストを生成します — 真のエージェント間コマースです。

スクリーンショット

リアルタイムの予算追跡による注文成功

予算ゲートが上限超過の注文をブロックし、優雅な理由を示す

月次台帳 — 監査証跡をひと目で確認

エージェント間コマース：リクエスタエージェントが独自の購入リクエストを生成

Razorpay AI Buildathon、Track 1 のために構築されました。