> ## Documentation Index
> Fetch the complete documentation index at: https://cometchat-22654f5b-feature-react-native-sdk-quotedmessage-a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# AI Assistant Chat History
## Overview
The `AI Assistant Chat History` component is a pre-built user interface element designed to display the conversation history between users and an AI assistant within a chat application. It provides a structured and visually appealing way to present past interactions, making it easy for users to review previous messages and context.
***
## Usage
### Integration
`AIAssistantChatHistory`, as a Composite Component, offers flexible integration options, allowing it to be launched directly via button clicks or any user-triggered action.
The following code snippet exemplifies how you can seamlessly integrate the GroupMembers component into your application.
```xml theme={null}
```
If you're defining the Group members within the XML code, you'll need to extract them and set them on the Group object using the appropriate method.
```java theme={null}
User user = new User();
user.setUid("userId");
user.setName("User Name");
user.setRole("@agentic"); // User role must be @agentic to use AI Assistant features
binding.cometChatAiAssistantChatHistory.setUser(user);
```
```kotlin theme={null}
val user = User()
user.uid = "userId"
user.name = "User Name"
user.role = "@agentic" // User role must be @agentic to use AI Assistant features
binding.cometChatAiAssistantChatHistory.setUser(user)
```
***
### Actions
[Actions](/ui-kit/android/components-overview#actions) dictate how a component functions. They are divided into two types: Predefined and User-defined. You can override either type, allowing you to tailor the behavior of the component to fit your specific needs.
##### setOnItemClickListener
Function invoked when a chat history item is clicked, typically used to open an ai assistant chat screen.
```java YourActivity.java theme={null}
binding.cometchatAiAssistantChatHistory.setOnItemClickListener((view, position, message) -> {
});
```
```kotlin YourActivity.kt theme={null}
binding.cometchatAiAssistantChatHistory.setOnItemClickListener { view, position, message ->
}
```
***
##### setOnItemLongClick
Function executed when a user item is long-pressed, allowing additional actions like delete or block.
```java YourActivity.java theme={null}
binding.cometchatAiAssistantChatHistory.setOnItemLongClickListener((view, position, message) -> {
});
```
```kotlin YourActivity.kt theme={null}
binding.cometchatAiAssistantChatHistory.setOnItemLongClickListener { view, position, message ->
}
```
***
##### setOnNewChatClickListener
Function triggered when the new chat button is clicked, typically used to start a new conversation with the AI assistant.
```java YourActivity.java theme={null}
binding.cometchatAiAssistantChatHistory.setOnNewChatClickListener(() -> {
});
```
```kotlin YourActivity.kt theme={null}
binding.cometchatAiAssistantChatHistory.setOnNewChatClickListener {
}
```
***
##### setOnCloseClickListener
Function activated when the close button is clicked, usually to exit the chat history view.
```java YourActivity.java theme={null}
binding.cometchatAiAssistantChatHistory.setOnCloseClickListener(() -> {
});
```
```kotlin YourActivity.kt theme={null}
binding.cometchatAiAssistantChatHistory.setOnCloseClickListener {
}
```
## Customization
The `AIAssistantChatHistory` component offers a variety of customization options to tailor its appearance and functionality to better fit your application's needs. These customizations are categorized into three main areas: Style, Functionality, and Advanced.
### Style
Using Style you can customize the look and feel of the component in your app, These parameters typically control elements such as the color, size, shape, and fonts used within the component.
```xml themes.xml theme={null}
```
```java theme={null}
binding.cometchatAiAssistantChatHistory.setStyle(R.style.CustomAIAssistantChatHistoryStyle);
```
```kotlin theme={null}
binding.cometchatAiAssistantChatHistory.setStyle(R.style.CustomAIAssistantChatHistoryStyle);
```
***
To know more such attributes, visit the [attributes file](https://github.com/cometchat/cometchat-uikit-android/blob/v5/chatuikit/src/main/res/values/attr_cometchat_ai_assistant_chat_history.xml).
### Functionality
These are a set of small functional customizations that allow you to fine-tune the overall experience of the component. With these, you can toggle the visibility of UI elements.
Below is a list of customizations along with corresponding code snippets
| Methods | Description | Code |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------- |
| setUser | Sets the user whose chat histories with the ai assistant need to be fetched. This is a required property for the component to function properly. | `.setUser(user);` |
| setErrorStateVisibility | Used to toggle the visibility of the error state of the component | `.setErrorStateVisibility(View.GONE);` |
| setEmptyStateVisibility | Used to toggle the visibility of the empty state of the component | `.setEmptyStateVisibility(View.GONE);` |