Use AI assistance with Teamboards

A teamboard is a shared performance board that organises a plant's daily numbers into sections, most often the SQDCP categories: Safety, Quality, Delivery, Cost, and People. Each section holds widgets, and one of the most common widgets is a KPI chart. A KPI (Key Performance Indicator) is a single tracked measure such as scrap rate or production volume.

AI assistance lets you build those KPI charts by describing what you want in plain language instead of clicking through the widget picker and KPI settings yourself. The assistant is a chat helper named Hugo. On a teamboard it reads your board, finds the right section, and adds the chart for you.

When to use itCopy Anchor Link

Use the assistant when you are laying out or adjusting a teamboard and you want to add KPI charts quickly. It is well suited to:

• Adding a chart for a KPI that already exists, without opening the widget marketplace.
• Creating a sensible starter KPI and its chart in one step when no suitable KPI exists yet.
• Checking what a board already contains before you add more.

For fine layout work, indicator styling, or reordering, keep using the board's own edit controls. The assistant focuses on adding KPI charts, not on every editing action.

Before you startCopy Anchor Link

The assistant only appears while you are editing a teamboard, and it can only change the board if your role allows it.

• Open a teamboard and enter edit mode. Open the board, then use the gear (Enter edit mode) control in the top bar. The floating assistant button appears only in edit mode.
• Permission to use the assistant. Your role needs the Use chat / AI assistant permission (chat.use). Without it, the chat will not send messages.
• Permission to change the board. For the assistant to actually add a chart, your role needs Update teamboards (teamboards.update). Every board change the assistant makes is checked against this permission and recorded in the audit trail.
• Access to the board's plant. You must have access to the entity (plant) the teamboard belongs to. The assistant only offers KPIs that are available to that plant.

By default the Super user, Entity admin, and Manager roles have both the chat.use and teamboards.update permissions, so people in those roles can use teamboard AI assistance out of the box. Other roles need those two permissions added before the assistant can change a board.

Open the assistantCopy Anchor Link

While a teamboard is in edit mode, a round chat button sits in the bottom-right corner of the screen. Select it to open the assistant panel.

The centred dialog header shows the assistant name, Hugo, with a small teamboard badge so you know it is scoped to board actions. Before you type anything, the empty dialog shows the title Teamboard Assistant and the line "I can help you configure your teamboard and manage KPI displays." The message box reads Ask about teamboard configuration..., and two starter suggestions appear, including Add a KPI chart to the Quality section.

What the assistant can doCopy Anchor Link

On a teamboard the assistant has a small, focused set of actions. It can:

• Read the current board. It looks at your sections, the KPI charts already placed, and the KPIs available to the board's plant. It does this automatically before making a change.
• Add an existing KPI as a chart. When you name a section and a KPI that already exists, it places that KPI's chart in the section.
• Create a KPI and add its chart. When no suitable KPI exists, it creates one with sensible defaults for the section and then adds the chart.
• Look up KPI definitions. It can search existing KPIs and read their details to pick the right one.

To ask for a chart, name the section you want it in. You can type a request such as "Add a scrap rate chart to Quality" or select the Add a KPI chart to the Quality section suggestion. The assistant matches your words to a section (by its name or its SQDCP letter), adds the chart, and replies with a short confirmation such as Added First Pass Yield as a chart in Quality.

Defaults when the assistant creates a KPICopy Anchor Link

When you ask for a chart and no matching KPI exists, the assistant creates one using defaults that fit the section. New KPIs are always manual-entry KPIs, which means someone types the values in rather than the value coming from an automated feed. The starting points are:

• Quality: Scrap Rate, measured as a daily percentage, averaged, where lower is better. A yield or right-first-time request uses a percentage where higher is better.
• Safety: Safety Incidents, a count, entered daily, summed, where lower is better.
• Delivery: Production Volume, a count, entered daily, summed, where higher is better.
• Cost: Cost per Unit, a currency amount, entered monthly, averaged, where lower is better.
• People: Overtime Hours, a time value, entered weekly, summed, where lower is better.

You can override the name, description, unit, frequency, aggregation, or target direction in your request, and you can adjust the KPI later from the KPI settings. If you name a KPI that already exists in the section, the assistant reuses it instead of creating a duplicate.

Example: requesting a chart on Gotham Quality ReviewCopy Anchor Link

Bruce Wayne opens the separate Gotham Quality Review line board and enters edit mode. The assistant's starting dialog identifies Hugo and the teamboard context. Bruce asks it to add the existing Right First Time KPI to Quality, reusing its values and targets rather than creating another KPI.

Hugo confirms that it added Right First Time to Quality on Gotham Quality Review. Close Hugo and check the chart on the board. If it is not visible while you are editing, select Exit edit mode to view the saved board before saving any manual changes.

What to expectCopy Anchor Link

• The assistant adds a KPI chart widget to the section you named, at the end of that section.
• It replies with a short confirmation that names the KPI and the section, and whether it created a new KPI or reused an existing one.
• Board changes are real writes checked against your teamboards.update permission and recorded in the audit trail.
• If it cannot act, it tells you the exact reason in plain language, for example that it could not match a section or that a KPI is not available for the board's plant.

Limitations and feature stateCopy Anchor Link

• KPI charts only. The assistant's board actions are limited to adding KPI charts (existing or newly created). It does not build other widget types.
• No indicator colour changes. One starter suggestion mentions configuring indicator colours, but there is no assistant action that changes colours today. Set indicator colours yourself using the board's edit controls.
• Manual KPIs only. KPIs the assistant creates are manual-entry KPIs. If you need an automated or calculated KPI, create it from the KPI settings instead.
• Edit mode only. The assistant button is only present while the board is in edit mode. It disappears when you exit edit mode.
• Use New chat for a fresh conversation. Closing and reopening the dialog while editing retains its current messages. New chat starts a separate conversation; closing is not a delete action.
• Requires AI to be configured. The assistant depends on the AI service being set up for your deployment. If it is not configured, the assistant cannot answer. Contact your administrator if the assistant never responds.

TroubleshootingCopy Anchor Link

• No chat button on the board. The button only shows in edit mode. Enter edit mode with the gear control, and confirm you have access to the board's plant.
• The chat will not send your message. Your role may lack the Use chat / AI assistant permission (chat.use). Ask an administrator to add it.
• The assistant says it could not add the chart. If it asks you to choose a section, name one of the board's sections (for example Quality) or its SQDCP letter in your request. If it says a KPI is not available for the board, that KPI is scoped to a different plant; pick a KPI available to this board's plant or let the assistant create one.
• The chart is not visible after a positive reply. Close Hugo and select Exit edit mode to check the saved board before saving manual changes. If the chart is still missing, confirm your role has Update teamboards (teamboards.update). The chat and board update need separate permissions.

Related guidanceCopy Anchor Link

• Teamboards overview
• Use and manage a Teamboard
• Create a Teamboard report
• Select a Teamboard plant
• KPIs overview
• Use AI assistance with KPIs