Blue Triangle ADK Agent

Overview:

Ask questions about your website's performance in plain English and get back answers, charts, and shareable reports. This guide covers the web app, Slack, and Microsoft Teams

Table of Contents:

• What the assistant can do

• Getting started on the web

• Asking good questions

• Reading an answer

• Charts

• PDF reports

• Saving and printing a conversation

• Managing your conversations

• Choosing which site you're asking about

• Command reference

• Using the assistant in Slack

• Using the assistant in Microsoft Teams

• Who can see your data

• Limits and things it won't do

• Troubleshooting

• Question library

What the assistant can do

The assistant is connected to your Blue Triangle account. It can look up and explain:

Getting started on the web

Sign in

1. Open the assistant's web address (your team will share the link).

2. You'll see a Blue Triangle Assistant sign-in screen.

3. Click Sign in. You'll be taken to Blue Triangle's own login page.

4. Approve access. You'll land back in the assistant, ready to ask.

You sign in with your own Blue Triangle account, so you see exactly the sites and data you already have access to.

What's on screen

Your first question

On a new chat you'll see four suggested questions you can click to try:

• What's our current LCP for the homepage?

• Show me the LCP trend over the last 7 days

• Compare this week's performance to last week

• What were the top JS errors yesterday?

Or type your own. Enter sends; Shift + Enter adds a new line.

Three dots appear while the assistant is working. Longer questions — anything that needs several lookups, a chart, or a report — take longer, which is normal.

Asking good questions

You don't need special syntax. A few habits get you better answers faster.

Say the time range

The assistant understands ordinary phrasing: 

• "last 7 days"

• "yesterday"

• "this month"

• "August"

• "last quarter"

• "this week vs last week"

• "June 1 to June 14"

If you don't say a range, it will pick a sensible default or ask.

Say what to break it down by

• "…by page"
• "…by browser"
• "…by country"
• "…by device"
• "…by day"
•  "…by hour"

Ask follow-up questions

The assistant remembers the conversation. After an answer you can just say:

• "Now show that as a chart"

• "Add mobile as well"

• "Break that down by country"

• "Why do you think that happened?"

If you follow up on a chart with "add onload too" or "include mobile as well", it updates the chart, not just the table.

Ask for the format you want

The words report, audit, summary I can share, and send to my team are what trigger a PDF. Ordinary questions get ordinary answers.

Start a new chat for a new topic

A conversation carries its context — including which site you're looking at. When you move to an unrelated question, click New chat so old context doesn't influence the answer.

Reading an answer

Every answer that contains real data opens with one line telling you exactly what you're looking at:

Site: Acme Shop | Range: Aug 11–18, 2026

For a comparison, both periods are shown:

Site: Acme Shop | Range: Period A: Jun 1–7, 2026 | Period B: May 25–31, 2026

Always check this line. It's how you know the answer covers the site and dates you meant. If it doesn't, say so — "no, I meant last month" — and the assistant will redo it.

After the header you'll get the numbers (as text or a table), then a short interpretation: what stands out, what's unusual, what it might mean. The interpretation is added on top of the data, never instead of it — you always get the real figures.

Where a metric is a Core Web Vital, values are colour-coded against Google's good / needs-improvement / poor thresholds.

Charts

When an answer includes a chart, a View chart button appears under the message. Click it and the chart opens in the right-hand panel.

In the chart panel you can:

Charts are interactive, not pictures — the values you hover are the real ones returned by your Blue Triangle account.

The assistant picks the chart shape that fits your question: trend lines, bar and grouped-bar comparisons, pie and donut breakdowns, scatter plots for correlations, histograms for distributions, and change bars that colour each category by whether it improved or got worse.

Two useful touches you'll see automatically:

• Core Web Vitals threshold bands shaded behind the line, so "is this good?"
  is answerable at a glance.

• Unusual points highlighted on the chart when the assistant spots a spike
  or outlier, rather than only mentioning it in the text.

PDF reports

Ask for a report and you get a proper document: a title, a key-findings callout, the write-up, data tables with readable column headings, and the charts rendered inside it.

A View document button appears under the message. Click it, then:

• Download PDF — saves the file.

• Expand — previews the document in the panel.

Sharing a report

Report links work for anyone you send them to, including people who are not signed in to the assistant. That's deliberate — it's how a report posted into Slack or Teams stays openable by your colleagues.

Treat a report link like a document link, not a password-protected page. Anyone with the link can open it. Share it the way you'd share any file containing your site's data.

Reports are also what you want when someone asks for "the numbers for the quarterly review" — you get one file instead of a screenshot of a chat.

Saving and printing a conversation

