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

# Connecter Flowise à CometAPI

> Utilisez ce guide pour connecter Flowise à CometAPI en définissant l’URL de base, la clé API ainsi que les options de modèle ou de fournisseur.

FlowiseAI est une plateforme low-code permettant de créer visuellement des applications LLM. Utilisez le nœud natif **ChatCometAPI** pour connecter CometAPI à des chatflows, des systèmes de questions-réponses et des workflows RAG qui appellent des modèles de chat textuel.

<Note>
  Ce guide couvre les workflows de chat textuel et de RAG. Il ne couvre pas les workflows de génération d’images.
</Note>

## Prérequis

* Un compte CometAPI avec une clé API active - [obtenez la vôtre ici](https://www.cometapi.com/console/token)
* Un compte FlowiseAI ou une instance Flowise auto-hébergée - [connectez-vous à Flowise Cloud](https://cloud.flowiseai.com/chatflows)
* Un model ID de modèle textuel actuel depuis la [page des modèles CometAPI](/fr/overview/models)
* Pour le RAG, une source de documents ainsi qu’un fournisseur d’Embeddings et un vector store compatibles avec Flowise

## Configurer ChatCometAPI

<Steps>
  <Step title="Obtenir votre clé API CometAPI">
    Connectez-vous à la [console CometAPI](https://www.cometapi.com/console/token). Cliquez sur **Add API Key** et copiez votre clé API CometAPI.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Tableau de bord CometAPI affichant le bouton Add API Key" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="Détails de la clé API CometAPI avec l’URL de base" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Ajouter le nœud ChatCometAPI">
    1. Dans le canevas de votre chatflow FlowiseAI, cliquez sur **Add New**.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_361945.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=f36fc7cc6d541af1acd95f6b8aea9b04" alt="Canevas FlowiseAI avec le bouton Add New" width="1874" height="960" data-path="images/integrations/810968_361945.png" />
    </Frame>

    2. Recherchez **cometapi** et sélectionnez le nœud **ChatCometAPI**.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_361946.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=0da9222351e5378eeeb928b1acf1e959" alt="Recherche de nœud affichant le résultat ChatCometAPI" width="1880" height="910" data-path="images/integrations/810968_361946.png" />
    </Frame>

    3. Faites-le glisser sur le canevas.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_361947.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=c727ab9ff734355a0f2d5de4ff479c97" alt="Nœud ChatCometAPI placé sur le canevas" width="1810" height="950" data-path="images/integrations/810968_361947.png" />
    </Frame>
  </Step>

  <Step title="Créer l’identifiant CometAPI">
    Dans le nœud ChatCometAPI, ouvrez **Connect Credential**, sélectionnez **Create New**, collez votre clé API CometAPI, puis enregistrez l’identifiant.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_361948.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=b64309fa10d20704751e433c3316cf82" alt="Boîte de dialogue d’identifiant avec la clé API saisie" width="1820" height="900" data-path="images/integrations/810968_361948.png" />
    </Frame>
  </Step>

  <Step title="Définir le chemin de base CometAPI">
    Développez **Additional Parameters** dans le nœud ChatCometAPI.

    Si votre version de Flowise affiche un champ **Base Path**, définissez-le sur :

    ```text theme={null}
    https://api.cometapi.com/v1/
    ```

    Si elle expose plutôt **Base Options**, ajoutez une entrée `basePath` :

    ```json theme={null}
    {
      "basePath": "https://api.cometapi.com/v1/"
    }
    ```

    Définissez **Model Name** sur le model ID exact du modèle textuel que vous souhaitez appeler, par exemple `your-model-id`, et ajustez **Temperature** uniquement si votre workflow nécessite plus ou moins de variation.
  </Step>
</Steps>

## Créer un chatflow basique

<Steps>
  <Step title="Ajouter un Prompt Template">
    Ajoutez un nœud **Prompt Template** et définissez le prompt que votre chatflow enverra au modèle.

    ```text theme={null}
    Question: {question}
    Answer clearly and concisely.
    ```

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_361949.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=201c0e040b56a7a5338ba34b5761cac1" alt="Nœud Prompt Template avec le modèle d’exemple" width="1238" height="850" data-path="images/integrations/810968_361949.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_361950.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=9a872c659549ba024457a015a5c75064" alt="Nœud Prompt Template placé sur le canvas" width="511" height="805" data-path="images/integrations/810968_361950.png" />
    </Frame>
  </Step>

  <Step title="Ajouter une LLM Chain">
    Ajoutez un nœud **LLM Chain**. Connectez le nœud **ChatCometAPI** à l’entrée **Language Model** de la chaîne, puis connectez le nœud **Prompt Template** à l’entrée **Prompt** de la chaîne.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_361951.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=a44d838bb2fc70911e0407b1ea2ed7f2" alt="Nœud LLM Chain avec Language Model et Prompt connectés" width="514" height="724" data-path="images/integrations/810968_361951.png" />
    </Frame>
  </Step>

  <Step title="Enregistrer et tester le flow">
    Enregistrez le chatflow, ouvrez l’aperçu du chat, puis envoyez une courte question de test. Une configuration saine renvoie une réponse textuelle normale du modèle CometAPI sélectionné.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_361954.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=73647ee6f0995ed8c36a9fd1a2e6fd97" alt="Chatflow complet avec les trois nœuds connectés" width="1466" height="789" data-path="images/integrations/810968_361954.png" />
    </Frame>
  </Step>
</Steps>

## Changer de model ID

Pour changer de modèle, conservez le même identifiant CometAPI et le même chemin de base, puis modifiez uniquement le champ de model ID de ChatCometAPI.

Utilisez les model IDs exacts de la [page des modèles CometAPI](/fr/overview/models). Évitez de copier les noms d’affichage, les noms de fournisseurs ou des espaces supplémentaires.

| Cas d’usage                        | Valeur du model ID        |
| ---------------------------------- | ------------------------- |
| Famille de modèles de chat général | `your-chat-model-id`      |
| Famille de modèles de raisonnement | `your-reasoning-model-id` |
| Famille de modèles de code         | `your-coding-model-id`    |

Après avoir modifié le model ID, enregistrez le chatflow et exécutez un court prompt de test. Si vous maintenez plusieurs flows de production, dupliquez d’abord le chatflow et donnez à chaque copie un nom qui reflète la famille de modèles.

## Configurer la génération augmentée par récupération

Le RAG de Flowise comporte deux parties : d’abord préparer et insérer les documents dans les **Document Stores**, puis connecter le retriever préparé à un chatflow. ChatCometAPI est le modèle de chat qui rédige la réponse finale ; le Document Store a toujours besoin d’un fournisseur d’Embeddings pris en charge par Flowise et d’un vector store.

<Steps>
  <Step title="Créer et traiter un Document Store">
    Dans Flowise, ouvrez **Document Stores** et créez un nouveau store. Ajoutez un chargeur de documents, comme **File Loader**, **PDF Loader**, **Web Scraper**, ou un autre chargeur correspondant à votre source. Ajoutez un séparateur de texte lorsque le document est suffisamment long pour nécessiter un découpage en chunks, puis cliquez sur **Process** pour prévisualiser les chunks générés.
  </Step>

  <Step title="Configurer les Embeddings et le stockage vectoriel">
    Cliquez sur **Upsert** ou **Upsert All Chunks**. Sélectionnez :

    * **Embeddings** : un nœud d’Embeddings Flowise compatible avec vos données et votre vector store.
    * **Vector Store** : la base de données vectorielle dans laquelle Flowise doit stocker les embeddings des documents.
    * **Record Manager** : facultatif. Utilisez-le si vous souhaitez que les insertions répétées évitent les enregistrements en double.

    Gardez la dimension du modèle d’embedding alignée avec la dimension de l’index du vector store. Une fois l’insertion terminée, utilisez le test de requête de récupération du Document Store pour confirmer que des chunks pertinents sont renvoyés avant de créer le chatflow.
  </Step>

  <Step title="Créer le chatflow de récupération">
    Dans un chatflow, ajoutez un nœud **Document Store (Vector)** ou **Document Store Retriever** et sélectionnez le Document Store traité. Définissez **Top K** sur le nombre de chunks que vous voulez que Flowise récupère pour chaque question.
  </Step>

  <Step title="Connecter Conversational Retrieval QA Chain">
    Ajoutez **Conversational Retrieval QA Chain** et connectez :

    * l’entrée **Language Model** depuis **ChatCometAPI**.
    * l’entrée **Vector Store Retriever** depuis le retriever du Document Store.
    * **Memory** uniquement si votre chatflow a besoin de l’historique de conversation.

    Activez **Return Source Documents** lorsque vous souhaitez que la réponse inclue des citations ou des chunks source récupérés. Enregistrez le flux et posez une question dont la réponse existe uniquement dans le document téléversé.
  </Step>
</Steps>

## Dépannage

<AccordionGroup>
  <Accordion title="Le nœud ChatCometAPI est manquant">
    Vérifiez que votre version de Flowise inclut l’intégration du modèle de chat **ChatCometAPI**. Dans les déploiements Flowise plus anciens ou personnalisés, mettez à jour Flowise ou vérifiez si l’intégration a été désactivée par l’administrateur.
  </Accordion>

  <Accordion title="Les requêtes échouent parce que le chemin de base est incorrect">
    Définissez le chemin de base CometAPI sur `https://api.cometapi.com/v1/`. Dans certaines versions de Flowise, il s’agit d’un champ **Base Path**. Dans d’autres, ajoutez `basePath` dans **Base Options**.

    N’utilisez pas `https://api.cometapi.com` pour le chatflow ChatCometAPI, car le nœud de chat appelle des routes `/chat/completions` compatibles OpenAI sous `/v1`.
  </Accordion>

  <Accordion title="La clé API ou l’identifiant échoue">
    Recopiez la clé depuis la [console CometAPI](https://www.cometapi.com/console/token), créez un nouvel identifiant Flowise et assurez-vous que le chatflow utilise cet identifiant. Si la même clé fonctionne dans des appels API directs mais échoue dans Flowise, vérifiez que Flowise n’utilise pas encore un ancien identifiant attaché au nœud.
  </Accordion>

  <Accordion title="Le model ID échoue">
    Remplacez la valeur du model ID dans le nœud ChatCometAPI par un model ID de modèle texte actuel exact depuis la [page des modèles CometAPI](/fr/overview/models). La valeur ne doit pas inclure de guillemets, de préfixe de fournisseur, de libellé d’affichage ou d’espaces de fin.
  </Accordion>

  <Accordion title="Le workflow essaie de générer des images">
    ChatCometAPI est un nœud de modèle de chat pour les workflows textuels. Utilisez-le pour le chat, les chaînes, les agents et la génération de réponses RAG. N’utilisez pas cette configuration Flowise pour les nœuds de génération d’images ou les workflows uniquement dédiés aux images.
  </Accordion>

  <Accordion title="RAG ne renvoie aucune source ou des réponses faibles">
    Testez d’abord la requête de récupération du Document Store avant de tester le chatflow complet. Si la récupération est faible, ajustez le text splitter, la taille des chunks, le chevauchement des chunks, les filtres de métadonnées et **Top K**. Si les citations sont absentes, activez **Return Source Documents** sur **Conversational Retrieval QA Chain**.
  </Accordion>

  <Accordion title="La configuration de l’upsert ou du vector store échoue">
    Vérifiez que le fournisseur d’embeddings, le vector store et les dimensions du vecteur correspondent. Les vector stores de Flowise Cloud nécessitent souvent leur propre URL de service accessible et leurs identifiants ; une URL de vector store uniquement locale telle que `localhost` ne sera pas accessible depuis Flowise Cloud. Record Manager est facultatif, mais si vous l’activez, configurez sa connexion à la base de données séparément.
  </Accordion>

  <Accordion title="La requête expire ou est limitée par le débit">
    Réduisez **Top K** pour la récupération, diminuez la taille du prompt, utilisez des chunks plus petits ou choisissez un model ID plus rapide pour le nœud ChatCometAPI. En cas de rate limits, attendez puis réessayez avec une concurrence plus faible, puis vérifiez l’utilisation du compte et les limites dans la console CometAPI.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/flowiseai#howto",
        "name": "Connecter Flowise à CometAPI",
        "description": "Utilisez ce guide pour connecter Flowise à CometAPI en définissant l’URL de base, la clé API et les options de modèle ou de fournisseur.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/flowiseai#step-1",
            "position": 1,
            "name": "Obtenez votre clé API CometAPI",
            "text": "Créez ou ouvrez votre compte CometAPI, puis copiez une clé API active depuis le tableau de bord."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/flowiseai#step-2",
            "position": 2,
            "name": "Ajoutez le nœud ChatCometAPI",
            "text": "Effectuez l’étape Add the ChatCometAPI node dans le guide Connecter Flowise à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/flowiseai#step-3",
            "position": 3,
            "name": "Créez l’identifiant CometAPI",
            "text": "Effectuez l’étape Create the CometAPI credential dans le guide Connecter Flowise à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/flowiseai#step-4",
            "position": 4,
            "name": "Définissez le chemin de base CometAPI",
            "text": "Effectuez l’étape Set the CometAPI base path dans le guide Connecter Flowise à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/flowiseai#step-5",
            "position": 5,
            "name": "Ajoutez un Prompt Template",
            "text": "Effectuez l’étape Add a Prompt Template dans le guide Connecter Flowise à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/flowiseai#step-6",
            "position": 6,
            "name": "Ajoutez une LLM Chain",
            "text": "Effectuez l’étape Add an LLM Chain dans le guide Connecter Flowise à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/flowiseai#step-7",
            "position": 7,
            "name": "Enregistrez et testez le flux",
            "text": "Effectuez l’étape Save and test the flow dans le guide Connecter Flowise à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/flowiseai#step-8",
            "position": 8,
            "name": "Créez et traitez un Document Store",
            "text": "Effectuez l’étape Create and process a Document Store dans le guide Connecter Flowise à CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentation CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Intégrations",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Connecter Flowise à CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/flowiseai"
          }
        ]
      }
    ]
    }
    `}
</script>
