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

# Character Interaction Graph Asset

[Overview](../overview) > Character Interaction Graph Asset

**Class:** `CharacterInteractionGraphAsset` | **Inherits from:** `InworldGraphAsset`

Specialized graph asset for character interaction workflows within the Inworld framework. Extends the base graph functionality with character-specific data and conversation prompts. This asset can be created through Unity's Create menu and used to define character-based conversations.

<img src="https://mintcdn.com/inworldai/GzK0EwIb2T2yQTle/Unity/runtime/runtime-reference/images/CharacterInteractionGraphAsset.png?fit=max&auto=format&n=GzK0EwIb2T2yQTle&q=85&s=7822a34c8928fda0eb8f1df655644258" alt="CharacterInteractionGraphAsset Unity Inspector" width="591" height="591" data-path="Unity/runtime/runtime-reference/images/CharacterInteractionGraphAsset.png" />

## Properties

* [Characters](#characters)
* [VoiceID](#voiceid)
* [Prompt](#prompt)
* [NeedClearHistory](#needclearhistory)

## Methods

* [LoadCharacterData](#loadcharacterdata)
* [SetFirstVoiceID](#setfirstvoiceid)
* [LoadGameData](#loadgamedata)
* [ClearHistory](#clearhistory)

## Reference

### Characters

Gets or sets the collection of character data associated with this interaction graph.
Contains the character definitions that will participate in the conversation flow.

#### Returns

**Type:** `List<CharacterData>`

***

### VoiceID

Gets or sets the voice identifier to use for speech synthesis in character interactions.
Specifies which voice profile should be used for generating character speech.

#### Returns

**Type:** `string`

***

### Prompt

Gets or sets the conversation prompt configuration for this character interaction.
Defines the conversation context, prompts, and behavioral settings for the interaction.

#### Returns

**Type:** `ConversationPrompt`

***

### NeedClearHistory

Gets a value indicating whether the graph needs to clear history.
Overrides the base implementation to check the prompt's clear history setting.

#### Returns

**Type:** `bool`

***

### LoadCharacterData

Loads character data into the conversation prompt and configures the player name.
Configures the conversation prompt with the first character's data and sets the player name.

***

### SetFirstVoiceID

Sets the first voice ID in TTS nodes (if there are multiple TTS nodes).
Uses the `voiceID` as the default one in the graph.

***

### LoadGameData

Loads game data for the character interaction graph.
Sets the first voice ID and loads character data into the conversation prompt.

#### Returns

**Type:** `bool` - True if data loading succeeded; otherwise, false.

***

### ClearHistory

Clears the conversation history for this character interaction graph.
Calls the prompt's clear history method.

***

## Serialized Fields

The following fields are configurable in the Unity Inspector:

* **characters** (`List<CharacterData>`) - Collection of character data for interaction
* **voiceID** (`string`) - Voice identifier for speech synthesis
* **prompt** (`ConversationPrompt`) - Conversation prompt configuration
