# Function: showDialog() (/pixi-vn-ai/index/functions/showDialog)



\> **showDialog**(`request`, `character?`, `options?`): `Promise`\<`string`>

Defined in: [src/show.ts:66](https://github.com/DRincs-Productions/pixi-vn-ai/blob/f5205e28d51c043e8eeb27fcb2b61433f3751ac2/src/show.ts#L66)

Generate a dialogue from a developer request and set it as the current Pixi'VN narration
dialogue. This is the combination of `ai.text.generateDialog` and Pixi'VN's
`narration.dialogue`.

## Parameters [#parameters]

### request [#request]

`string`

Natural language description of the dialogue to generate.

### character? [#character]

[`CharacterItem`](/pixi-vn-ai/index/type-aliases/CharacterItem)

The character speaking, if any. Set as the dialogue's character, and also
used as [DialogGenerateOptions.speaker](/pixi-vn-ai/index/interfaces/DialogGenerateOptions#speaker) (so the model knows who it's writing for) when
`options.speaker` isn't already set.

### options? [#options]

[`DialogGenerateOptions`](/pixi-vn-ai/index/interfaces/DialogGenerateOptions)

Options controlling which context gets included in the prompt.

## Returns [#returns]

`Promise`\<`string`>

The generated dialogue text.