DeskKit — Razorpay AI Buildathon을 위한 에이전틱 커머스

트랙 1: AI 성장 및 에이전틱 커머스

AI 구매자가 판매자(DeskKit)와 엔드투엔드로 거래할 수 있게 만드는 자율 조달 에이전트 — 모든 금전 행위는 설명 가능하고, 한도가 설정되어 있으며, 승인을 거치고, 실시간 감사 추적이 제공됩니다.

기능

DeskKit은 Razorpay의 소규모 사무용품 판매자입니다. 이 프로젝트는 다음을 수행하는 AI 에이전트를 구축합니다:

• MCP 도구 인터페이스를 통해 DeskKit의 카탈로그를 탐색합니다(에이전트가 읽을 수 있는 카탈로그)

• 구매를 추론하고 실제 Razorpay 테스트 모드 주문을 실행합니다

• 엄격한 월간 예산을 2단계 게이팅으로 적용합니다: ₹3,000 미만은 자동 승인, 초과 시 수동 승인 필요, 월 ₹5,000 초과 시 하드 차단

• 세션 간 지출을 유지합니다 — 예산은 실행마다 초기화되는 것이 아니라 실제 월간 한도처럼 작동합니다

• 성공적인 구매 후 추천 보완 상품을 능동적으로 제안합니다(업셀/크로스셀)

• 조달 요청을 자율적으로 생성하는 두 번째 AI 에이전트를 포함합니다 — 인간-에이전트가 아닌 실제 에이전트-에이전트 커머스를 입증합니다

모든 결정은 전체 감사 추적을 위해 LangSmith에 기록되며, 승인/대기/차단 건수와 주문 내역을 보여주는 월간 원장 대시보드에서 실시간으로 시각화됩니다.

Related MCP server: Cashfree CLI

이 트랙에 부합하는 이유

"모든 금전 행위는 설명 가능하고, 한도가 설정되어 있으며, 승인을 거쳐야 합니다. 감사 추적을 보여주고 하나의 실패를 우아하게 처리하십시오."

이 프로젝트는 네 가지 서로 다른 실패/엣지 케이스를 우아하게 처리합니다: 예산 차단, 승인 게이트, 카탈로그에 없는 품목 요청, 과도하게 범위가 지정된 에이전트-에이전트 요청의 부분 이행 — 각각 명확한 근거와 실제 대안을 제시하며, 조용한 실패나 강제 재정의가 없습니다.

아키텍처

요청자 에이전트 (AI 구매자) ──> LangGraph ReAct Agent ──> MCP Tool Layer ──> Razorpay Test-Mode 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개 구매"), 요청자 에이전트 시뮬레이션을 클릭하면 두 번째 AI가 자체 구매 요청을 생성합니다 — 진정한 에이전트-에이전트 커머스입니다.

스크린샷

실시간 예산 추적이 포함된 성공적인 주문

한도 초과 주문을 차단하는 예산 게이트와 우아한 근거 제시

월간 원장 — 한눈에 보는 전체 감사 추적

에이전트-에이전트 커머스: 요청자 에이전트가 자체 구매 요청 생성

Razorpay AI Buildathon, 트랙 1을 위해 제작되었습니다.