> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# ai

> Add an AI verb to start an AI-powered conversation.

Add an `ai` verb to the main section. Starts an AI-powered conversation on the call.

This is a dynamic verb method that accepts a generic config object. The config is
passed directly as the AI verb's configuration payload in the SWML document.

## **Parameters**

**`config`** `Record<string, unknown> | undefined`

Optional configuration object for the AI verb. The structure matches the
[SWML AI verb specification](/docs/swml/reference/calling/ai) and may include keys such as
`prompt`, `post_prompt`, `post_prompt_url`, `swaig`, `hints`, `languages`, `params`,
and `global_data`.

> **Note**
>
> The `prompt` key accepts either a text string or a POM (Prompt Object Model)
> structure — these are mutually exclusive. Do not set both `prompt.text` and
> `prompt.pom` in the same config.

---

## **Returns**

`this` -- The builder instance for method chaining.

## **Example**

```typescript {5}
import { SwmlBuilder } from '@signalwire/sdk';

const builder = new SwmlBuilder();
builder.answer();
builder.ai({
  prompt: { text: 'You are a helpful assistant.' },
  post_prompt_url: 'https://example.com/summary',
});

console.log(builder.render());
```

> Add an AI verb to start an AI-powered conversation.