> 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/manage-private-notes.md).

# Manage Private Notes

The Manage private notes tool lets your AI agent write, edit or delete internal notes that only your team can see. You add it on the Prompt & Tools page, choose which actions the agent may use, and tell the agent when to use it.

***

### Prerequisites

* An AI agent. See Create your first AI Agent.
* Edit access to AI Agents.

***

### Key definitions

| Term               | Meaning                                                               |
| ------------------ | --------------------------------------------------------------------- |
| Tool               | Something your agent can use to take an action.                       |
| Action             | One thing a tool can do. You turn each action on or off with Allowed. |
| Usage instructions | Your words that tell the agent when to use the tool and what to do.   |

***

### What the Manage private notes tool can do

| Action      | What it does                           |
| ----------- | -------------------------------------- |
| Add note    | Writes a new private note on the chat. |
| Update note | Edits a note that was already written. |
| Delete note | Deletes a private note.                |

***

### Steps

1. Open **Prompt & Tools** under Setup in the AI Agent sidebar. Click **Add tool**. In the Add tools window, find **Manage private notes**. You can search for it, or look under Internal tools. Click it.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FYSA3pk6xEpSjoOyb3RYK%2Fimage.png?alt=media&amp;token=8a7dbd04-4ffc-4667-8baa-d6b82745d74a" alt=""><figcaption></figcaption></figure>

2. Turn on the actions you want the agent to use. A counter shows how many are allowed. The agent uses only the actions that are allowed. Under "How should the agent use Manage private notes?", write when the agent should use the tool and what it should do. This is required.

![Turn on actions and write the usage instructions for Manage private notes](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/jCIMZdJ6L1250K8h5jZ8/images/manage-private-notes-step-2.png)

3. Click **Save changes**. The tool now shows under Connected tools with an Active label. Click **Done** to close the window, then click **Update** to save the page.

***

### Example usage instructions

> Use Manage private notes to leave internal notes that only the team can see. The customer can never see these notes.
>
> Write note: After you have qualified the customer, add a note with their need, budget and timeline. Also add a note when the customer asks for a human, so the team knows what was discussed. Keep each note short and factual.
>
> Edit note: When the customer gives new or corrected information, edit the existing note instead of writing a new one. Change only what is new.
>
> Delete note: Only when a note is wrong and cannot be fixed by editing it. Never delete a note just because the chat has ended.
>
> Rules: Never tell the customer that you are writing notes, and never share what a note says. Do not put passwords, card numbers or other sensitive details in a note. If the tool gives an error, do not tell the customer. Carry on helping them. Never assume a note was saved until the tool confirms it.

Write your own in the same way: say when to use the tool, then what to do.

***

### Change or remove the tool

Under Connected tools, click the gear icon to open the tool's settings again. Click the delete icon to remove it. You are asked to confirm. Deleting removes the tool and its usage instructions from the agent.

***

### Common errors

<details>

<summary>The agent does not use the tool</summary>

Check that the tool shows Active under Connected tools. Check that the action you need is allowed. Make your usage instructions clearer about when to use the tool.

</details>

<details>

<summary>I cannot save the tool</summary>

The usage instructions are required. Fill them in.

</details>

<details>

<summary>What happens if I delete the tool?</summary>

The agent can no longer use it, and its usage instructions are removed. Text about the tool in your prompt stays, so remove it too.

</details>

***

### Support

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