Créer un message de l'Assistant
L’endpoint assistant message v2 est compatible avec AI SDK v5+. Si vous utilisez l’AI SDK v4, utilisez plutôt l’endpoint assistant message v1.
Le hook useChat de l’AI SDK de Vercel est la méthode recommandée pour intégrer l’API Assistant dans votre application.
Installer l'AI SDK
npm i ai@^6 @ai-sdk/reactUtiliser le hook
import { useState } from "react";
import { useChat } from "@ai-sdk/react";
import { DefaultChatTransport } from "ai";
function MyComponent({ domain }) {
const [input, setInput] = useState("");
const { messages, sendMessage } = useChat({
transport: new DefaultChatTransport({
api: `https://api.mintlify.com/discovery/v2/assistant/${domain}/message`,
headers: {
Authorization: `Bearer ${process.env.PUBLIC_MINTLIFY_ASSISTANT_KEY}`,
},
body: {
fp: "anonymous",
retrievalPageSize: 5,
context: [
{
type: "code",
value: 'const example = "code snippet";',
elementId: "code-block-1",
},
],
},
}),
});
return (
<div>
{messages.map((message) => (
<div key={message.id}>
{message.role === "user" ? "User: " : "Assistant: "}
{message.parts
.filter((part) => part.type === "text")
.map((part) => part.text)
.join("")}
</div>
))}
<form
onSubmit={(e) => {
e.preventDefault();
if (input.trim()) {
sendMessage({ text: input });
setInput("");
}
}}
>
<input value={input} onChange={(e) => setInput(e.target.value)} />
<button type="submit">Send</button>
</form>
</div>
);
}Configuration requise :
transport- UtilisezDefaultChatTransportpour configurer la connexion à l’API.body.fp- Identifiant d’empreinte (utilisez'anonymous'ou un identifiant utilisateur unique).body.retrievalPageSize- Nombre de résultats de recherche à utiliser (recommandé : 5).
Configuration optionnelle :
body.context- Tableau d’informations contextuelles à fournir à l’Assistant. Chaque objet de contexte contient :type- Soit'code'soit'textSelection'.value- Le morceau de code ou le contenu textuel sélectionné.path(optionnel) - Chemin vers le fichier source ou la page.elementId(optionnel) - Identifiant de l’élément d’interface contenant le contexte.
body.currentPath- Chemin de la page que l’utilisateur est en train de consulter. Lorsqu’il est fourni, l’Assistant utilise ce contexte pour fournir des réponses plus pertinentes. Longueur maximale : 200 caractères.
Voir useChat et Transport dans la documentation de l’AI SDK pour plus de détails.
L’API Assistant est soumise aux limites suivantes :
- 10 000 requêtes par organisation Mintlify et par heure
- 10 000 requêtes par IP et par jour
Was this page helpful?Suggest editsRaise issue