Above the conversation there's a Print button. It opens your browser's print dialog with the whole conversation laid out cleanly — every message plus every chart and document, shown inline rather than hidden behind buttons.

From that dialog you can print on paper or choose Save as PDF to keep a copy of the whole exchange.

Use Print for a record of the conversation. Use a report (section 6) for a document you're sending to someone else.

Managing your conversations

Conversations are named after your first message, so ask your real question first and the sidebar labels itself.

Your web conversations are private to you. Slack and Teams conversations stay in Slack and Teams — they don't appear in your web sidebar.

Choosing which site you're asking about

If your Blue Triangle account has access to more than one site, the assistant needs to know which one you mean.

• The first time it needs to know, it asks and lists the sites you can
  access.

• After that it remembers — per conversation on the web, and per channel
  or DM in Slack and Teams.

• To change it, just say so: "switch to Acme Shop", or use /sites in
  Slack or Teams.

• To see your options, ask "which sites do I have access to?" or send
  /sites with nothing after it.

Because the site is remembered per conversation and per channel, two different Slack channels can be looking at two different sites at the same time without interfering with each other. The Site: line at the top of every answer always tells you which one you're getting.

Command reference

Commands are a shortcut for common questions in Slack and Teams. They do exactly what typing the question would do — they're just faster.

Every command must start with / (or !). Anything after it is treated as your time range or focus.

Data commands

Account and settings commands

Examples

/performance last 7 days
/compare this week vs last week
/errors yesterday
/revenue last month
/resource last 7 days
/hits for the homepage yesterday
/chart of LCP over the last 30 days
/report on this month's performance
/sites Acme Shop

With no arguments, most data commands default to the last 7 days; /report defaults to this month's performance, and /compare defaults to this week versus last week.

Mistyped a command? The assistant suggests the closest match rather than failing silently.

Using the assistant in Slack

Add the app from the Slack marketplace (once per workspace)

The bot is listed in the Slack App Directory. You install it into your workspace the same way as any other Slack app.

If it is already installed in your workspace, skip to Invite the bot to a channel and then connect
your Blue Triangle account.

From Slack

• Sign in to the Slack workspace where people will ask questions.

• Open Apps in the sidebar (or More → Apps).

• Search for Blue Triangle.

• Open the listing and click Add to Slack.

• If Slack asks which workspace, pick the right one.

• Review the permission screen and click Allow. The bot asks for:

  • Seeing when it is @mentioned in channels

  • Sending messages (answers, charts, report links)

  • Direct messages — reading and writing — so it can answer privately

  • Slash commands (/performance, /help, and the rest in section 10)

  • Reactions

• Slack confirms the app is installed in your workspace.

From the Slack App Directory in a browser

• Open slack.com/apps while signed in.

• Search for Blue Triangle.

• Click Add to Slack and complete the same permission screen.

If your organization restricts app installs

The install may stall on a request to an admin. A Workspace Owner or Admin approves Blue Triangle under Slack Settings → Manage apps (or the pending-app request list). After approval, open the listing again and click Add to Slack.

Enterprise Grid workspaces may also need an Org Admin to allow the app at the org level before a workspace can install it.

That's the workspace install. Everyone in the workspace can use the bot after that; each person still connects their own Blue Triangle account the first time they ask something.

Invite the bot to a channel

Installing the app puts the bot in the workspace. It still needs to be a member of each channel where people will @mention it:

/invite @Blue Triangle

Direct messages need no invite — open a DM with Blue Triangle and type.

Connecting your account (once, by you)

The first time you ask a question, the bot replies:

• Your BlueTriangle account isn't connected yet.
  [ Connect BlueTriangle ]

Click the button. It opens Blue Triangle's login in your browser. Approve, and you're connected.

Your original question isn't lost. Whatever you asked before connecting is held and answered automatically once you finish. If you asked in several places before connecting, all of them get answered.

You only do this once. Use /re-login if your connection ever expires, or /disconnect to unlink your account.

Three ways to ask

Choosing where answers appear

The first time you ask a question in a shared channel, the bot asks how you'd like it to reply:

• How would you like me to reply to your questions?
  ☑ Remember my choice
  [ Send me a DM ]  [ Reply in this channel ]

• Send me a DM — the full answer goes to your direct message, and only a short note is left in the channel: "@you Sent you the details in our chat."
  Good for keeping busy channels clean, and for data you'd rather not post publicly.

• Reply in this channel — the full answer is posted where you asked.

• Remember my choice (ticked by default) — apply it to this channel from now on. Untick it to decide again next time.

