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

# Create Your First AI Agent

Make your first AI Agent with BotPeguin!

### What is an AI Agent?

An AI agent is a digital assistant that talks to your customers on your behalf. It answers from the instructions and the knowledge you give it. It can also use tools, such as Google Calendar, to take actions. You decide its tone, what it knows and where it works.

***

### Key definitions

| Term              | Meaning                                                                         |
| ----------------- | ------------------------------------------------------------------------------- |
| Channel           | The place where customers talk to your agent, such as your website or WhatsApp. |
| Use case          | The job you want the agent to do, such as customer support or lead generation.  |
| Core instructions | The text that tells the agent how to behave and what to know.                   |
| Tool              | An app or action the agent can use, such as Google Sheets or Google Calendar.   |
| Training          | The websites, files, FAQs and text snippets your agent learns from.             |

***

### Steps

1. Click **AI Agent** in the left menu.

![Click AI Agent in the left menu](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/NatXcs4Mm5e4xOADWR4F/images/introduction-to-ai-agent-step-1.png)

2. Click **New Agent** on the top of the sidebar. This starts the onboarding flow.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FZ8g1SbHyhqaiB03ExAhb%2Fimage.png?alt=media&amp;token=6d6d53f9-2507-432c-b49c-a0ce25b3ef0e" alt=""><figcaption></figcaption></figure>

3. On Select Channel, click the channel you want. Your choices are&#x20;
   1. Website
   2. WhatsApp
   3. Instagram
   4. Facebook
   5. Telegram and,
   6. Phone.&#x20;

{% hint style="info" %}
This example follows the onboarding for a Website AI Agent
{% endhint %}

![Choose the channel on the Select Channel step](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/Sr294Vl2qbPuD8039XvF/images/introduction-to-ai-agent-step-3.png)

4. On the **Use Case** screen, click the role that fits bests your goal. You can pick a ready-made use case or click **Start from Scratch** to begin with a blank agent. You can also click Browse all templates to see more.

![Click Start from Scratch to build a blank agent](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/CnbiVM08RfHkOnEEQKMe/images/introduction-to-ai-agent-step-4.png)

5. On **Prompt & Tools**, type your Core Instructions. Describe how the agent should behave and what it should know.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FjfEOB1lwl7twU1uezWFN%2Fimage.png?alt=media&amp;token=adfb1188-37e4-4950-8cb8-1f474030aaa4" alt=""><figcaption></figcaption></figure>

6. Connect external tools with your prompt by using the search button to search for tools. A list of tools appears under the box. This step is optional.

![Search for a tool to connect, if you want one](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/KPoeqAgO6PHPqn7Gj9Ne/images/introduction-to-ai-agent-step-6.png)

7. Click **Continue**. On Train Your Agent, choose where the agent learns from: Website, Files, FAQs or Text snippets. This step is optional.

![Choose a training source on the Train Your Agent step](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/Sit2dhEKqCgGHhazQwne/images/introduction-to-ai-agent-step-7.png)

8. Click **Continue**. On Design Your Agent, type an Agent Name. You can also pick an avatar, theme colors and ice breakers. This step is optional.

![Type a name for your agent on the Design Your Agent step](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/OWOONxrQM3fB7VGtlygz/images/introduction-to-ai-agent-step-8.png)

9. Click **Continue**. On Install Agent on Website, click **Get Agent Installation Code** and copy the code into your website. You can also share the code or ask the support team to help you install it.
10. Once the script is added to the website, add your website URL in **Enter your Website URL** box and click on verify. This step is optional.

![Get the installation code on the Install step](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/LVxFZnFPsHKTAzdgte0U/images/introduction-to-ai-agent-step-9.png)

10. In case you want to skip the installation now, click on **I'll Install later** to skip the installation of the agent.

![Click View agent to open your new agent](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/6ocA8IDFE5fKwqgLjEAB/images/introduction-to-ai-agent-step-10.png)

{% hint style="info" icon="face-party" %}
And thats it! You have successfully created and deployed your first AI Agent on BotPengiun! :confetti\_ball::confetti\_ball:
{% endhint %}

***

### Best practices

Write your Core Instructions with these rules. They help the agent give steady, useful answers.

* **Say who the agent is.** Start with its name and role. Example: "You are a customer support agent for Acme Inc."
* **State the main goal.** Example: collect leads, or book appointments.
* **Break the task into steps.** Use short numbered steps, such as greet, ask a question, then act.
* **List the tools it can use.** Write each tool with a slash, for example `/add_to_crm/`. In the product, type `/` to insert a tool.
* **Say what you want, not what you do not want.** Write "Always thank the customer" instead of "Do not ignore the customer".
* **Match the tone to your Communication style.** If the instructions say "joyful", do not set a formal style.
* **Add a short example conversation (optional).** It shows the agent the tone you expect.

***

### Common errors

<details>

<summary>I do not see New Agent</summary>

New Agent is in the left sidebar after you click AI Agent in the left menu. If AI Agent is missing from the left menu, your plan may not include AI agents. Check your plan under Subscriptions.

</details>

<details>

<summary>The Continue button is grey</summary>

A step with a red star needs an answer first. On Prompt & Tools, type your Core Instructions. Steps marked Optional can be skipped.

</details>

<details>

<summary>I clicked a channel and the wizard moved on. How do I go back?</summary>

Click \*\*Back\*\* at the bottom of the page. Choosing a channel or a use case moves you to the next step on its own.

</details>

<details>

<summary>I closed the wizard before I finished</summary>

Click \*\*Skip\*\* to leave the wizard. You can finish the rest later from the Overview page of your agent. See Use the AI agent Overview page.

</details>

<details>

<summary>My agent does not answer on my website</summary>

The agent must be installed on your website and switched on. Check the Installed tag and the Active switch on the Overview page.

</details>

<details>

<summary>Can I use more than one channel with one agent?</summary>

Yes. You pick one channel while you create the agent. You can add more under the Channels section later. \[CHECK: confirm this on the screen.]

</details>

### Support

Still not working? Write to us at <support@botpenguin.com>. We will reach out to you within 24 hours.
