SquidSupport
Product reference / AI

Assistant

In the app: AI → Assistant

Needs the 'View AI Config' permission.

The Assistant page is the everyday view of one store's AI agent: whether it is answering customers, which configuration it uses, what it knows, what it can do, and a panel to try it. Everything on the page is about the store and channel selected at the top.

Store and channel

The store picker next to the page title chooses the store. Everything below is read for that store. If you have unsaved work elsewhere on the page, you are asked to confirm before the store changes.

"Chat" and "Email", at the right of the tabs, choose the channel. A store can use one configuration for chat and another for email, so the knowledge, the actions and the setup steps can differ between the two. WhatsApp follows the chat configuration.

"Test & go live" at the top opens the store's setup guide on its last step, where you test the agent and choose between drafts and automatic sending.

Seeing the page needs the 'View AI Config' permission. Switching answering on or off and opening a configuration or knowledge change need the 'Edit AI Config' permission; without it those controls are disabled and say why. Running "Try it" needs 'View AI Config', without requiring 'Edit AI Config'.

Answering customers

Needs the 'Edit AI Config' permission.

The switch at the top right shows "Live" or "Off" and turns the AI agent on or off for the selected store. It is one switch for the store: it covers chat and email together, whichever channel is selected.

Switching on opens "Start answering customers?". The dialog tells you what will happen: whether replies are sent automatically or saved as drafts for your team, which configuration each channel uses, and a warning when one of the two channels is not set up, in which case the agent only replies on the other. "Switch on" confirms; "Cancel" leaves it off.

  • The switch stays disabled until the setup steps for the selected channel are done. The tooltip says how many steps are done.
  • If the store is set to send replies automatically, switching on is refused unless the current configuration and relevant store settings have matching passing test evidence from this store in the last 30 days, on the relevant channel with automatic sending tested. Test it under "Test & go live" first. A store that prepares drafts can be switched on without a test.
  • Switching on is also refused without an active main prompt in the configuration or saved for the store, when referenced specialists are not ready, when the agent has no name, or when unresolved failed Builder policy checks block it. The message says what to fix.

Switching off opens "Stop answering customers?". After "Switch off" the agent stops replying on chat and email for this store and new conversations wait in the inbox for your team. Your setup is kept: knowledge, instructions and settings stay as they are, and you can switch back on at any time.

The change applies at once. Switching the agent on or off here does not change whether replies are sent automatically or as drafts; that is set under "Technical settings" or "Test & go live".

Assistant summary

The card under the header has four cells.

  • "Assistant": the name customers see on replies. "No name yet" means none is set; add one under "Technical settings".
  • "Configuration": the configuration set the store uses on chat and on email. "None" means no set is assigned for that channel.
  • "Replies": "Sends automatically", where replies go to the customer without review, or "Drafts for review", where each reply waits in the ticket for a teammate to send.
  • "Setup": "Ready" when all four setup steps are done, otherwise how many are done, with "Show steps" and "Hide steps".

The setup steps, for the selected channel, are:

  • "Shopify connected": the store has a saved Shopify connection. This checks that a connection is stored, not that Shopify is reachable right now. "Review connection" opens Settings → Integrations.
  • "Configuration chosen for chat" (or email): a configuration set is assigned. "Change" opens the list of configuration sets.
  • "Instructions written": an active main prompt is available and not empty, either in the configuration or saved directly for the store. "Write instructions" opens a draft in the Builder.
  • "Name customers see": the assistant has a name. "Add a name" opens the AI settings of the store.

"Change assistant" opens a draft of the store's configuration in the Builder, where you describe the change in chat and review it before it goes live. Nothing changes for customers when the draft is opened.

"Technical settings" opens AI → Advanced settings for this store and configuration.

Knowledge

The "Knowledge" tab lists the saved knowledge of the configuration the assistant uses on the selected channel: facts such as shipping times, return rules and contact details that the agent answers from. The number on the tab is how many items there are. A line above the list names the configuration the items come from.

Each row shows the item's title and the start of its text. Click the row to read the whole text and the short name it is saved under. The columns show how the item was used in the last 28 days across the configuration’s stores and channels, rather than only the selected store and channel:

  • "Replies": how many AI replies used the item.
  • "Handoff rate": the share of those replies associated with a handoff to a person. A handoff logged up to ten minutes before the saved usage also counts. It turns amber from 30%.
  • "Feedback": thumbs up and thumbs down given by your team on replies that used the item.
  • "Last used": when a reply last used it.

A "Needs review" badge appears when an item got three or more thumbs down in the last 14 days, or when a Squid Agent proposal to change it is waiting. "Proposal waiting" opens that proposal.

Above the list:

  • "Add knowledge", "Add with AI" (or "Add with Squid Agent" when you can use Squid Agent) and "Import from your website" each start a change. "Edit" on a row does the same for that item. The Builder entry points open a draft for review and publication. "Add with Squid Agent" opens Squid Agent to prepare a proposed change for approval.
  • "Search knowledge" appears when there are more than five items and searches titles, short names and text.
  • The filters "All", "Needs review" and "Not used in 28 days" narrow the list. They appear once the usage figures have loaded.

With no knowledge yet, the tab shows an empty state with the same three buttons.

Answers in the chat widget's FAQ are separate from this list. The "Saved FAQ" link opens them under Settings → Chat Widget.

Actions

The "Actions" tab lists what the assistant can do on the selected channel besides writing text: looking up an order, starting a return, offering a refund, tagging or closing a ticket, handing over to your team. The number on the tab counts the actions that are available or need setup.

Actions are grouped: "Orders", "Returns", "Refunds and offers", "Hand-offs and cancellations", "Tickets", "Customers", "Google Sheets" and "Other". Each row has a state:

  • "Available": the assistant can use it.
  • "With conditions": it can use it in some conversations only, for example only on conversations handled as returns. The row says which.
  • "Needs setup": it is switched on but something is missing. The row says what, with a link: "Connect" for a missing integration, "Change reply mode" when the action is held back while the store prepares drafts, "Tags" when there are no tags to apply.
  • "Off": switched off, or not part of the assistant's instructions. These are folded under "Other actions" at the bottom.

"Details" on a row shows the technical name, whether the action changes data or only looks things up, what decided its state ("Platform default", "This configuration", "This store" and so on) and which integration it needs.

This tab is read-only. Actions are switched on and off under "Technical settings", on the Tools tab of the configuration.

Try it

"Try it" is a test conversation with the store's agent, shown beside the tabs on a wide screen and behind the round "Try it" button on a narrow one. Write a message as a customer and the agent answers with the configuration the store runs now.

Nothing is sent to a customer. Lookups use your live data; anything that would change an order, a refund or a customer is simulated. You can test while the agent is switched off. Each message uses one of the organization's test runs.

The channel buttons, "Start over", the step labels under each answer and the test-run allowance work the same as in the Playground, which also lets you replay real tickets.

Notices and the More row

Two notices can appear under the summary:

  • "Tracking isn't connected.": the saved integration status does not show ParcelPanel as connected for this store. The notice warns that tracking questions go to a person. This notice does not test a tracking lookup. Order lookups can still provide shipment information from Shopify. "Connect ParcelPanel" opens Settings → Integrations.
  • "Refund Hub is off": the AI can still offer refunds, but every refund it tries to submit goes to a person. "Enable Refund Hub" is shown to people who may change general settings.

The "More" row at the bottom links to related pages: "Configuration versions" (the configuration set the store uses), "Live experiments", "Playground" and "Performance".