Your choice is remembered per channel, so answering "DM me" in one channel doesn't silently change how a different channel behaves. Send /reset to forget the preference and be asked again.

If the bot can't DM you, it says so in the channel and tells you to check that your Slack settings allow direct messages from apps.

Sharing a DM'd answer back to the channel

When an answer arrives by DM, it comes with a Share in channel button. Click it and the answer is posted back to the channel you originally asked in — useful when you've checked something privately and then decide the team should see it.

Charts and reports in Slack

Charts arrive as images in the message. Reports arrive as a link — click it to open or download the PDF. Anyone in the channel can open a report link, so share the way you would any document.

Slack examples

/help
/performance last 7 days
/compare this week vs last week
/report on this month's performance

@Blue Triangle why did checkout LCP spike on Tuesday?

Using the assistant in Microsoft Teams

Teams works the same way as Slack, with small platform differences.

Add the app from the Teams marketplace (once per team or chat)

The bot is listed in the Microsoft Teams app store (and on Microsoft AppSource). You add it the same
way as any other Teams app.

From Teams

• Open Microsoft Teams (desktop or web) and sign in.

• Go to Apps in the sidebar.

• Search for Blue Triangle (the listing may also appear as BT).

• Open the listing and click Add.

• To use it in a channel, choose Add to a team, then pick the team and
  channel. To chat privately, add it for yourself only.

From Microsoft AppSource

• Open the Blue Triangle listing on AppSource while signed in with your
  work account.

• Choose Get it now / Open in Teams.

• Complete Add or Add to a team as above.

Add the bot to each team where people will @mention it. A 1:1 chat with the bot does not require adding it to a team.

If your organization blocks third-party apps

A Teams administrator must allow the store listing before people can add it:

• Open the Teams admin center.

• Go to Teams apps → Manage apps and search for Blue Triangle.

• Open the app and set it to Allowed.

• Check Permission policies and Org-wide app settings: third-party apps must be allowed for the people who will use the bot.

Admins can also pin the app in a setup policy so it appears in the Teams sidebar for everyone.

Connecting your account (once, by you)

Exactly as in Slack: the first question prompts a Connect BlueTriangle card, you approve in your browser, and your held question is answered automatically afterwards.

Asking

Commands in Teams

Teams doesn't have Slack's built-in slash-command menu, so type the command as an ordinary message:

/performance last 7 days

It works identically — just typed rather than picked from a menu. Everything in section 10 applies.

Everything else

Answers arrive as cards. The same DM-versus-channel choice, the same Remember my choice option, the same /reset, and the same Share in channel button on a private answer all work as described in section 11. A shared answer includes a link back to the channel it came from.

Who can see your data

• You sign in as yourself. The assistant sees exactly the sites and data your own Blue Triangle account can see.

• Connections are per person, not per channel. If a colleague asks a question in the same Slack channel, it's answered against their account, not yours. Nobody borrows anyone else's access.

• Answers posted in a channel are visible to that channel. If a question touches sensitive numbers, choose Send me a DM.

• Report links are shareable by design. Anyone with the link can open the PDF, including people not signed in. Share them accordingly.

• Revenue data requires entitlement. If your account doesn't include revenue access, the assistant will tell you plainly rather than guessing or showing partial figures.

Limits and things it won't do

Troubleshooting

Question library

Copy, adapt, and go.

Daily check

How did the site perform yesterday?
Any new JavaScript errors in the last 24 hours?
Show me LCP by page for yesterday, worst first
Which pages got slower compared to last week?

Investigating a slowdown

Why did checkout LCP spike on Tuesday?
Show LCP by hour for Tuesday
Break down Tuesday's LCP by browser and device
Which third-party domains were slowest on Tuesday?
Show me the raw page hits for the checkout page on Tuesday

Weekly or monthly review

Compare this week's performance to last week
Show LCP, CLS and INP each as its own trendline for the last 30 days
Which countries have the worst INP this month?
Give me a report on this month's performance I can send to my team

Errors

What were the top JS errors yesterday?
Which pages are producing the most errors this week?
Are there any CSP violations in the last 7 days?
Has the error rate changed since last month?

Third parties and resources

Show resource and domain timing for the last 7 days
Which hosts add the most load time on the product page?
Compare third-party timing this week to last week

Revenue (requires revenue access on your account)

Show revenue for last week
What's our conversion rate by device this month?
Did the slowdown on Tuesday affect conversions?
Compare revenue and bounce rate this month to last month

Producing something to share

Give me an audit of the checkout page I can send to my team
Build a report on this quarter's Core Web Vitals
Chart LCP over the last 90 days
Summarise this month's performance for a non-technical audience