Real-time Google Search via Gemini Grounding. Results are automatically injected into your agent's context for factual, sourced responses.
20 pre-built templates for VC / PE, M&A, Macro Strategy, Equity Research, Risk Management, Quantitative Finance and Investor Relations. One click to configure and run — fully customisable after.
3-tier cognitive memory: Working (current session entities), Episodic (past session summaries, 90-day TTL) and Semantic (permanent entity facts). Context is automatically injected into agent prompts to enable continuity across conversations.
Financial Knowledge Graph — structured entities (Companies, Persons, Funds, Deals, LPs) and their relationships. Auto-extracted from uploaded documents and agent sessions. Provides Graph-RAG context injection into agent prompts.
Execute Python (Pyodide), JavaScript and SQL directly in your browser — no server required. 8 financial templates included: Monte Carlo, DCF, Black-Scholes, VaR, Cap Table, Risk Parity and more. Agent-generated code blocks in chat also get an automatic ▶ Run button.
No files uploaded in this session.
- Upload financial models (XLSX) to let the agent read your numbers directly.
- Upload board decks or IM (PDF) for M&A or due-diligence analysis.
- The agent extracts tickers, amounts, dates and key financial terms automatically.
- For permanent agent knowledge, use Agent Builder → Knowledge Base.
No data yet. Start using agents to generate analytics.
No token data.
No latency data yet.
| Agent | Mode | Messages | Tool Calls | Tokens | Avg Duration | Status | Date | Actions |
|---|---|---|---|---|---|---|---|---|
| Loading sessions… | ||||||||
History of all multi-agent swarm executions — parallel, sequential and conditional. Each session shows child agent status, tokens used and execution time.
Drag-and-drop pipeline editor for multi-agent workflows. Connect AGENT, TOOL, CONDITION, HITL, PARALLEL and MERGE nodes into reusable pipelines — saved to Firebase, executed with live visual feedback.
Validate agents before deployment — unit tests, regression suites, A/B comparison and adversarial red-team probes (18 finance-specific attacks). All results saved to Firebase for audit trail.
Generate institutional-grade financial documents from agent analyses: IC Memo · CIM Summary · Term Sheet · LP Report · One-Pager. Export to PDF, DOCX and XLSX.
Skills auto-extracted from successful agent runs: Prompt Fragments · Code Scripts · Tool Chains · Memory Patterns · Analysis Templates. Attach skills to agents to enhance their capabilities across sessions.
3-agent adversarial debate: Bull vs Bear arbitrated by a Judge (Claude) producing an IC-grade verdict with fair value, confidence score and MiFID II disclaimer.
Transforms agent analyses into institutional investment decisions: INVEST · CONDITIONAL INVEST · WATCH · PASS · HARD PASS · ESCALATE. Supports 6 strategies: PE Buyout, VC Growth, HF Long/Short, M&A Sell-Side, Credit, Distressed. Results are persisted in Firebase and linked to agent sessions.
Deterministic multi-step pipelines with full audit trail. IC Memo · Quick Screen · Legal DD · Portfolio Monitoring · HF Signal. Each step is typed, traced, retryable and cross-validated.
Complete User Guide
Everything you need to master the most advanced AI agent platform for finance — from creating your first agent to orchestrating multi-agent swarms with real-time web search, financial knowledge graphs and institutional document generation.
Overview — What is Agent Builder?
The most advanced AI agent platform for financial professionals
AlphaVault Agent Builder is a complete platform for creating, configuring, and running custom AI agents tailored to finance — VC/PE, M&A, Equity Research, Macro Strategy, Risk Management and more. Unlike simple chatbots, Agent Builder implements a full ReAct loop (Reason — Act — Observe) that allows agents to autonomously chain 119 MCP tools, search the web in real-time, read uploaded documents, and generate institutional-grade outputs.
| Layer | Components | Purpose |
|---|---|---|
| UI Layer | Chat, Views, Sidebar, Header | User interaction interface |
| Agent Layer | Agent Builder, Runtime, Selector | Agent creation and execution |
| Intelligence Layer | Memory, KG, Skills, Sandbox | Learning and knowledge management |
| Control Layer | HITL, Guardrails, Time-Travel | Safety and oversight |
| Multi-Agent Layer | Spawning, Swarm, A2A | Complex orchestration |
| MCP Tools Layer | 119 tools across 20 categories | Real financial data and actions |
| Data Layer | Firebase Firestore | Persistent storage for all data |
Interface Layout
Understanding the 4 zones of the Agent Builder interface
The sidebar contains all navigation items. It collapses to icon-only mode by clicking the chevron button on its right edge to give more space to the main content.
| Section | Items | What it does |
|---|---|---|
| Workspace | Chat, Deep Search, MCP Tools | Core interaction modes |
| Agents | My Agents, Builder, Templates, Memory, KG, Sandbox, Analytics, Spawning, Swarm, Testing, DocGen, Skills | All agent-related features |
| Knowledge | Knowledge Base | File upload and management |
| History | Conversations | Past sessions and favorites |
| Help | User Guide | This documentation |
| Element | Function |
|---|---|
| Mode Selector | Switch between Orchestrator / Analyst / Researcher / Custom Agent |
| Model Selector | Choose AI provider (Gemini / Claude / OpenAI) and specific model — persists across sessions |
| Active Agent Badge | Shows currently running agent. Click X to end the session. |
| Globe button | Open Deep Search view |
| Clip button | Open Knowledge Base upload |
| Robot button | Open Agent Selector modal |
| New Agent button | Open Agent Builder slide-out panel |
| Chart button | Toggle Session Metrics bar (tokens, tool calls, iterations, duration) |
| Moon button | Toggle dark / light mode |
| Book button | Open this User Guide |
The central area switches between 16+ views depending on which sidebar item you click. Each view is self-contained with its own toolbar, search and content. Only one view is visible at a time.
switchView(). Each sidebar click re-initialises the view with fresh data from Firebase. Some views lazy-mount their heavy components (Sandbox, KG, Swarm) on first access.| Button | Function |
|---|---|
| Web | Toggle real-time web search for the next message (Gemini Grounding) |
| Attach (auto-injected) | Upload files (PDF, Excel, Word, CSV) to inject into context |
| Tools | Navigate to MCP Tools Browser view |
| Agent | Open Agent Selector to start an agent session |
| Trash | Clear current conversation |
| Send | Send message — or press Enter |
Quick Start — 5 Minutes to First Agent
The fastest path from zero to a running custom agent
Chat and Conversation Modes
Four modes, three AI providers, unlimited conversations
The Four Modes
| Mode | System Prompt Style | Best For | Tools Available |
|---|---|---|---|
| Orchestrator | Multi-capability master coordinator | Complex, multi-step financial questions | All 119 tools via ReAct loop |
| Analyst | Quantitative financial analyst | Stock analysis, DCF, valuation, ratios | All 119 tools |
| Researcher | Deep research and sourcing specialist | News, M&A targets, market intelligence | All 119 tools |
| Custom Agent | Your configured system prompt | Any specialized workflow you define | Agent's selected tools only |
Input and File Attachments
The chat textarea supports multi-line input (Shift + Enter), auto-resize up to 200px, and a 32,000 character limit. Character count is shown bottom-right.
Agent Builder — Creating Custom Agents
The heart of the platform — build, configure and deploy specialized AI agents
Creating an Agent — 8 Configuration Sections
| # | Section | Key Fields | Best Practices |
|---|---|---|---|
| 1 | Identity | Icon, Name, Description, Category, Tags | Use descriptive names. Tags help search. Category determines the color theme in agent cards. |
| 2 | System Prompt | 8,000-char textarea, toolbar buttons (Role, Framework, Output, Tone) | Use toolbar buttons to insert structured blocks. Include an explicit output format. Reference your custom field values by their names. |
| 3 | Tools | "Use all 119 tools" toggle, Tool Selector view | Enable only tools your agent actually needs. Fewer tools = faster, cheaper runs. Use "Use all tools" for general-purpose agents only. |
| 4 | Capabilities | Deep Web Search toggle, File Ingestion toggle | Enable Web Search for agents needing real-time data. Enable File Ingestion for DD and document analysis agents. |
| 5 | AI Settings | Provider, Model, Temperature, Max Iterations, Max Tokens | Gemini 2.5 Flash for speed. Gemini 2.5 Pro for depth. Temperature 0.2 for factual analysis, 0.65 for balanced, 0.9 for creative. Max iterations 6 is the sweet spot. |
| 5b | Guardrails | Compliance presets, rule toggles, keyword blocklists | Always apply MiFID II preset for client-facing agents. See the Guardrails section for full details. |
| 5c | HITL | Enable toggle, Autonomy Level (Supervised / Assisted / Autonomous) | Use Supervised for high-stakes actions. Autonomous for research-only agents. |
| 6 | Custom Input Fields | Add text/select/textarea fields, mark required | These fields appear in the Agent Selector modal before a session starts. Values are automatically injected into the system prompt context. |
| 7 | Knowledge Base | Upload PDF/Excel/Word/CSV (save agent first) | Permanent agent-level files always available to the agent — distinct from session-level chat attachments. |
| 8 | Team Sharing | Promote to Team Agent, add members with view/edit/admin permissions | Save the agent first, then configure sharing. Team agents appear in the Team tab of the Agent Selector for all enterprise members. |
20 Pre-Built Templates
| Category | Template | Key Use Case |
|---|---|---|
| VC / PE | VC Deal Screener | Startup investment evaluation (TAM, team, product, unit economics) |
| PE Portfolio Monitor | KPI tracking from uploaded monthly reports | |
| LP Fundraising Intelligence | LP profiling, market conditions, pitch materials | |
| Due Diligence Analyst | Full FDD/CDD/ODD with red flag detection | |
| Valuation Engine | DCF + Comps + Precedents + LBO football field | |
| Exit Strategy Advisor | Strategic sale / SBO / IPO / recap analysis | |
| M&A | M&A Target Scanner | Buy-side target identification and scoring |
| Synergy and Integration Analyst | Cost/revenue synergy modeling, 100-day plan | |
| Fairness Opinion Analyst | DCF + comps + premium analysis for boards | |
| Macro | Macro Intelligence Officer | Monetary policy, geopolitics, cross-asset strategy |
| Sector Rotation Strategist | 11-sector relative strength and allocation signals | |
| Equity | Equity Research Analyst | Initiation, earnings preview/review, rating |
| Earnings Intelligence Agent | Beat/miss analysis, guidance, post-earnings position | |
| Risk | Portfolio Risk Manager | VaR, factor exposure, stress testing, drawdown |
| Quant | Quantitative Alpha Researcher | Factor development, signal construction, backtest |
| IR | Investor Relations Analyst | Earnings scripts, NDR presentations, Q&A prep |
| LP Management Suite | Capital calls, distributions, NAV, waterfall | |
| CRM | CRM and Deal Flow Manager | Pipeline stages, contacts, deal rooms, memos |
| Ops | Platform Operations Manager | Enterprise-wide dashboard, teams, secondary market |
| General | General Finance Analyst | All-purpose agent with all 119 tools |
Running an Agent — Session Lifecycle
MCP Tools Browser — 123 Financial Tools
The complete toolkit your agents can use autonomously
| Category | Tools | Key Capabilities |
|---|---|---|
| Technical Analysis | 10 | RSI, MACD, ADX, Bollinger, Ichimoku, market regime detection, AI recommendation |
| News Intelligence | 5 | Latest news, company news, financial news search, market sentiment, topic news |
| Drive Management | 4 | Create financial models and presentations, list/search Drive files |
| User Data | 10 | Profile, conversations, posts, code projects, Drive files, activity, MCP conversations |
| Trending Topics | 4 | Trending detection, Fear and Greed index, risks and opportunities, trending companies |
| Forex Analysis | 6 | Rates, pair analysis, AI recommendations, major pairs overview, Fibonacci, Pivots |
| Financial Reports (10-K) | 10 | P&L, balance sheet, cash flow, ratios, advanced metrics, valuation, YoY, earnings |
| Quarterly Reports (10-Q) | 11 | Quarterly P&L, QoQ comparison, TTM metrics, quarterly earnings, AI recommendation |
| Deal Room | 6 | List rooms, documents, Q&A, notes, access management, stats |
| CRM | 8 | Contacts, accounts, deals, LPs, portfolio, interactions, sourcing, search |
| Cap Table | 5 | Cap tables, shareholders, rounds, valuations, waterfall scenarios |
| LP Portal | 7 | Funds, investors, capital calls, distributions, portfolio companies, NAV, notifications |
| AV Teams | 4 | Meetings list, meeting details, notifications, call history |
| Secondary Market | 5 | Listings, transactions, positions, pricing, GP consents |
| Investment Memo | 4 | List memos, get memo, comments, shares |
| Custom Agents | 4 | List agents, conversations, team agents, knowledge bases |
| Founders Portal | 5 | Portal access, messages, resources, deal submissions, KPI requests |
| Community | 4 | Channels, posts, search, user follows |
| Enterprise | 3 | Enterprise info, members, invites |
| User Extended | 4 | Institution favorites, business plans, referrals, usage stats |
Deep Web Search — Gemini Grounding
Real-time Google Search integrated directly into your agent context
Deep Search uses Google's Gemini Grounding API to perform live web searches and inject sourced results into agent context. Two modes exist: the dedicated Deep Search view (sidebar — Deep Search) and the inline toggle in the chat input bar.
| Mode | How to Activate | Best For |
|---|---|---|
| Inline Chat Mode | Click Web button in chat input, then send message | Quick fact-checking, enriching a single message with live data |
| Deep Search View | Sidebar — Deep Search, or header globe button | Dedicated research sessions with template queries and history |
| Agent Auto-Search | Enable "Deep Web Search" in agent capabilities | Agents automatically search when they detect time-sensitive queries (news, prices, events) |
The Deep Search view includes 8 pre-built query templates: Company Latest News — Funding Round Research — M&A Deal Intelligence — Sector Trends — Executive Profile — Earnings Preview — Macro Event Impact — Regulatory Research.
Knowledge Base — Two Levels of File Context
Session-level vs agent-level document management
| Type | Access | Persistence | Best For |
|---|---|---|---|
| Chat-Level | Clip button in chat input, or sidebar — Knowledge Base | Current message only (cleared after send) | Ad-hoc analysis of a specific document — quarterly report, term sheet, financial model |
| Agent-Level | Agent Builder — Knowledge Base section (save agent first) | Permanent — always available to the agent | Internal playbooks, valuation frameworks, proprietary data the agent always needs |
Memory System — 3-Tier Cognitive Architecture
Persistent memory across sessions for continuity and learning
| Tier | Name | Storage | TTL | Contains |
|---|---|---|---|---|
| Tier 0 | Working Memory | In-browser (window._workMem) | Current session only | Extracted entities (tickers, companies, people) from the current conversation |
| Tier 1 | Episodic Memory | Firebase (episodic_memory) | 90 days | Session summaries, key facts, lessons learned from past runs |
| Tier 2 | Semantic Memory | Firebase (semantic_memory) | Permanent | Financial entity facts: companies, funds, deals, people — linked to the Knowledge Graph |
Before every agent run, MemoryEngine.buildMemoryContext(query) is called. It retrieves relevant memories from all three tiers and prepends them to the agent's system prompt. This means:
Knowledge Graph — Financial Entity Relationships
A living graph of companies, deals, funds, people and their connections
The Knowledge Graph (KG) is a force-directed D3.js graph stored in Firebase. It serves as Semantic Memory Tier 2 and provides Graph-RAG (Retrieval-Augmented Generation with graph traversal) for agent queries.
| Node Type | Properties | Example |
|---|---|---|
| Company | name, sector, stage, country, revenue, employees | Stripe — FinTech — Growth — USA |
| Person | name, role, firm, deals | Patrick Collison — CEO — Stripe |
| Fund | name, firm, vintage, size, strategy, investments | Sequoia Capital XII — 2023 — $2.85B — VC |
| Deal | target, acquirer, type, amount, date, multiple | Microsoft / Activision — $68.7B — 2023 |
| LP | name, type, commitments, contacts | CalPERS — Pension Fund — $500M committed |
| Relationship | Direction | Example |
|---|---|---|
| investedIn | Fund to Company | Sequoia to Stripe |
| acquiredBy | Company from Company | Activision from Microsoft |
| boardMember | Person to Company | Patrick Collison to Stripe |
| coinvestedWith | Fund and Fund | Sequoia and Andreessen |
| competitorOf | Company and Company | Stripe and Adyen |
Skills Library — Agent Self-Learning
Reusable patterns auto-extracted from successful agent runs
| Skill Type | What it Contains | Auto-Detected When |
|---|---|---|
| Prompt Skill | Reusable system prompt fragment | Agent system prompt is long and response is high-quality |
| Code Skill | Validated Python/JS/SQL script | Response contains a code block of 50+ characters |
| Tool Chain | Effective sequence of 3+ tool calls | Agent makes 3+ tool calls in a single run |
| Memory Pattern | Efficient entity/fact structure | Agent uses a long system prompt with memory-related terms |
| Analysis Template | Reusable analysis framework | Response contains financial terms like DCF, EBITDA, WACC |
Code Sandbox — In-Browser Execution
Python (Pyodide), JavaScript, and SQL running entirely in your browser
| Language | Engine | Capabilities |
|---|---|---|
| Python | Pyodide (WASM) | NumPy, Pandas, Matplotlib, SciPy — Monte Carlo, DCF, Black-Scholes, VaR |
| JavaScript | iframe sandbox | Console intercept, Highcharts auto-render, DOM manipulation |
| SQL | sql.js (SQLite WASM) | Upload CSV as a table, run queries against uploaded financial data |
The Sandbox view has a template picker: Monte Carlo Simulation — DCF Valuation — Black-Scholes Option Pricing — VaR Calculation — Cap Table Model — Waterfall Simulation — Risk Parity. Each is a fully working Python script you can run immediately and modify.
Document Generation — Institutional-Grade Outputs
From agent analysis to professional PDF/DOCX/XLSX in one click
| Document Type | Auto-Generated Sections | Export Formats |
|---|---|---|
| IC Memo | Executive Summary, Investment Thesis, Business Overview, Market Analysis, Financial Analysis, Valuation, Risks, SWOT, Recommendation | PDF, DOCX |
| CIM Summary | Company Overview, Financials, Growth, Management, Transaction Rationale | PDF, DOCX |
| Term Sheet | Transaction Terms, Valuation, Preferences, Board Rights, Anti-dilution, Vesting | PDF, DOCX |
| LP Report | Fund Performance, Portfolio Update, Distributions, Market Commentary | PDF, DOCX, XLSX |
| One-Pager | Company Overview, Traction, Team, Ask, Use of Funds |
HITL Oversight — Human-in-the-Loop Control
Real-time intervention and approval for agent actions
| Autonomy Level | Behavior | Best For |
|---|---|---|
| Supervised | Every tool call pauses and shows: tool name, parameters, Approve / Modify / Skip / Stop buttons | High-stakes agents: send email, write to external API, production workflows |
| Assisted | Only "risky" actions pause (send_email, write_file, external_api). Research continues autonomously. | Balance between oversight and speed |
| Autonomous | Agent runs all steps without intervention. Results shown after completion. | Research-only agents, low-risk analysis workflows |
Guardrails — Compliance and Safety Rules
Mandatory rules applied at input and output level for every agent run
| Preset | Rules Applied | Use When |
|---|---|---|
| MiFID II Compliant | Appends disclaimer, requires source citations, blocks "guaranteed return / risk-free / certain profit" | Any client-facing output in regulated EU context |
| SEC Safe Harbor | PII redaction in outputs, audit log enabled, blocks insider-like terms | US-regulated reporting and public company communications |
| Enterprise Safety | Max 50,000 tokens/run, max 10 iterations, allowed domains whitelist, human approval for email/file/API | Enterprise deployment with IT/compliance constraints |
| No Code Execution | Blocks code blocks in outputs, requires Sandbox approval | When you want to review all code before execution |
guardrails_log/{sessionId} if audit logging is enabled.Time-Travel Debugging — Git for Agent Reasoning
Rewind, branch and what-if any step in an agent's execution
Every step in an agent's ReAct loop is saved as a checkpoint in Firebase. The Time-Travel panel (accessible from the timer button in the ReAct bar) shows a visual timeline of all steps.
| Action | How | Result |
|---|---|---|
| Rewind | Click a checkpoint — Rewind button | Agent state is restored to that exact step — all subsequent steps are discarded |
| Branch | Click a checkpoint — Branch from here — name it — add modified instruction | Creates a parallel execution branch. Compare Branch A vs Branch B in split view. |
| Inspect | Click any step in the timeline | See: tool name, exact parameters, raw result, reasoning text, token count at that step |
| What-If | Open What-If mode — change a parameter value — Re-run | Re-runs the entire session from that checkpoint with the modified parameter |
Agent Spawning — Dynamic Multi-Agent Hierarchy
Lead agents orchestrate specialized sub-agents in parallel or sequentially
When Agent Spawning is enabled in an agent's configuration, the Lead Agent can decompose complex tasks and delegate to up to 5 specialized Sub-Agents simultaneously using the spawn_sub_agent MCP tool.
| Config Option | Values | Effect |
|---|---|---|
| Max Sub-Agents | 1–5 | Maximum number of parallel child agents |
| Max Tokens per Child | 1,024–10,000 | Token budget isolation per child — prevents runaway costs |
| Execution Mode | Parallel / Sequential / Conditional | Parallel = fastest; Sequential = result-dependent; Conditional = branching logic |
| Aggregation Strategy | Merge / Vote / Supervisor-Decides | How the Lead Agent combines sub-agent results into a final answer |
| Synthesize | On / Off | Lead Agent writes a synthesis narrative over all sub-agent results |
Swarm Visual Canvas — Drag-and-Drop Pipeline Editor
Build complex multi-agent workflows visually — no code required
| Node Type | Icon | Purpose |
|---|---|---|
| AGENT | Runs a specific custom agent from your library | |
| TOOL | Calls a specific MCP tool with defined parameters | |
| CONDITION | Branches the flow based on if/else logic | |
| HITL | Pauses for human approval before continuing | |
| PARALLEL | Splits into multiple simultaneous execution branches | |
| MERGE | Combines results from multiple branches | |
| START / END | Pipeline entry and exit points |
A2A Protocol — Agent-to-Agent Communication
Connect your agents to external platforms and other AlphaVault agents
A2A (Agent-to-Agent Protocol) allows your agents to delegate tasks to other agents — either internally (other agents in your AlphaVault) or externally (third-party platforms supporting the 2025 A2A standard). All A2A calls route through the a2a-gateway-worker Cloudflare Worker.
| A2A Setting | Effect |
|---|---|
| Enable A2A Delegation | Agent can call other connected agents via the delegate_to_agent MCP tool |
| Authorized Connections | Which registered connections this agent is allowed to delegate to |
| Expose as A2A Endpoint | Makes your agent callable by other agents (internal or external) |
| Allowed Callers | Whitelist of UIDs/tokens allowed to call your exposed agent endpoint |
| Rate Limits | Calls/minute and calls/day limits to prevent abuse |
Voice Interface — Hands-Free Agent Interaction
Web Speech API for both input (STT) and output (TTS) — zero external dependencies
| Feature | How to Use |
|---|---|
| Voice Input (STT) | Click the microphone button in the chat input bar. Speak your question. Live transcription appears in the textarea. Pause speaking to auto-send, or click Send. |
| Voice Output (TTS) | Enable "Auto-read responses" in Voice Settings. All agent responses are read aloud using the selected browser voice. Speed is adjustable. |
| Hands-Free Mode | Toggle "Hands-free mode" — the microphone stays open between messages. Ideal for walking through a long analysis verbally. |
| Language | Supports EN, FR, DE, ES, JP and all other languages available in the browser's SpeechRecognition API. |
| Waveform Visualizer | An animated amplitude waveform overlays the input bar while listening — confirms the microphone is active. |
Testing Studio — Validate Before Deploying
Unit tests, regression suites, A/B comparison and adversarial red-team probes
| Test Type | How it Works | Best For |
|---|---|---|
| Unit Test | Define a prompt + expected keywords + expected format. Run — pass/fail based on whether output contains keywords. | Verifying an agent always mentions "EV/EBITDA" in a valuation response |
| Regression Suite | Re-run the same test suite automatically every time you edit the agent. Compare results before/after. | Ensuring prompt changes do not break existing behaviors |
| A/B Comparison | Run the same input through Agent A and Agent B simultaneously. Side-by-side output comparison with diff highlighting. | Comparing Gemini vs Claude for a specific workflow, or two prompt versions |
| Adversarial Probes | 18 pre-built finance red-team prompts: jailbreak attempts, PII extraction probes, prompt injection, instruction-bypass variants. | Compliance validation before deploying client-facing agents |
{ "prompt": "...", "expectedKeywords": ["dcf","ebitda"], "expectedFormat": "markdown" }. Export test results as a timestamped JSON for audit trail — all results are also saved in Firebase under test_suites/{suiteId}/runs.Agent Analytics — Observability and Performance
Deep metrics on every agent run — beyond simple token counts
| Metric | What it Measures | Why it Matters |
|---|---|---|
| Total Sessions | Number of agent runs in selected period | Usage volume and adoption tracking |
| Tool Calls | Total MCP tool invocations across all runs | Complexity indicator — more calls = deeper analysis |
| Tokens Used | Total input + output tokens | Cost estimation (USD) and efficiency tracking |
| Avg Response Time | Wall-clock time from send to final response | User experience quality — target under 15s for most agents |
| Success Rate | Percentage of runs without errors (based on thumbs up/down + error flags) | Agent quality and reliability |
| Chart | Shows |
|---|---|
| Sessions and Tool Calls Over Time | Area chart — activity trend for the selected period (7D / 30D / 90D / All) |
| Token Distribution (donut) | Token usage split by agent — identify which agents are most expensive |
| Top Agents by Usage | Ranked list with usage bars — your most-used agents |
| Tool Usage Breakdown | Heat-sorted bar chart of all tools called — discover which tools are most useful |
| Response Time Distribution | Bar chart of latency buckets — detect slow-performing agents |
| Sessions by Mode | Donut chart — Orchestrator vs Analyst vs Researcher vs Custom Agent split |
| Deep Search Usage | Stats on web search frequency, sources found, average confidence |
| AI Insights Panel | Auto-generated insights powered by pattern detection — e.g. "Tool X is called 3x more on weekdays" |
Feature Interconnections — How Everything Works Together
The platform's power comes from how each feature amplifies the others
Pro Workflows — Step-by-Step Playbooks
Battle-tested workflows for the most common institutional finance tasks
Workflow 1 — Full Due Diligence in 20 Minutes
Workflow 2 — Building a Multi-Agent Deal Sourcing Pipeline
Workflow 3 — Building Your Skill Library Over Time
Use Cases by Role
How different finance professionals use Agent Builder in practice
Keyboard Shortcuts
Master the keyboard for maximum productivity
Power Tips — Expert-Level Techniques
Hidden capabilities and advanced patterns used by power users
In your system prompt, directly reference custom field names: "Analyze the company {{company_name}} in the {{sector}} sector at {{stage}} stage targeting a {{check_size}} investment." When users fill these fields before starting a session, they are automatically injected into the prompt context. This eliminates ambiguous questions and makes the first response immediately useful.
In the chat input, type @agent to get a quick-select popover of your recent agents. Select one to immediately start a session without opening the Agent Selector modal. This saves 3–4 clicks for frequently used agents.
Do not use "Use all 119 tools" unless you are building a General Finance agent. Gemini reads all tool declarations before each step — more tools = longer prompts = higher cost and slower responses. A specialized agent with 8–12 precisely relevant tools will outperform a 119-tool agent in both speed and quality for a specific domain.
Deep Search (Gemini Grounding) adds latency and cost. The agent auto-detects when web search is needed based on keywords like "latest", "recent", "current price", year mentions, or ticker patterns. For purely analytical questions (DCF calculation, ratio interpretation), keep Deep Search off to get faster, cheaper responses from the model's training data.
Start every new company research by first asking the KG: "What do we know about [Company]?" If it returns nothing, your agents will build the graph as they work. After 3–4 research sessions on the same company, the KG will have a rich node with facts, relationships to known funds/competitors/people, and historical analysis summaries — making each subsequent session dramatically faster and more accurate.
After running a DCF or valuation analysis, open Time-Travel — find the step where the agent fetched financial data — use What-If mode to change a key assumption (e.g. WACC from 10% to 12%) — re-run. You get a parallel scenario analysis without re-typing the entire query. Save both branches as named scenarios for board presentation.
ReAct agents respond to explicit instructions in the system prompt. Add these high-impact lines to any agent:
## TOOL USAGE RULES
Always call at least 3 tools before giving a final answer.
Use get_financial_ratios AND get_valuation_metrics together for any valuation.
If search results conflict, prioritize SEC filings over news articles.
Always cite your sources with [Source: tool_name] after each data point.
These explicit instructions dramatically improve tool utilization and response quality without any code changes.
Create a standard set of team agents (Deal Screener, DD Analyst, Valuation Engine) and promote them to Team Agents with Edit permission for senior analysts and View permission for associates. Every team member runs the same agents — all results appear in the shared Analytics view — the Spawn History provides a searchable audit trail of all multi-agent DD runs across the team.