Function useConversation

useConversation(options?: UseConversationOptions): UseConversationReturn

Hook for managing AI assistant conversation state

This is a pure state management hook. For cloud integration, use the AIAssistant component which handles cloud-provider integration automatically, or provide a custom onSend handler.

Parameters

options: UseConversationOptions = {}

Returns UseConversationReturn

Example: Basic usage with custom handler

const { sendMessage } = useConversation({
  roomId: 'room-123',
  onSend: async (message) => {
    const response = await myCustomAI(message);
    return response;
  },
});

Example: External state (controlled mode)

const [messages, setMessages] = useState<AssistantMessage[]>([]);

const { sendMessage } = useConversation({
  externalMessages: messages,
  onMessagesChange: setMessages,
  onSend: async (message) => myAI(message),
});

Example: For cloud integration, use AIAssistant component

import { CloudProvider, AIAssistant } from '@hiyve/react-intelligence';

function App() {
  return (
    <CloudProvider generateCloudToken={tokenGenerator}>
      <AIAssistant
        roomId="room-123"
        userId="user@example.com"
      />
    </CloudProvider>
  );
}