Trakkr Docs

Agent

:::summarybox learn What the Agent actually is, and how it's different from ChatGPT The data and tools it can reach for when you ask a question Good asks and bad asks, with examples What it can do for you: answer, investigate, execute Why every change needs your click, and how the approval flow works

How it's different from generic AI

It's worth being explicit about what this isn't.

If you only want a creative writing partner, generic chatbots are fine. The Agent is built for a different job: figuring out why your AI visibility looks the way it does, and changing it.

How to ask well

The Agent rewards specific, anchored questions. The more your question names a real thing in your account, the sharper the answer.

Those work because each one ties to something the Agent can investigate or act on: a specific model, a specific competitor, a specific page, a specific prompt to track, a fact to remember.

The questions that produce weak answers tend to fall into a few buckets.

If your question doesn't name a prompt, page, competitor, model, metric, or fact about your brand, the Agent has nothing concrete to grab onto. Generic in, generic out.

What it can do

Three loose tiers, from least to most consequential.

Answer

Direct lookups against your snapshot. "What's my visibility score on Claude?" "Which prompts am I losing on?" "Show me my top citation sources." "How many actions do I have pending?" These come back fast, usually in one tool call, often as a single sentence with the number.

Investigate

Multi-step analysis that combines snapshot data with live page fetches and, when needed, web search. "Why am I losing on this prompt?" might pull the prompt's history, fetch the competitor page that's beating you, fetch your equivalent page, and explain the structural difference. "What's driving my growth this week?" might cross-reference the prompts that moved, the citations that landed, and the perception shift to give you one paragraph instead of three dashboards.

This is where the Agent earns its keep. The answer typically names a real URL, a real competitor, a real page section, and a concrete next move you can ship today.

Execute

When the Agent recommends a specific change, it surfaces a suggestion chip in the conversation. The chip is a draft of the action. You click confirm to run it, or dismiss to throw it away. Nothing happens to your workspace until you click.

The kinds of action it can propose:

KindExample
Track a prompt"Track 'best stability shoes for plantar fasciitis'"
Add a competitor"Add Brooks to your competitor list"
Remember a fact"Remember you're B2B only"
Queue an action"Add a 'rewrite /pricing for clarity' action to your queue"
Apply a page fix"Update the meta title on /running-shoes"
Create a workflow"When perception drops more than 5 points, ping me"
Generate an article"Draft an article on 'best running shoes for flat feet'"
Send outreach"Mark this G2 pitch as contacted"
Organize tags"Tag your 12 French prompts as FR"
Open something in Trakkr"Open the prompt detail for 'best CRM for startups'"

Most kinds support undo. If you confirm a track and change your mind a minute later, the undo button on the chip reverses it cleanly. A few actions can't be undone (article generation spends a credit, outreach sends an email, audits cost compute), and the chip says so before you confirm.

Approvals and safety

The whole system is built around one rule: the Agent never mutates your account without your click. That rule is what makes the trust model work, so it's worth understanding the edges of it.

A few specifics worth knowing:

If the Agent ever claims it did something, treat that as a bug worth flagging. The pattern is always: chip first, your click, then change.

The Understanding panel

The Understanding panel is where you teach the Agent things it couldn't otherwise know. It opens from the brain icon in the top right of the workspace.

What lives there:

Each item is a single sentence. The Agent reads all of them at the top of every conversation. The panel also shows an understanding score, a rough gauge of how well-briefed the Agent is on your brand. Higher score, sharper answers.

You can also add memory mid-conversation by just telling the Agent. "Remember we don't ship to Canada." A chip appears, you confirm, and from then on every conversation knows that.

Threads and history

Every conversation is a thread, saved to your account. You can rename them, pin the ones you'll come back to, and reopen any of them to keep the conversation going with full context preserved.

A few patterns that work well:

Hit New in the top bar (or click the Briefing chip in the header) to start fresh. The thread sidebar holds everything you've ever asked, scoped to the brand you're in.

What's running under the hood

For the curious, a few specifics. The Agent runs on DeepSeek v4 Flash through a streaming tool loop. Every turn starts with a fresh snapshot of your brand, then the model decides which tools to call: snapshot slicers for fast data lookups, page-investigation tools to fetch real URLs, infrastructure tools to check crawler and delivery health, and web search for anything outside your account. Tool calls stream into the conversation as they happen, so you can watch the investigation unfold.

Two depth modes:

The mode is picked automatically based on the shape of your question. You don't have to choose.

Common questions

Is the Agent the same as ChatGPT or Claude?

No. The Agent is a Trakkr-specific system built on top of an open model. It has tools, your brand snapshot, the approval flow, and the Understanding panel, none of which exist in generic chatbots. The model itself is just the language layer.

Can the Agent edit my site or my account without asking?

No. Every mutation, from tracking a prompt to applying a page fix, requires you to click confirm on a chip in the conversation. There is no autopilot. If something changed without your click, that's a bug.

Why does the Agent sometimes refuse to investigate my question?

It's scoped to your brand's AI visibility. Questions outside that lane (general SEO advice, code help, off-topic conversation) get a one-line redirect instead of a wasted investigation. This is intentional, not a limitation you'd want to remove.

Why does it sometimes give a generic answer?

Two usual causes. One, the question itself was too generic to ground in your data ("how can I improve"). Two, the snapshot is thin because your brand profile or memory is sparse. Filling out the Understanding panel and giving the Agent a real anchor in your question both raise answer quality fast.

Does the Agent remember things across conversations?

The brand memory in the Understanding panel persists across every conversation in that brand. Conversation context itself stays within a thread: when you start a new thread, the Agent starts fresh on the conversation but still reads your brand memory.

What if I taught the Agent something wrong and want to fix it?

Open the Understanding panel, find the item, click the trash icon. Or just tell the Agent in a conversation: "forget that we're B2B only, we just launched a consumer tier." A chip appears, you confirm, the memory updates.

Can I see what tools the Agent used to answer me?

Yes. Tool calls stream into the message as they happen, with a small timeline above the answer showing which tools ran. Click any tool row to expand the raw output. This is also how you check whether a claim about your data is grounded in a real lookup.

Does the Agent count against my prompt limit?

No. Conversations with the Agent are separate from your tracked prompts. The only Agent action that consumes a paid resource is generating an article (one article credit) or generating an agency report (PDF credit on agency plans).

Why did the Agent suggest the same thing twice?

Usually because the suggestion was dismissed without action and the situation that triggered it hasn't changed. If a suggestion isn't useful, dismiss it and the Agent stops surfacing it for a while. If you'd rather it never came up again, teach the Understanding panel why.