# tEmbeddingAI

Disponible dans...

* Cloud Data Fabric
* Data Fabric
* Qlik Talend Cloud Enterprise Edition
* Real-Time Big Data Platform

Ce composant tire parti de modèles d'intégration (embedding) pour traiter efficacement des données avec l'IA.

Pour une présentation rapide de l'utilisation de ce composant dans votre Job, visionnez la vidéo suivante :

## Propriétés du tEmbeddingAI Standard

Ces propriétés sont utilisées pour configurer le tEmbeddingAI s'exécutant dans le framework de Jobs Standard.

Le composant tEmbeddingAI Standard appartient à la famille IA.

## Basic settings

| Propriétés | Description |
| --- | --- |
| Schema et Edit schema | Un schéma est une description de lignes et définit les champs à traiter et à passer au composant suivant.<br><br><ul> <li> <p> <span>Built-in</span>&nbsp;: le schéma est créé et conservé localement pour ce composant seulement.</p> </li> <li> <p> <span>Repository</span>&nbsp;: le schéma existe déjà et est stocké dans le Repository. Ainsi, il peut être réutilisé dans des Jobs et projets.</p> </li> </ul><br><br>Créez le schéma en cliquant sur le bouton Edit Schema. Si vous effectuez des modifications, le schéma passe automatiquement en type built-in.<br><br><ul> <li> <p> <span>View schema</span>&nbsp;: sélectionnez cette option afin de voir uniquement le schéma.</p> </li> <li> <p> <span>Change to built-in property</span>&nbsp;: sélectionnez cette option pour passer le schéma en mode <span>Built-In</span> et effectuer des modifications locales.</p> </li> <li> <p> <span>Update repository connection</span>&nbsp;: sélectionnez cette option afin de modifier le schéma stocké dans le référentiel et décider de propager ou non les modifications à tous les Jobs.</p> <p>Si vous souhaitez propager les modifications uniquement au Job courant, cliquez sur <span>No</span> et sélectionnez à nouveau la métadonnée du schéma dans la fenêtre <span>Repository Content</span>.</p> </li> </ul> |
| Guess schema | Cliquez sur ce bouton pour récupérer le schéma en fonction de vos paramètres. |
| Platform | Sélectionnez la plateforme utilisée pour intégrer vos données d'entrée.<br><br><ul> <li>Si vous utilisez <span>Amazon Bedrock</span>, seuls les modèles <a href="https://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/titan-embedding-models.html" target="_blank">Amazon Titan Text Embedding v1 et v2</a> sont supportés. La méthode d'authentification <a href="https://docs.aws.amazon.com/fr_fr/sdk-for-java/latest/developer-guide/credentials-chain.html" target="_blank">Chaîne de fournisseurs d'informations d'identification par défaut</a> est utilisée, ce qui signifie que l'accès au Service AWS peut être configuré dans une chaîne.</li> <li>Si vous utilisez <span>Google Vertex AI</span>, la méthode d'authentification <a href="https://cloud.google.com/docs/authentication/provide-credentials-adc?hl=fr" target="_blank">Identifiants par défaut de l'application&nbsp;</a> est utilisée, ce qui signifie qu'aucun paramètre supplémentaire ne doit être configuré, car les identifiants sont automatiquement récupérés en fonction de l'environnement de l'application.</li> <li>Si vous utilisez <span>Hugging Face</span>, l'exception <span>"Model thenlper/gte-large is currently loading"</span> du seveur peut survenir occasionnellement. Elle est due au fait que le modèle utilisé est un <a href="https://huggingface.co/docs/api-inference/supported-models" target="_blank">cold model</a> (en anglais). L'erreur ne s'affiche plus lors de la tentative suivante.</li> <li>Si vous utilisez <span>ONNX</span>, des erreurs de dépassement de mémoire peuvent survenir, car les modèles ONNX sont locaux et consomment de la mémoire. Il est recommandé de configurer les paramètres de la JVM à 2&nbsp;Go minimum dans <a href="https://help.qlik.com/talend/fr-FR/remote-engine-user-guide-windows/cloud/job-run-profile" target="_blank">les profils d'exécution de Jobs</a>.</li> </ul> |
| Paramètres Ali Bailian (DashScope) | <ul> <li> <span>Model name</span>&nbsp;: cliquez sur le bouton <span>[...]</span> près du champ pour sélectionner le modèle intégré.</li> <li> <span>Token/API Key</span>&nbsp;: cliquez sur le bouton <span>[...]</span> près du champ pour saisir le jeton d'accès à votre plateforme Dashscope.</li> </ul><br><br>Vous pouvez renseigner l'URL du serveur d'API dans le paramètre Base URL de la vue Advanced settings. |
| Paramètres Amazon Bedrock | <ul> <li> <span>Model name</span>&nbsp;: cliquez sur le bouton <span>[...]</span> près du champ pour sélectionner le modèle intégré.</li> <li> <span>Region</span>&nbsp;: cliquez sur le bouton <span>[...]</span> près du champ pour sélectionner l'emplacement Amazon multi-région à utiliser. </li> </ul> |
| Paramètres Azure OpenAI | <ul> <li> <span>Model name</span>&nbsp;: cliquez sur le bouton <span>[...]</span> près du champ pour sélectionner le modèle intégré.</li> <li> <span>Token/API Key</span>&nbsp;: cliquez sur le bouton <span>[...]</span> près du champ pour saisir le jeton d'accès à votre plateforme Azure OpenAI.</li> <li> <span>Azure endpoint</span>&nbsp;: saisissez le point de terminaison via lequel accéder à votre API de service Azure OpenAI. </li> </ul> |
| Paramètres Cohere | <ul> <li> <span>Model name</span>&nbsp;: cliquez sur le bouton <span>[...]</span> près du champ pour sélectionner le modèle intégré.</li> <li> <span>Token/API Key</span>&nbsp;: cliquez sur le bouton <span>[...]</span> près du champ pour saisir le jeton d'accès à votre plateforme Cohere.</li> </ul><br><br>Vous pouvez renseigner l'URL du serveur d'API dans le paramètre Base URL de la vue Advanced settings. |
| Paramètres Google Vertex AI | <ul> <li> <span>Model name</span>&nbsp;: cliquez sur le bouton <span>[...]</span> près du champ pour sélectionner le modèle intégré.</li> <li> <span>Location</span>&nbsp;: saisissez l'emplacement Google Cloud multi-région à utiliser. Consultez <a href="https://cloud.google.com/vertex-ai/docs/general/locations?hl=fr" target="_blank">Emplacements Vertex AI</a> pour plus d'informations.</li> <li> <span>Google endpoint</span>&nbsp;: saisissez le point de terminaison régional correspondant à votre emplacement. Consultez <a href="https://cloud.google.com/vertex-ai/docs/general/locations?hl=fr" target="_blank">Emplacements Vertex AI</a> pour plus d'informations.</li> <li> <span>Google project ID</span>&nbsp;: saisissez l'ID de votre projet Google Cloud. Consultez <a href="https://cloud.google.com/vertex-ai/docs/tutorials/tabular-bq-prediction/prerequisites?hl=fr#find-project-id" target="_blank">Trouver votre ID de projet Google&nbsp;Cloud</a> pour plus d'informations.<p>Exemple&nbsp;: <kbd>my-sample-project-370819</kbd> </p></li> </ul> |
| Paramètres Hugging Face | <ul> <li> <span>Model name</span>&nbsp;: cliquez sur le bouton <span>[...]</span> près du champ pour sélectionner le modèle intégré.</li> <li> <span>Token/API Key</span>&nbsp;: cliquez sur le bouton <span>[...]</span> près du champ pour saisir le jeton d'accès à votre plateforme Hugging Face.</li> </ul><br><br>Vous pouvez renseigner l'URL du serveur d'API dans le paramètre Base URL de la vue Advanced settings. |
| Paramètres Mistral AI | <ul> <li> <span>Model name</span>&nbsp;: cliquez sur le bouton <span>[...]</span> près du champ pour sélectionner le modèle intégré.</li> <li> <span>Token/API Key</span>&nbsp;: cliquez sur le bouton <span>[...]</span> près du champ pour saisir le jeton d'accès à votre plateforme Mistral AI.</li> </ul><br><br>Vous pouvez renseigner l'URL du serveur d'API dans le paramètre Base URL de la vue Advanced settings. |
| Paramètres ONNX | Cochez la case Use local ONNX file pour utiliser un fichier tokenizer local de segmentation. Spécifiez le chemin du modèle et du tokenizer, ainsi que le mode de pooling à appliquer. Si cette case n'est pas cochée, le fichier tokenizer embarqué par défaut est utilisé.<br><br>Consultez [Introduction to ONNX](https://onnx.ai/onnx/intro/index.html) (en anglais) pour plus d'informations. |
| Column for embedding | Sélectionnez ou saisissez la colonne de schéma à appliquer sur le modèle d'intégration. |

