> For the complete documentation index, see [llms.txt](https://docs.omnichat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnichat.ai/en/features/omni-ai-add-on-feature.md).

# Omni AI

Omni AI can use your knowledge base to answer common inquiries, streamline repetitive support tasks, and provide product suggestions tailored to customer preferences.

{% embed url="<https://drive.google.com/file/d/1mtwDaiHCT6mhT7-azW63RC9LXWCri_zS/view?usp=sharing>" %}

## Introduction

AI isn't just a trend anymore. It's becoming an essential tool that helps level up your customer service. When used well, it can answer questions faster, lighten your team's workload, boost overall efficiency, and even suggest the right products based on what customers are looking for. Together, these improvements can make a real difference to your bottom line.

With Omnichat's upgraded AI feature, you can build your own knowledge base and set up auto-replies for frequently asked questions. This frees up your team from handling repetitive tasks, so they can focus on more complex cases that need a human touch. The chatbot can also suggest products based on customer preferences, helping you improve both support and sales.

In this article, we'll show you how to set up your chatbot in Omnichat console so it becomes your team's go-to assistant on the front line.

This article shows how to set up Omni AI in Omnichat console to assist with frontline customer service.

1. Upload Knowledge Documents in Knowledge Base
   * [Access Roles for Knowledge Base](#access-roles)
   * [Overview](#overview)
2. Create a New AI Agent in Agent Studio
   * [Access Roles for Agent Studio](#access-roles-1)
   * [Agent List](#agent-list)
   * [Agent Categories](#agent-category)
     * [Service Agent](#service-agent)
     * [Sales Agent](#shopping-agent)
3. [Build AI Agent Cards in Chatbot 2.0](#build-ai-agent-cards-in-bot-builder-2.0)
   * Step 1: [Create a New AI Agent Card and Select an AI Agent](#step-1-create-a-new-ai-agent-card-and-select-an-ai-agent)
   * Step 2: [Preview and Edit the AI Agent Card](#step-2-preview-and-edit-the-ai-agent-card)
   * Step 3: [Add the AI Agent Card to the Service Flow](#step-3-add-the-ai-agent-card-to-the-service-flow)
   * [AI Agent Card Trigger Process & Conversation Handling](#ai-agent-card-trigger-process-and-conversation-handling)
   * [Notes on Using AI Agent Cards](#notes-on-using-ai-agent-cards)

{% hint style="success" %}
**Recommended Way to Write a Knowledge Document**

💡 **Service Agent**

* Creating a Q\&A set in CSV file:
  * Column 1: Frequently asked questions.
  * Column 2: Suggested answers.
  * You may use extra columns to include extra details, such as question category or reference links.
  * See the example below for content.

💡 **Sales Agent**

* Creating a product list in CSV file:
  * You can include product details such as product name, product image (must be a URL), product description, price, and URL.
  * You may also add extra columns for any other information as needed.
  * See the example below for content.

💡 **Things to note when uploading a knowledge document:**

* The system does not support image recognition and only reads plain text in the file.
* To ensure accurate responses, make sure the file includes sufficient and well-structured text content. The more complete the information, the better the AI can respond.
  {% endhint %}

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FvQqsAWMbtqij5LkRg9nF%2Fimage.png?alt=media&amp;token=c69cf31f-f163-4310-aab0-94fef16aa269" alt=""><figcaption></figcaption></figure>

This displays all established Agents, which come in two types: Customer Service Agents and Sales Agent\
The category of each Agent is shown in the top left corner, and you can also tell the difference by the icon.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FIH87YQ3Pjd2kDLWOPsDi%2Fimage.png?alt=media&amp;token=21f70dd6-bcfc-4e5a-8c1c-501618507b2a" alt=""><figcaption></figcaption></figure>

#### Sales Agent

{% hint style="info" %}
Sales Agent currently does not support content personalization settings.
{% endhint %}

### Supports connecting enterprise-built AI Agents in the Omnichat backend (additional purchase required)

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fdw2Tqw6CiUl3XQ5pwcas%2Fimage.png?alt=media&amp;token=dc275883-f7f8-475a-b649-5d0478930f6a" alt=""><figcaption></figcaption></figure>

Omnichat allows customers to connect their AI Agents to the Omnichat messaging platform via the Open API. To use this feature, please contact your business representative or the Omnichat support team through the chat plugin in the bottom right corner of the backend console.

{% hint style="info" %}
Please note: A team can only add "one" Bring Your Own AI.
{% endhint %}

#### Steps to setup

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FMGmV9z0nI6gs2u7H7D95%2Fimage.png?alt=media&amp;token=3494100b-5701-4e4d-b0f4-dcdab4173625" alt=""><figcaption></figcaption></figure>

1. Enter endpoint URL & header auth for webhook
2. Test endpoint → Only after successful verification can the endpoint URL and header auth information be stored. \
   If verification fails, the following error message will be displayed.\
   ![](https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FiTLjMNVqcu4GKm8PyLP9%2Fimage.png?alt=media\&token=caba0d05-35da-4b15-9e8b-b9041683ab76)
3. Connect to the Open API (see [technical documentation](https://developers.omnichat.ai/password?redirect=/docs/ai-agent-integration-guideline)). The following APIs are available:
   1. /agent-messages (sends one-to-one messages)
   2. /rooms/to-human-agent (conversations transition from AI to human)
   3. /rooms/close AI (ends conversation)
   4. /rooms/trigger-auto-assign (AI will redirect the conversation to a designated human)
4. Create a robot module and add an AI Agent card (see the next paragraph for instructions), then select the existing AI Agent.
5. Precautions:
   1. Before editing or disabling a connected agent, please ensure that:
      1. The AI ​​Agent card has been removed from the robot module in use.
      2. The AI ​​agent has no ongoing conversation.
   2. Endpoint testing must be performed every time the webhook URL or header auth is edited.

### Build AI Agent Cards in Chatbot 2.0