> For the complete documentation index, see [llms.txt](https://help.zaapi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.zaapi.com/ai-agent-2.0/whats-new-in-ai-agent-2.0.md).

# What's new in AI Agent 2.0

What changed between AI Agent 1.0 and 2.0, and what to check when your store moves over.

AI Agent 2.0 is a rebuild of the Zaapi AI Agent. In 1.0 the AI answered questions. In 2.0 it can also follow your step-by-step processes and take actions, like looking up an order or assigning a ticket. You also get much more control over testing and publishing changes.

## At a glance

|                      | AI Agent 1.0                      | AI Agent 2.0                                                                                                                                                     |
| -------------------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Number of agents** | One AI Agent per store            | Up to 100 agents per workspace, each with its own name, instructions, language and integrations                                                                  |
| **How you teach it** | Knowledge sources and Scenarios   | Knowledge sources and **Procedures** (Procedures replace Scenarios)                                                                                              |
| **What it can do**   | Reply to customers                | Reply **and** take actions: look up orders, search products, update ticket and contact fields, assign or close tickets, send set messages, call your own systems |
| **Your own systems** | Not supported                     | **Custom actions** call any API you control, such as your CRM, loyalty or booking system                                                                         |
| **Changes**          | Edits went live straight away     | Every knowledge source and procedure has **versions**: draft, test, publish, and go back if you need to                                                          |
| **Testing**          | Basic test chat                   | A full **test chat** with mock customers, mock orders and mock action results, plus the agent's reasoning for every reply                                        |
| **Analytics**        | Overview charts                   | Per-agent analytics: AI-involved tickets, full and partial resolution, AI CSAT, breakdown by channel, ROI and message logs                                       |
| **Deployment**       | AI switched on or off per account | **Easy deployment** (the AI handles every chat on the integrations you choose) or **Flow Builder** (the AI handles only the steps you place it in)               |

## The biggest changes

### Several agents instead of one

You can now run up to 100 agents in one workspace. Each agent has its own instructions, language and integrations, so you can have one agent per brand, per market or per group of channels. See [Create and configure an agent](https://help.zaapi.com/ai-agent-2.0/create-and-configure-an-agent.md).

### Procedures replace Scenarios

A procedure teaches the agent how to handle one type of request, step by step, like the standard operating procedure your team follows. Unlike Scenarios, procedures can run actions. See [Procedures](https://help.zaapi.com/ai-agent-2.0/procedures.md).

### The agent can take actions

The agent can now do things, not just reply: look up an order, search your products, update a ticket or contact field, assign or close a ticket, or send a set message. With custom actions it can also call your own systems. See [Actions and system actions](https://help.zaapi.com/ai-agent-2.0/actions-and-system-actions.md).

### Nothing goes live until you publish it

Knowledge sources and procedures now have versions. You edit a draft, test it, and publish it when it's ready. Customers only ever see published versions. See [Shared resources, versions and publishing](https://help.zaapi.com/ai-agent-2.0/shared-resources-versions-and-publishing.md).

### A safe place to test

The test chat lets you talk to the agent as a customer, with a mock customer, mock orders and mock action results. For every reply you can see the agent's reasoning: which procedure it followed, which knowledge it used and which actions it ran. See [Test your agent](https://help.zaapi.com/ai-agent-2.0/test-your-agent.md).

### Two ways to go live

Use **Easy deployment** to have the agent answer every conversation on the integrations you choose, or place the agent inside a flow with **Flow Builder** so it only handles the steps you decide. See [Deploy your agent](https://help.zaapi.com/ai-agent-2.0/deploy-your-agent.md).

## Moving from AI Agent 1.0

You don't have to rebuild your setup. Zaapi moves existing AI Agent 1.0 stores to 2.0 for you, so the AI keeps working for your customers.

| Your situation                                                | What happens                                                                                                                                                                           |
| ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| You're new to Zaapi, or you've never switched the AI Agent on | You start on AI Agent 2.0. There is nothing to migrate.                                                                                                                                |
| You use the same AI setup on all your integrations            | Zaapi moves your setup to 2.0 for you, as a single agent called **AI Agent**.                                                                                                          |
| You use different AI setups on different integrations         | The Zaapi team migrates your store for you and will be in touch. In 2.0, settings belong to an agent rather than to an integration, so you'll usually end up with more than one agent. |

AI Agent 1.0 will be retired by the end of 2026.

### Where your 1.0 setup lives in 2.0

| In AI Agent 1.0               | In AI Agent 2.0                                                                                                                         |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| Knowledge                     | [Knowledge sources](https://help.zaapi.com/ai-agent-2.0/knowledge-sources.md)                                                           |
| Scenarios                     | [Procedures](https://help.zaapi.com/ai-agent-2.0/procedures.md)                                                                         |
| Persona                       | The agent's **Instructions**. See [Create and configure an agent](https://help.zaapi.com/ai-agent-2.0/create-and-configure-an-agent.md) |
| AI switched on for an account | The agent's integrations, plus how it's deployed. See [Deploy your agent](https://help.zaapi.com/ai-agent-2.0/deploy-your-agent.md)     |

### What to check after your store moves

1. **Knowledge.** Open **Knowledge sources** and check that each source is there, reads correctly and is **Published**. Agents only read published versions.
2. **Procedures.** Check that every Scenario you relied on in 1.0 has a matching procedure. Procedures can now run actions, so steps that used to say "escalate to an admin" can often be automated.
3. **Agent settings.** Open the agent and check its instructions, response language and integrations.
4. **Test.** Ask your top customer questions in the test chat and check the answers. See [Test your agent](https://help.zaapi.com/ai-agent-2.0/test-your-agent.md).
5. **Deployment.** Open **Deploy agent** and check where the agent is live and who it escalates to.

{% hint style="info" %}
Once you're on 2.0, a good first improvement is to add one procedure with an action, for example an order status procedure that looks up the order. See [Procedure examples](https://help.zaapi.com/ai-agent-2.0/procedure-examples.md).
{% endhint %}
