How edward97y/agent-marketplace works
Agent Marketplace is an agent-driven marketplace scaffold with a sales-chat runtime, tenant-aware order/product operations, and document-backed RAG. The apparent user workflow is an API request entering the sales agent, which can invoke search, order-action, or knowledge-search tools; separate API routes manage conversations and knowledge documents. The README describes setup rather than application behavior, so workflow details here rely on sampled source and the source index; unsampled route and agent internals limit some connections.
Main entry points: document_service.py Document Service · context.py Agent Context · main.py Application Entry · rag_service.py Hybrid RAG Search
Components 28
API and Conversations
- Application Entry
src/main.py - API Routes
src/routes - Conversation API
src/routes/conversation.py - Document API
src/routes/document.py - Conversation Service
src/services/db_services/conversation_service.py
Sales Agent
- Sales Agent
src/agent/sales_agent.py - Chat Node
src/agent/nodes/sales/chat.py - LLM and Tools
src/agent/llm.py - Agent Context
src/agent/context/context.py - Sales Prompt
src/agent/prompt/sales_prompt.py
Marketplace Operations
- Search Tools
src/agent/tools/search_tools - Order Tools
src/agent/tools/action_tools - Marketplace Queries
src/services/query_service.py - Order Actions
src/services/actions_service.py - Schema Mapping
src/services/schema_mapping_service.py
Knowledge Retrieval
- Document Service
src/services/db_services/document_service.py - Knowledge Base API
src/routes/knowledge_base.py - Document Processing
src/services/document_processing_service.py - Embedding Service
src/services/embedding_service.py - RAG Search Tool
src/agent/tools/rag_tools/rag_search.py - Hybrid RAG Search
src/services/rag_service.py - RAG Repository
src/repository/rag_repo.py
Persistence and Tenancy
- Tenant DB Maker
src/services/company_db_maker_service.py - Tool Call Records
src/services/db_services/tool_calls_service.py - Application Database
src/db/database.py - Data Models
src/models - Configuration
src/helpers/config.py
Other components
- API Client
Connections 39
- API Client → Application Entry: sends requests
- Application Entry → API Routes: registers routes
src/main.py - Application Entry → Sales Agent: initializes
src/main.py - Application Entry → Tenant DB Maker: initializes
src/main.py - Application Entry → Application Database: uses
src/main.py - Conversation API → Conversation Service: delegates to
src/routes/conversation.py - Document API → Document Service: delegates to
src/routes/document.py - Sales Agent → Chat Node: uses
src/agent/sales_agent.py - Sales Agent → LLM and Tools: uses
src/agent/sales_agent.py - LLM and Tools → Search Tools: registers tools
src/agent/llm.py - LLM and Tools → Order Tools: registers tools
src/agent/llm.py - LLM and Tools → RAG Search Tool: registers tool
src/agent/llm.py - Agent Context → Marketplace Queries: uses
src/agent/context/context.py - Agent Context → Order Actions: uses
src/agent/context/context.py - Agent Context → Hybrid RAG Search: uses
src/agent/context/context.py - Search Tools → Agent Context: accesses context
src/agent/tools/search_tools/search_products.py - Order Tools → Agent Context: accesses context
src/agent/tools/action_tools/create_order.py - RAG Search Tool → Agent Context: accesses context
src/agent/tools/rag_tools/rag_search.py - Marketplace Queries → Schema Mapping: gets mappings
src/services/query_service.py - Marketplace Queries → Tenant DB Maker: opens tenant session
src/services/query_service.py - Marketplace Queries → Tool Call Records: records searches
src/services/query_service.py - Order Actions → Schema Mapping: uses mappings
src/services/actions_service.py - Order Actions → Tenant DB Maker: uses tenant database
src/services/actions_service.py - Order Actions → Tool Call Records: records actions
src/services/actions_service.py - Document Service → Document Processing: extracts and splits
src/services/db_services/document_service.py - Document Service → Embedding Service: embeds chunks
src/services/db_services/document_service.py - Document Service → RAG Repository: stores chunks
src/services/db_services/document_service.py - RAG Search Tool → Hybrid RAG Search: invokes search
src/agent/tools/rag_tools/rag_search.py - Hybrid RAG Search → Embedding Service: embeds query
src/services/rag_service.py - Hybrid RAG Search → RAG Repository: runs hybrid search
src/services/rag_service.py - Hybrid RAG Search → Tool Call Records: records search
src/services/rag_service.py - Conversation Service → Application Database: accesses data
src/services/db_services/conversation_service.py - Document Service → Application Database: persists documents
src/services/db_services/document_service.py - RAG Repository → Application Database: queries and writes
src/repository/rag_repo.py - Application Database → Configuration: loads settings
src/db/database.py - Document Service → Data Models: uses document models
src/services/db_services/document_service.py - RAG Repository → Data Models: queries chunk models
src/repository/rag_repo.py - Knowledge Base API → Document Service: manages knowledge
- Sales Agent → Sales Prompt: uses prompt