Agents
Every ChatClient bean in platform-api, grouped by product area. Provider is Google GenAI via GoogleGenAiChatModel.
Inventory
Use this table as a quick index:
- Area — product area or workflow group the agent belongs to
- Agent — the human-readable agent name
- Bean — the Spring bean name in
platform-api - Model tier — the configured
IntelligenceLevel(LOW,MEDIUM,HIGH) - Entry point — the main service, tool, or workflow stage that calls the agent
| Area | Agent | Bean | Model tier | Entry point |
|---|---|---|---|---|
| ESPi Copilot | ESPi Copilot | copilotClient | MEDIUM | ChatService |
| ESPi Copilot | Research sub-agent | researchClient | MEDIUM | ResearcherTool |
| Findings | User Task Report | userTaskAgentClient | HIGH | UserTaskReportService |
| Discovery | Discovery AI | discoveryClient | LOW → MEDIUM | DiscoveryAIService |
| Notebook | Notebook Generator | notebookAgentClient | MEDIUM | NotebookAgentService / NotebookTools |
| Conversation | Conversation Namer | conversationNamerClient | LOW | ConversationService |
| Changelog | Revision Agent | revisionAgent | LOW | RevisionChangelogHandler |
Total: 7 ChatClient beans.
Deep Research Agents
| Area | Agent | Bean | Model tier | Entry point |
|---|---|---|---|---|
| General | Query sense check | senseCheckAgent | LOW | QuerySenseCheckStage |
| General | Briefing enhancement | briefingEnhancementAgent | MEDIUM | BriefingEnhancementStage |
| General | Research planner | researchPlannerAgent | LOW | ResearchPlanningStage |
| General | General report generator | generalReportGenerationAgent | MEDIUM | ReportGenerateStage |
| Product Comparison | Product comparison report | productComparisonAgent | MEDIUM | ReportGenerationStage |
| Portfolio Overlap | Cluster generation | clusterGenerationAgent | MEDIUM | GenerateClustersStage |
| Portfolio Overlap | Cluster analyst | clusterAnalystAgent | MEDIUM | ClusterAnalystStage |
| Shared | Title & summary | titleAndSummaryGenerationAgent | LOW | Portfolio + Strategic Consolidation stages |
| Strategic Consolidation | Replacement candidates | replacementCandidatesAgent | MEDIUM | CreateReplacementCandidatesStage |
| Strategic Consolidation | Validate & enrichment | validateAndEnrichmentAgent | MEDIUM | ValidateAndEnrichClustersStage |
Total: 10 ChatClient beans (17 overall).
Product areas
ESPi Copilot — Interactive assistant (search, commercial, capability frameworks, notebooks, research, HITL). Config: CopilotAgentConfig. Entry: ConversationController → ChatService.
Findings — Async interview / user-task report generation. Config: UserTaskAgentConfig. Output: UserTaskReport.
Discovery — Extract and match vendors/products from invoice JSON against CPS. Config: DiscoveryAgentConfig.
Notebook — Renders single-page HTML notebooks; usually invoked from Copilot via NotebookTools. Config: NotebookAgentConfig.
Conversation Namer — ≤5-word title from first user message. Config: NamerAgentConfig.
Changelog — Short sentence describing revision diffs. Config: RevisionAgentConfig.
Deep Research — Four workflow objectives (General, Product Comparison, Portfolio Overlap, Strategic Consolidation). Wired via AgentConfig → DeepResearchReportCreationService.
Keeping this page updated
When you add, rename, or remove a ChatClient agent in platform-api, update this page in a PR along with the changes to the codebase.
- Inventory tables — Add or update the row in the main table or Deep Research Agents table (area, agent name, bean, model tier, entry point). Update the total counts.
- Product areas — Add a short summary if it is a new product area, or adjust the existing blurb if behaviour or config changed.
- Out of scope — Do not list non-
ChatClientusage, frontend-only LLM calls, or the non-AI “Tool” domain entities.
To find agents in code, search for ChatClient beans and *AgentConfig classes under platform-api.
Reviewing Draft Vendors
A simple, step-by-step guide to approve, or reject draft vendors before they go live on the Vendor Portal.
ESPi Architecture & Query Flow
This document provides a high-level overview, a component breakdown, and detailed diagrams of how ESPi (ESPROFILER Intelligence), the AI co-pilot and agent orchestrator built into ESPROFILER, handles and processes user queries.