cd@bziiit.com
commited on
Commit
·
e3d4358
1
Parent(s):
c7321da
Update README.md to include Pinecone integration details and environment variable configuration
Browse files
README.md
CHANGED
|
@@ -55,22 +55,63 @@ L'application est structurée en trois parties principales :
|
|
| 55 |
|
| 56 |
## Base de Données Vectorielle
|
| 57 |
|
| 58 |
-
|
| 59 |
|
| 60 |
-
|
| 61 |
|
| 62 |
-
|
| 63 |
|
| 64 |
-
|
| 65 |
|
| 66 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 67 |
|
| 68 |
## Déploiement
|
| 69 |
|
| 70 |
Pour déployer cette application sur Huggingface :
|
| 71 |
|
| 72 |
1. Dupliquez l'espace Huggingface existant.
|
| 73 |
-
2.
|
| 74 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 75 |
|
| 76 |
|
|
|
|
| 55 |
|
| 56 |
## Base de Données Vectorielle
|
| 57 |
|
| 58 |
+
La base de données vectorielle permet de stocker de manière permanente les différents vecteurs de documents, afin de faciliter leur recherche et leur utilisation dans les conversations avec l'IA.
|
| 59 |
|
| 60 |
+
### Pinecone
|
| 61 |
|
| 62 |
+
L'application utilise **Pinecone**, une solution cloud pour la gestion de bases de données vectorielles. Pinecone simplifie la gestion des vecteurs et permet une intégration efficace avec l'application.
|
| 63 |
|
| 64 |
+
Pour que l'intégration fonctionne correctement, vous devez renseigner les variables d'environnement suivantes :
|
| 65 |
|
| 66 |
+
- **PINECONE_API_KEY** : Clé d'API fournie par Pinecone pour l'accès à votre compte.
|
| 67 |
+
- **PINECONE_INDEX_NAME** : Le nom de l'index Pinecone dans lequel les vecteurs seront stockés.
|
| 68 |
+
- **PINECONE_NAMESPACE** : Un namespace unique propre à chaque application, utilisé pour organiser les vecteurs.
|
| 69 |
+
|
| 70 |
+
Ces informations sont disponibles directement dans votre compte Pinecone, et doivent être correctement configurées pour permettre le fonctionnement de la base de données vectorielle.
|
| 71 |
+
|
| 72 |
+
|
| 73 |
+
## Configuration de l'application
|
| 74 |
+
|
| 75 |
+
Vous pouvez configurer votre application plus finement en la personalisant en fonction de vos besoins. Ces configurations se font dans le fichier *config.yaml* accessible dans la partie *Files* de votre espace Huggingface. La modification se fait ensuite via le bouton *'edit'*.
|
| 76 |
+
Une fois, vos modifications effectuées, cliquez sur *'Commit changes to main'* pour les enregistrer et relancer automatiquement l'application.
|
| 77 |
+
|
| 78 |
+
#### Paramètres Dynamiques
|
| 79 |
+
|
| 80 |
+
Les paramètres peuvent être ajustés dans la section **variables**, en mettant la liste des variables souhaitées.
|
| 81 |
+
Pour chacune d'entre elles, un *label*, une *key* et optionnelement une valeur par défaut *value* sont nécessaires.
|
| 82 |
+
Pour être prise en compte, ces variables doivent être implémenté dans le prompt template via leur *'key'* sous la forme **{ma_variable}**
|
| 83 |
+
|
| 84 |
+
#### Prompt template
|
| 85 |
+
|
| 86 |
+
Vous pouvez directement spécifier votre prompt template dans la section **prompt_template** du fichier de configuration
|
| 87 |
+
|
| 88 |
+
#### Prompts par Défaut
|
| 89 |
+
|
| 90 |
+
Des *prompts* par défaut peuvent être définis pour démarrer les conversations avec l'IA. Ces *prompts* sont personnalisables dans la section **prompts**.
|
| 91 |
+
La première tabulation correspond à une catégorie, permettant de faire des regroupements.
|
| 92 |
+
Chaque '-' représente ensuite un prompt qui sera proposé.
|
| 93 |
|
| 94 |
## Déploiement
|
| 95 |
|
| 96 |
Pour déployer cette application sur Huggingface :
|
| 97 |
|
| 98 |
1. Dupliquez l'espace Huggingface existant.
|
| 99 |
+
2. Renseignez les variables d'environnements. Il vous sera demandé de rentrer toutes les variables d'environnements. Vous les variables qui seront propres à votre application :
|
| 100 |
+
- **APP_NAME** : Nom de votre application
|
| 101 |
+
- **PINECONE_NAMESPACE** : Espace de stockage permanent de votre application
|
| 102 |
+
3. Ajustez votre configuration dans le fichier *config.yaml* (voir section **Configuration de l'application**)
|
| 103 |
+
|
| 104 |
+
|
| 105 |
+
## Variables d'environnements
|
| 106 |
+
| Variable | Description
|
| 107 |
+
|----------|----------
|
| 108 |
+
**APP_NAME**|Nom de l'application
|
| 109 |
+
**ANTHROPIC_API_KEY**| Clé API Anthropic
|
| 110 |
+
**MISTRAL_API_KEY**|Clé API Mistral
|
| 111 |
+
**OPENAI_API_KEY**|Clé API OpenAI
|
| 112 |
+
**LLAMA_API_KEY**|Clé Llama API
|
| 113 |
+
**PINECONE_API_KEY**|Clé API Pinecone
|
| 114 |
+
**PINECONE_INDEX_NAME**|Index/BDD Pinecone
|
| 115 |
+
**PINECONE_NAMESPACE**|Espace de stockage propre à l'application
|
| 116 |
|
| 117 |
|