> For the complete documentation index, see [llms.txt](https://doc.aissist.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.aissist.io/capabilities/ask.md).

# Ask Engine

Ask Engine is the assistant in the Aissist console. Ask it anything about your workspace - traffic, escalations, conversations, changes, evaluations - and have it draft sub-agents, actions, assets and

*Last updated: November 1, 2026*

Ask Engine is the assistant built into the Aissist console. Ask it a question in plain words and it answers from your workspace's own data. Describe what you need and it drafts it for you to review. Open it from **Ask** in the sidebar, or type a question into the box in the top bar.

### Why it matters

The answers you need are already in your data, but they are spread across dashboards, sessions, settings and change history. Ask Engine pulls them together in one place. It does the digging a support lead or an operations manager would otherwise spend an afternoon on: reading conversations, counting escalations, comparing weeks, and pointing to the exact fix.

### What Ask Engine answers

Ask Engine reads your workspace, its conversations and its project, and answers with counts, charts, tables and the sources it used.

**Traffic and resolution**

> Analyze the traffic of the last 24 hours. Anything unusual compared with last week?

> How did the Returns sub-agent's resolution change since October 1?

**Why conversations escalated**

> List the main reasons for escalation in recent conversations, and how to reduce them.

> Which sub-agents hand over most, and what is missing that would let the AI finish?

**What customers ask about**

> What are the most common issues this week?

> What are customers complaining about and praising? How could we improve NPS?

**What changed, and who changed it**

> What changed in the workspace this week, and could any of it explain the drop in resolution on Tuesday?

> Who last edited the Refund sub-agent, and what did they change?

**One conversation in depth**

> Why did the AI answer the way it did in this conversation?

> What was retrieved, what was used, and what was missing?

Open any conversation in **Deploy → Sessions** or **Try** and click **Ask about this session** to ask about that conversation alone. Ask Engine reads what the AI was working from at each turn: the sub-agent, the instruction it followed, what it retrieved and from where, which actions ran and what they returned, and how long each step took.

**Setup and quality**

> Which gateways are deployed, and is each connection still valid?

> What can the AI actually do here - which actions does it have?

> How did last week's evaluation runs score, and what went wrong in the failed ones?

> Look into agent insights: what went well and what can improve, without naming agents.

**Aissist itself**

> What is the difference between a sub-agent and an asset?

Ask Engine searches the Aissist documentation and site for product questions.

### What Ask Engine creates

Describe what you want and Ask Engine drafts it from what your workspace already knows: your assets, your sub-agents, your connectors and your real conversations. **Nothing is created until you review it and confirm.**

| You want               | Where to start                                  | What Ask Engine does                                                                                   |
| ---------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| A workspace            | **Create New Workspace** in the workspace menu  | Reads your website (and help desk, if connected) and proposes the workspace, its sub-agents and assets |
| A sub-agent            | **Workspace → Sub Agents → Add Sub Agent**      | Writes the instruction from your knowledge and checks it against existing sub-agents                   |
| An action              | **Workspace → Actions**, create                 | Picks the right connector and operation, and the sub-agents that should use it                         |
| An asset               | **Workspace → Assets**, create                  | Sets up a website, page or document for the right sub-agents                                           |
| An evaluation set      | **Insight → Evaluation → Add Evaluation**       | Writes the scenario and measurements from real conversations                                           |
| An Agent Insight set   | **Agent Insight → Config → Add Evaluation Set** | Writes the role and what it is scored on                                                               |
| Continuous Learn items | **Ask**                                         | Previews each add, change or delete; writes it only after you agree in your next message               |

For example, on the create sub-agent page:

> Items that arrive damaged - take the order number and photos, explain the replacement window, hand over if they want a refund instead.

On the create action page:

> Look up an order's shipping status by order number when a customer asks where their parcel is.

If you ask for one of these on the **Ask** page itself, Ask Engine drafts it and tells you where to create it.

### Scope and safety

* **One workspace at a time.** Ask Engine works in the project and workspace selected in the console, shown under the question box. It only reads that workspace's data, and project-level data such as evaluations and agent insights of that project.
* **It reads, it does not change your systems.** Ask Engine can run an action that only reads, such as an order lookup, to check what it returns. It never runs an action that would change something outside Aissist.
* **You confirm every change.** Drafts are created by you, on the page made for them. Continuous Learn changes wait for your agreement.
* **Your history is kept.** Earlier Ask Engine conversations are listed beside the chat, so you can pick one up again. Use the feedback button to tell us how Ask Engine did.

### Shortcuts into Ask Engine

* **Dashboard** - **Diagnosis** next to a sub-agent asks for its main topics, the top gaps and what to do.
* **Deploy → Sessions** and **Try** - **Ask about this session**.
* The top bar - type a question from any page.

### Best practice

* Ask the question you would ask an analyst, with the period and the sub-agent if you have one in mind.
* Follow up. "Show me three examples" or "only for email" refines the last answer.
* Ask why before changing something: one conversation read in depth beats a guess.
* Review every draft before you create it. Ask Engine writes from your data, but you know your business.

### Related

* [Continuous Improvement](https://doc.aissist.io/capabilities/continuous-improvement.md)
* [Evaluation](https://doc.aissist.io/capabilities/evaluation.md)
* [Agent Insight](https://doc.aissist.io/capabilities/agent-insight.md)
* [Create a Workspace](https://doc.aissist.io/tutorial/create-workspace.md)
