> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt

# toAISdkV4Messages()

Convertit des messages de différents formats d’entrée au format de message d’interface utilisateur AI SDK V4. Cette fonction accepte plusieurs formats de message, notamment des chaînes, des messages AI SDK V4/V5 et des messages Mastra DB, puis les normalise au format `UIMessage` d’AI SDK V4, adapté aux composants d’interface utilisateur d’AI SDK tels que `useChat()`.

## Exemple d’utilisation

```typescript
import { toAISdkV4Messages } from '@mastra/ai-sdk'
import { useChat } from 'ai/react' // AI SDK V4

// Stored messages from your database, memory or API
const storedMessages = [
  { id: '1', role: 'user', parts: [{ type: 'text', text: 'Hello' }] },
  { id: '2', role: 'assistant', parts: [{ type: 'text', text: 'Hi there!' }] },
]

export default function Chat() {
  const { messages } = useChat({
    initialMessages: toAISdkV4Messages(storedMessages),
  })

  return (
    <div>
      {messages.map(message => (
        <div key={message.id}>
          {message.role}: {message.content}
        </div>
      ))}
    </div>
  )
}
```

## Paramètres

**messages** (`MessageListInput`): Messages à convertir. Il peut s’agir d’une chaîne, d’un tableau de chaînes, d’un seul objet de message ou d’un tableau d’objets de message dans n’importe quel format pris en charge.

## Valeur renvoyée

Renvoie un tableau d’objets `UIMessage` AI SDK V4 possédant la structure suivante :

**id** (`string`): Identifiant unique du message.

**role** (`'user' | 'assistant' | 'system'`): Rôle de l’émetteur du message.

**content** (`string`): Contenu textuel du message.

**parts** (`UIMessagePart[]`): Tableau de parties d’interface utilisateur comprenant du texte, des invocations de Tools, des fichiers, du raisonnement, des sources et des marqueurs d’étape.

**createdAt** (`Date`): Horodatage de création du message.

**toolInvocations** (`ToolInvocation[]`): Tableau des invocations de Tools pour les messages de l’assistant.

**experimental\_attachments** (`Attachment[]`): Fichiers joints au message.

**metadata** (`Record<string, unknown>`): Métadonnées personnalisées associées au message.

## Exemples

### Convertir des messages texte

```typescript
import { toAISdkV4Messages } from '@mastra/ai-sdk'

const messages = toAISdkV4Messages(['Hello', 'How can I help you today?'])
// Returns array of UIMessage objects with user role and content string
```

### Charger des messages avec le client Mastra

```typescript
import { MastraClient } from '@mastra/client-js'
import { toAISdkV4Messages } from '@mastra/ai-sdk'

const client = new MastraClient()

const { messages } = await client.listThreadMessages('thread-id', { agentId: 'myAgent' })
const uiMessages = toAISdkV4Messages(messages)
```