> 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/prompts-and-tools.md).

# Prompts and Tools

In this guide you write your agent's instructions and choose the tools it can use during a chat.

### What are Prompts & Tools?

The Prompt & Tools page is where you tell your AI agent how to behave. You write a prompt, connect tools such as Google Calendar, and set a communication style. Together these decide what the agent says and does.

***

### Prerequisites

* An AI agent. See Create your first AI Agent.
* The accounts of the tools you want to connect, for example a Google account for Google Calendar.
* A few lines about what the agent should do

***

### Key definitions

| Term                | Meaning                                                                             |
| ------------------- | ----------------------------------------------------------------------------------- |
| Prompt              | The instructions that tell the agent who it is, what it should do and how to do it. |
| Tool                | An app or action the agent can use, such as booking a slot in Google Calendar.      |
| Communication style | How the agent sounds: length, style, tone, language and formatting.                 |
| Setup required      | A tag on a tool that is added but still needs its account connected.                |

***

### How to Add Prompts & Tools

1. Open **Prompt & Tools** under Setup in the AI Agent sidebar.

![Click Prompt & Tools under Setup](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/Kt04nitJrFWd862dXOvP/images/prompts-and-tools-step-1.png)

2. Write your instructions in the Agent prompt box. Say who the agent is, what it should do and what it should know. Click on **Add Tools** to add a tool.

![Write your instructions in the Agent prompt box](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/W08QRlSxFgq3ym8TN9SH/images/prompts-and-tools-step-2.png)

3. Click **Add tool** to add a tool from the list. Search by name, or browse by category. Pick a tool and follow the steps to set it up.

![Click Add tool and search for a tool](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/Nn2hXGRdkBXeWbLITUTi/images/prompts-and-tools-step-3.png)

4. Click **Connected tools** to open the list of tools your agent can use. A green Active tag means the tool is ready. Use the settings icon to change a tool or the delete icon to remove it.

![Open Connected tools to see each tool and its status](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/sEYDR6vGJb5su8CLOllu/images/prompts-and-tools-step-4.png)

5. Click **Set up** on any tool that shows Setup required. Connect its account so the agent can use it.

![Click Set up on a tool that shows Setup required](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/SqyP28RUBfEdcbg7eTa8/images/prompts-and-tools-step-5.png)

6. Click **Rewrite with AI** if you want help to improve your prompt. This step is optional. Read the new text before you keep it.

![Click Rewrite with AI to improve your prompt](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/IuUu93riW3jWV5iO1gzW/images/prompts-and-tools-step-6.png)

7. Go to Communication style. It starts on Let agent decide. Choose **Configure it yourself** to set the style. Then edit the text for the answer length, answer style, tone, language and formatting.

![Choose Configure it yourself and edit the style text](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/gzDPVbUXGJUqPHsInnOg/images/prompts-and-tools-step-7.png)

8. Turn on Show sources when agent answers questions if you want the agent to list the pages or documents an answer came from.

![Turn on Show sources when agent answers questions](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/FexaJeOOlujGgbKZGs4v/images/prompts-and-tools-step-8.png)

9. Click **Update** to save. Click Update & Next to save and go to the next page.

![Click Update to save your changes](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/EQFo0ZMrSSAj7XDyUXNr/images/prompts-and-tools-step-9.png)

***

### Common errors

<details>

<summary>My agent does not use a tool</summary>

Check that the tool shows Active in Connected tools. If it shows Setup required, click Set up and connect the account. Also check that your prompt tells the agent when to use the tool.

</details>

<details>

<summary>I see "tool needs setup" next to Connected tools</summary>

At least one tool is added but not connected. Open Connected tools and click Set up on the tool with the Setup required tag.

</details>

<details>

<summary>The agent does not follow my style</summary>

Check that Communication style is set to Configure it yourself. If it stays on Let agent decide, the agent chooses its own style. Also make sure the tone in your prompt matches the style text.

</details>

<details>

<summary>Typing a slash does nothing</summary>

Type \`/\` inside the Agent prompt box. A list of tools opens. If it does not, click Add tool instead.

</details>

<details>

<summary>My changes are not live</summary>

Click Update after you edit. Changes you do not save are lost when you leave the page.

</details>

<details>

<summary>The agent gives long answers</summary>

In Communication style, choose Configure it yourself and write a short answer length, for example "Keep answers to two or three sentences".

</details>

***

### Support

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