[email protected]
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 |
|