Broker Forge Help

Using the AI Assistant safely

What the assistant can see, what it can do, and the guardrails that keep it from doing the wrong thing.

Updated May 19, 2026 · 6 min read

The AI Assistant inside Broker Forge isn't a general chatbot. It's wired into your brokerage data — your customers, your pipeline, your rates, your contracts — and answers questions in that context. Ask it "what's my biggest deal closing this month?" and it actually knows.

What it can do

  • Answer questions about your data — customers, deals, commissions, contracts
  • Draft a proposal narrative section
  • Suggest follow-up actions on stalled deals
  • Summarize a long REP email thread
  • Explain a billing line item or rate term in plain English
The assistant lives in the slide-out drawer, accessible from any page.
The assistant lives in the slide-out drawer, accessible from any page.

What it can't do

By design, the assistant won't:

  • Send a contract or LOA on its own
  • Move money or change billing
  • Edit a signed document
  • See another brokerage's data — every query is scoped to your brokerage_id

For Agency-tier customers, the MCP server exposes a write-capable variant for power users who want to drive Broker Forge from Claude Desktop or other MCP clients. That's a separate surface with its own audit trail.

The caps that keep you safe

Every AI call counts against a daily cap to prevent runaway costs and weirdness. On Broker Connects-derived tenants, the cap is 250 calls per day per user. On Forge tenants it scales with plan tier.

Your usage shows in the bottom-right of the assistant drawer.
Your usage shows in the bottom-right of the assistant drawer.

When you hit the cap, the assistant explains why and points you to the request-more-quota flow. Caps reset at midnight Central.

How scope works

When you ask the assistant a question, it can only call tools and see data your role has access to. A sub-broker asking about customers will get back only the customers assigned to them. A viewer asking to send a contract will get a polite refusal.

A scope refusal — the assistant explains what it would have needed to do and why it can't.
A scope refusal — the assistant explains what it would have needed to do and why it can't.

Step-by-step: ask a useful question

  1. Open the drawer

    Click the assistant icon top-right, or press Cmd + / anywhere in the app.

  2. Be specific

    "Which deals are likely to close this week?" beats "anything I should know?" — give the assistant something to filter on.

  3. Read the citations

    Every answer cites the records it pulled from. Click a citation to jump to the underlying customer, contract, or rate.

  4. Iterate

    If the answer is incomplete, follow up. The assistant keeps the thread context so you can drill down without re-typing the setup.

Tips & gotchas

Don't paste customer PII from outside the platform

The assistant is fine handling data already inside Broker Forge — that's encrypted at rest and never sent outside the platform's AI providers. Avoid pasting external customer information (Social Security numbers, bank info, etc.) into the chat.

The AI is a copilot, not the captain

Use it to draft, summarize, and surface — but every contract you send, rate you quote, and email you fire off is on you. Treat AI output the same way you'd treat a junior teammate's first draft.

Feedback shapes future answers

Thumbs up / thumbs down on each answer is read and acted on. If something's wrong, hit the thumbs-down and add a one-line explanation — it goes into the eval queue.

Related

Was this article helpful?

Related articles

Parsing utility bills with AI
Drag a bill PDF onto the page. Get back ESI ID, annual usage, current REP, and TDU — straight onto the customer record.
Searching supplier rates
Find every REP offer that fits a customer's ZIP, usage, and term — sorted by price and margin.
Edit this article on GitHub