## Advanced settings

| Propriétés | Description |
| --- | --- |
| tStatCatcher Statistics | Cochez cette case pour collecter les métadonnées de traitement du Job, aussi bien au niveau du Job qu'au niveau de chaque composant. |
| Base URL | Saisissez l'URL de base du serveur d'API auquel accéder.<br><br>Cette option est disponible pour les plateformes Ali Bailian, Cohere, Hugging Face et Mistral AI. |

## Variables globales

| Variables | Description |
| --- | --- |
| ERROR\_MESSAGE | Message d'erreur généré par le composant lorsqu'une erreur survient. Cette variable est une variable After et retourne une chaîne de caractères. |

## Utilisation

| Conseils d'utilisation | Description |
| --- | --- |
| Règle d'utilisation | Ce composant peut être utilisé en standalone ou en tant que composant de début dans un Job ou un sous-Job. |

**Tâches associées**

* [Indexer des évaluations de téléphones avec une base de données et des intégrations vectorielles](https://help.qlik.com/talend/fr-FR/components/8.0/ai/tembeddingai-tpineconeclient-tmap-indexing-phone-reviews-with-embeddings-and-vector-db "Ce Job lit des fichiers texte d'évaluations de téléphones depuis un dossier, scinde le contenu en morceaux plus petits pour une meilleure analyse, génère des intégrations vectorielles à l'aide d'Azure OpenAI et les stocke dans une base de données Pinecone vectorielle, pour implémenter la recherche sémantique.")