> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telzino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Example Prompts

> Ready-made prompts for common AI agent changes, matched to what the Telzino API supports

Paste one of these after the [starter prompt](https://docs.telzino.com/configure-with-ai/connecting-tools.md#starter-prompt), which sets the safety rules. Replace the parts in brackets. Each prompt lists the API calls it relies on, so you can check what the assistant does.

## Copy an agent for a new location

```text theme={null}
Copy the agent "[Acme Dental - Main]" for our new location.
Name the copy "[Acme Dental - Riverside]". In the copy, change the address,
opening hours and phone numbers in the instructions and greeting to:
[new details]. Keep everything else the same.
Show me the full create request before you send it.
```

There's no clone endpoint, so the assistant reads the agent and creates a new one with the same settings:

* [Get Agent](https://docs.telzino.com/api-reference/agents/get.md) on the original, then [Create Agent](https://docs.telzino.com/api-reference/agents/create.md) with `name`, `organizationId` and the copied settings, renamed from snake\_case to camelCase.
* It must leave out read-only values such as `id` and the `google_place_*` details. Set `googlePlaceId` to the new location's listing, or leave it out. See [Google Business](https://docs.telzino.com/functions/google-business.md).
* The copy has no phone number or SIP registration yet. Connect it the same way as any new agent, for example with [SIP Registration](https://docs.telzino.com/api-reference/agents/sip-registration.md).

> [!TIP]
>
> You can also copy an agent with **Clone** in the Connect App's agents list. See [Edit Agent](https://docs.telzino.com/admin-guide/connect/edit-agent.md).

## Add a transfer rule

```text theme={null}
On the agent "[Acme Dental - Main]", add a transfer rule: if the caller asks
about billing, transfer them to [+15555550100]. Keep the existing rules.
Show me the old and new transfer rules before you save.
```

Transfer rules are plain text, so the assistant adds a sentence to the existing rules:

* [Get Agent](https://docs.telzino.com/api-reference/agents/get.md) to read `transfer_rules`, then [Update Agent](https://docs.telzino.com/api-reference/agents/update.md) with the full new text in `transferRules`. If transfers are off, it also sets `transferEnabled: true`.
* For a warm transfer, where the AI agent introduces the caller first, it uses `warmTransferRules` and `warmTransferEnabled` instead. See [Call Transfer](https://docs.telzino.com/functions/call-transfer.md) and [Warm Transfer](https://docs.telzino.com/functions/warm-transfer.md).

## Send call summaries to your team

```text theme={null}
On the agent "[Acme Dental - Main]", send the call summary after every call to
[frontdesk@example.com] as well as the current recipients. If call recording
is on, include the recording link in the summary.
```

* [Get Agent](https://docs.telzino.com/api-reference/agents/get.md) to read `email` (a comma-separated string), then [Update Agent](https://docs.telzino.com/api-reference/agents/update.md) with `email` as an array of all the addresses.
* For the recording link, `sendRecordingLinkWithSummary: true`. This needs recording to be on (`enableRecording`), otherwise the API returns `400`.

## Text callers a confirmation

```text theme={null}
On the agent "[Acme Dental - Main]", add the Send SMS function so that when a
caller books an appointment, the agent texts them the date, time and address.
Use [Twilio / hosted SMS / NetSapiens]. For Twilio or hosted SMS, send from [+15555550100].
Keep all the agent's other functions. Show me the new extensions.tools entry
and the full list of tools before you save.
```

* [Get Agent](https://docs.telzino.com/api-reference/agents/get.md) to read `extensions`. The assistant adds one entry to `extensions.tools`, using the exact format in [SMS Functions in extensions.tools](https://docs.telzino.com/api-reference/agents/sms-functions.md), and sends the whole `extensions` object back with [Update Agent](https://docs.telzino.com/api-reference/agents/update.md).
* With Twilio, the entry needs a From number, and the organization's Twilio connection must already be set up. With hosted SMS, the number must be one of the organization's hosted SMS numbers.
* The same function can text your team instead of the caller, for example "text +15555550100 when a caller reports an emergency". Write that in the instructions.

## Review calls and suggest instruction changes

```text theme={null}
Read the last [50] calls for the agent "[Acme Dental - Main]". Find calls where
the agent couldn't answer, transferred unnecessarily, or the caller was unhappy.
Summarize the patterns with a few short examples, then propose specific changes
to the agent's instructions. Don't change anything until I approve.
Don't include caller phone numbers or names in your summary.
```

* [List Call Logs](https://docs.telzino.com/api-reference/call-logs.md) for summaries and transcripts, paging with `page` and `limit`.
* [Get Agent](https://docs.telzino.com/api-reference/agents/get.md) to read `system_prompt`. After you approve, [Update Agent](https://docs.telzino.com/api-reference/agents/update.md) with the new `systemPrompt`.
* If the new instructions don't work as well, [revert](https://docs.telzino.com/api-reference/agents/revert.md) to the previous version.

For writing good instructions, see [Instructions](https://docs.telzino.com/agents/instructions.md) and [Best Practices](https://docs.telzino.com/examples/best-practices.md).

## Explain what an agent does

```text theme={null}
Explain in plain language what the agent "[Acme Dental - Main]" is set up to do:
its greeting, language, voice, transfer rules, functions and integrations.
Don't change anything.
```

This uses only [Get Agent](https://docs.telzino.com/api-reference/agents/get.md), so it's a safe first test of your setup.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.