@oryksa/react-native 1.1.3 → 1.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +44 -37
- package/README.es.md +181 -161
- package/README.fr.md +181 -161
- package/README.md +181 -161
- package/README.pt.md +181 -161
- package/package.json +69 -69
- package/src/client.js +307 -267
- package/src/index.d.ts +257 -237
package/README.fr.md
CHANGED
|
@@ -1,161 +1,181 @@
|
|
|
1
|
-
<p align="center"><img src="https://app.oryksa.com/static/oryksa_logo.png" width="300" alt="ORYKSA"></p>
|
|
2
|
-
|
|
3
|
-
# @oryksa/react-native
|
|
4
|
-
|
|
5
|
-
[](README.md) [](README.pt.md) [](README.es.md) [](README.fr.md)
|
|
6
|
-
|
|
7
|
-
<p align="center"><a href="https://developer.oryksa.com/fr/sdks"><img src="https://developer.oryksa.com/assets/img/sdk/oryksa-sdks-fr.gif" width="760" alt="SDK ORYKSA : le chat et la voix de l'IA sur iOS, Android, Flutter, React Native et le web"></a></p>
|
|
8
|
-
|
|
9
|
-
SDK React Native officiel d'**ORYKSA AI Employees**. Mettez dans votre app iOS et Android (React Native ou Expo) un employé IA qui connaît déjà votre entreprise : un chat prêt à l'emploi identique au chat du site ORYKSA, le nom et la photo de votre IA issus de votre compte ORYKSA, en anglais, portugais et espagnol.
|
|
10
|
-
|
|
11
|
-
* Documentation : https://developer.oryksa.com/fr/sdks
|
|
12
|
-
* API : `https://api.oryksa.com/v1`
|
|
13
|
-
* Aucun code natif : fonctionne dans Expo Go.
|
|
14
|
-
|
|
15
|
-
## Captures d'écran
|
|
16
|
-
|
|
17
|
-
<p align="center"><img src="https://raw.githubusercontent.com/oryksa/oryksa-react-native/main/docs/screenshots/rn_product_en.png" width="230" alt="Product page with the chat button"> <img src="https://raw.githubusercontent.com/oryksa/oryksa-react-native/main/docs/screenshots/rn_chat_en.png" width="230" alt="Chat"> <img src="https://raw.githubusercontent.com/oryksa/oryksa-react-native/main/docs/screenshots/rn_theme_en.png" width="230" alt="Chat with the README theme"></p>
|
|
18
|
-
|
|
19
|
-
Les composants du SDK eux-mêmes, affichés par la CI dans Chrome au format téléphone avec React Native for Web et un compte de test ORYKSA (`test/web/`). Sur un téléphone, le chat affiche aussi le micro, qui nécessite les bibliothèques audio natives. Le chat vert utilise le code de *Couleurs et thème*, plus bas.
|
|
20
|
-
|
|
21
|
-
## Installer
|
|
22
|
-
|
|
23
|
-
```bash
|
|
24
|
-
npm install @oryksa/react-native
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
## À quoi il sert
|
|
28
|
-
|
|
29
|
-
Le SDK met le chat et la voix ORYKSA dans votre app pour servir les **clients de votre entreprise** : ils posent des questions, achètent et réservent. L'IA répond avec votre Brain, vos produits et vos services, avec le nom, la photo et la voix que vous avez choisis dans *Votre IA*, et enregistre les leads, réservations et ventes dans les Activités de votre compte ORYKSA. Ce n'est **pas** une interface pour le propriétaire : via le SDK, personne ne modifie les paramètres, ne lit les Activités ni ne donne d'ordres à ORYKSA. En savoir plus : https://help.oryksa.com/fr/a/sdks-what-they-do
|
|
30
|
-
|
|
31
|
-
Les gros mots que le client tape apparaissent sous forme d'astérisques dans le chat (la même liste que tous les chats ORYKSA, chargée depuis `https://app.oryksa.com/widget/profanity.json`, conservée 24 heures). Les réponses de l'IA arrivent déjà filtrées par le serveur.
|
|
32
|
-
|
|
33
|
-
## Voix et contexte de l'app (1.1)
|
|
34
|
-
|
|
35
|
-
Le chat affiche un micro quand votre forfait inclut la voix. Il ouvre l'écran vocal avec le même comportement que l'app ORYKSA : le micro reste ouvert pendant qu'elle parle et seule une voix humaine l'interrompt (la frappe au clavier, la télévision et son propre écho ne l'interrompent pas) ; elle s'arrête sur le mot et le texte reste dans le chat ; à un chuchotement, elle répond en chuchotant ; si sa voix échoue, le texte est affiché (jamais une voix robotique).
|
|
36
|
-
|
|
37
|
-
La voix nécessite trois bibliothèques natives (dépendances peer optionnelles) et l'autorisation du micro (Android `RECORD_AUDIO`, iOS `NSMicrophoneUsageDescription`) :
|
|
38
|
-
|
|
39
|
-
```sh
|
|
40
|
-
npm install react-native-live-audio-stream react-native-sound react-native-fs
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
Sans elles, le chat fonctionne et le micro est masqué. Avec Expo ou une autre pile audio : passez votre propre adaptateur `audio` (`startMic`, `stopMic`, `play`, `stopPlayback`).
|
|
44
|
-
|
|
45
|
-
Chaque réponse de l'IA a un bouton copier en dessous. Il utilise `@react-native-clipboard/clipboard` s'il est installé (dépendance peer optionnelle : `npm install @react-native-clipboard/clipboard`) ; les versions plus anciennes de React Native utilisent le `Clipboard` intégré.
|
|
46
|
-
|
|
47
|
-
```jsx
|
|
48
|
-
<OryksaChatButton client={client} lang="pt"
|
|
49
|
-
appContext={() => ({ screen: "product", title: "Sky Beginner Snowboard, 489.95" })} />
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
## Liens avec un bouton pour les ouvrir (1.1.3)
|
|
53
|
-
|
|
54
|
-
Les liens que donne l'IA se touchent dans le chat (adresses web et e-mails), et chaque lien web a une carte sous sa réponse avec la photo et le titre de la page et un bouton pour l'ouvrir (les pages de votre propre site, les domaines de votre chat web ; les autres sites montrent l'adresse). L'écran vocal montre ce qu'elle dit sans les adresses, avec les mêmes cartes ; toucher le bouton ferme l'écran vocal. Passez `onLink` pour ouvrir vos propres écrans, par exemple la page du produit : renvoyez true quand votre app l'a ouvert, false pour laisser le système l'ouvrir (`Linking.openURL`).
|
|
55
|
-
|
|
56
|
-
```jsx
|
|
57
|
-
<OryksaChatButton client={client} lang="en"
|
|
58
|
-
onLink={(url) => {
|
|
59
|
-
const id = myProductIdOf(url); // vos routes
|
|
60
|
-
if (!id) return false;
|
|
61
|
-
navigation.navigate("Product", { id });
|
|
62
|
-
return true;
|
|
63
|
-
}} />
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
`onLink` existe aussi sur `OryksaChat`, `OryksaChatModal` et `OryksaVoiceScreen`.
|
|
67
|
-
|
|
68
|
-
## Joindre une photo ou un document (1.1.3)
|
|
69
|
-
|
|
70
|
-
Le chat a un bouton pour joindre (un trombone, activé par défaut) : une photo de la galerie, une photo de l'appareil photo ou un document (PDF, Word, texte, CSV, jusqu'à 8 Mo). L'IA regarde la photo (réduite à 1600 pixels, JPEG 80 %, jusqu'à 2 Mo) et lit le document ; la bulle du client montre la photo, ou l'icône du document et son nom. `attachments={false}` masque le bouton.
|
|
71
|
-
|
|
72
|
-
React Native n'a pas de sélecteur propre, donc le SDK utilise deux bibliothèques optionnelles que votre app installe (dépendances peer optionnelles, comme celles de la voix). Chaque option n'apparaît que lorsque sa bibliothèque est là ; sans les deux, le bouton est masqué :
|
|
73
|
-
|
|
74
|
-
```sh
|
|
75
|
-
npm install react-native-image-picker @react-native-documents/picker
|
|
76
|
-
```
|
|
77
|
-
|
|
78
|
-
* `react-native-image-picker` : galerie et appareil photo. Info.plist iOS : `NSPhotoLibraryUsageDescription` et `NSCameraUsageDescription`. Android : aucune autorisation pour la galerie ; pour l'appareil photo, `CAMERA` n'est nécessaire que si votre app la déclare dans son propre manifest (accordez-la alors avant d'ouvrir l'appareil photo).
|
|
79
|
-
* `@react-native-documents/picker` : documents, dans le sélecteur de documents du système (sans autorisation). Les documents sont lus avec `react-native-fs` quand il est installé, sinon avec `fetch`.
|
|
80
|
-
|
|
81
|
-
```jsx
|
|
82
|
-
<OryksaChatButton client={client} lang="en" attachments={false} /> {/* sans bouton pour joindre */}
|
|
83
|
-
|
|
84
|
-
// Expo ou une autre stack : vos propres sélecteurs (s'il en manque un, ce choix est masqué)
|
|
85
|
-
const picker = {
|
|
86
|
-
pickPhoto: () => myPhotoPicker(), // { base64, mime } réduite (1600 px, JPEG 80 %), ou null
|
|
87
|
-
pickDocument: () => myDocumentPicker(), // { base64, name, mime }, ou null
|
|
88
|
-
};
|
|
89
|
-
<OryksaChat client={client} picker={picker} />
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
Sans l'interface : `client.send("Voici le devis", { file: { base64, name: "devis.pdf", mime: "application/pdf" } })` (photos : `{ image: { base64, mime } }`).
|
|
93
|
-
|
|
94
|
-
##
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
1
|
+
<p align="center"><img src="https://app.oryksa.com/static/oryksa_logo.png" width="300" alt="ORYKSA"></p>
|
|
2
|
+
|
|
3
|
+
# @oryksa/react-native
|
|
4
|
+
|
|
5
|
+
[](README.md) [](README.pt.md) [](README.es.md) [](README.fr.md)
|
|
6
|
+
|
|
7
|
+
<p align="center"><a href="https://developer.oryksa.com/fr/sdks"><img src="https://developer.oryksa.com/assets/img/sdk/oryksa-sdks-fr.gif" width="760" alt="SDK ORYKSA : le chat et la voix de l'IA sur iOS, Android, Flutter, React Native et le web"></a></p>
|
|
8
|
+
|
|
9
|
+
SDK React Native officiel d'**ORYKSA AI Employees**. Mettez dans votre app iOS et Android (React Native ou Expo) un employé IA qui connaît déjà votre entreprise : un chat prêt à l'emploi identique au chat du site ORYKSA, le nom et la photo de votre IA issus de votre compte ORYKSA, en anglais, portugais et espagnol.
|
|
10
|
+
|
|
11
|
+
* Documentation : https://developer.oryksa.com/fr/sdks
|
|
12
|
+
* API : `https://api.oryksa.com/v1`
|
|
13
|
+
* Aucun code natif : fonctionne dans Expo Go.
|
|
14
|
+
|
|
15
|
+
## Captures d'écran
|
|
16
|
+
|
|
17
|
+
<p align="center"><img src="https://raw.githubusercontent.com/oryksa/oryksa-react-native/main/docs/screenshots/rn_product_en.png" width="230" alt="Product page with the chat button"> <img src="https://raw.githubusercontent.com/oryksa/oryksa-react-native/main/docs/screenshots/rn_chat_en.png" width="230" alt="Chat"> <img src="https://raw.githubusercontent.com/oryksa/oryksa-react-native/main/docs/screenshots/rn_theme_en.png" width="230" alt="Chat with the README theme"></p>
|
|
18
|
+
|
|
19
|
+
Les composants du SDK eux-mêmes, affichés par la CI dans Chrome au format téléphone avec React Native for Web et un compte de test ORYKSA (`test/web/`). Sur un téléphone, le chat affiche aussi le micro, qui nécessite les bibliothèques audio natives. Le chat vert utilise le code de *Couleurs et thème*, plus bas.
|
|
20
|
+
|
|
21
|
+
## Installer
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
npm install @oryksa/react-native
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## À quoi il sert
|
|
28
|
+
|
|
29
|
+
Le SDK met le chat et la voix ORYKSA dans votre app pour servir les **clients de votre entreprise** : ils posent des questions, achètent et réservent. L'IA répond avec votre Brain, vos produits et vos services, avec le nom, la photo et la voix que vous avez choisis dans *Votre IA*, et enregistre les leads, réservations et ventes dans les Activités de votre compte ORYKSA. Ce n'est **pas** une interface pour le propriétaire : via le SDK, personne ne modifie les paramètres, ne lit les Activités ni ne donne d'ordres à ORYKSA. En savoir plus : https://help.oryksa.com/fr/a/sdks-what-they-do
|
|
30
|
+
|
|
31
|
+
Les gros mots que le client tape apparaissent sous forme d'astérisques dans le chat (la même liste que tous les chats ORYKSA, chargée depuis `https://app.oryksa.com/widget/profanity.json`, conservée 24 heures). Les réponses de l'IA arrivent déjà filtrées par le serveur.
|
|
32
|
+
|
|
33
|
+
## Voix et contexte de l'app (1.1)
|
|
34
|
+
|
|
35
|
+
Le chat affiche un micro quand votre forfait inclut la voix. Il ouvre l'écran vocal avec le même comportement que l'app ORYKSA : le micro reste ouvert pendant qu'elle parle et seule une voix humaine l'interrompt (la frappe au clavier, la télévision et son propre écho ne l'interrompent pas) ; elle s'arrête sur le mot et le texte reste dans le chat ; à un chuchotement, elle répond en chuchotant ; si sa voix échoue, le texte est affiché (jamais une voix robotique).
|
|
36
|
+
|
|
37
|
+
La voix nécessite trois bibliothèques natives (dépendances peer optionnelles) et l'autorisation du micro (Android `RECORD_AUDIO`, iOS `NSMicrophoneUsageDescription`) :
|
|
38
|
+
|
|
39
|
+
```sh
|
|
40
|
+
npm install react-native-live-audio-stream react-native-sound react-native-fs
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Sans elles, le chat fonctionne et le micro est masqué. Avec Expo ou une autre pile audio : passez votre propre adaptateur `audio` (`startMic`, `stopMic`, `play`, `stopPlayback`).
|
|
44
|
+
|
|
45
|
+
Chaque réponse de l'IA a un bouton copier en dessous. Il utilise `@react-native-clipboard/clipboard` s'il est installé (dépendance peer optionnelle : `npm install @react-native-clipboard/clipboard`) ; les versions plus anciennes de React Native utilisent le `Clipboard` intégré.
|
|
46
|
+
|
|
47
|
+
```jsx
|
|
48
|
+
<OryksaChatButton client={client} lang="pt"
|
|
49
|
+
appContext={() => ({ screen: "product", title: "Sky Beginner Snowboard, 489.95" })} />
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## Liens avec un bouton pour les ouvrir (1.1.3)
|
|
53
|
+
|
|
54
|
+
Les liens que donne l'IA se touchent dans le chat (adresses web et e-mails), et chaque lien web a une carte sous sa réponse avec la photo et le titre de la page et un bouton pour l'ouvrir (les pages de votre propre site, les domaines de votre chat web ; les autres sites montrent l'adresse). L'écran vocal montre ce qu'elle dit sans les adresses, avec les mêmes cartes ; toucher le bouton ferme l'écran vocal. Passez `onLink` pour ouvrir vos propres écrans, par exemple la page du produit : renvoyez true quand votre app l'a ouvert, false pour laisser le système l'ouvrir (`Linking.openURL`).
|
|
55
|
+
|
|
56
|
+
```jsx
|
|
57
|
+
<OryksaChatButton client={client} lang="en"
|
|
58
|
+
onLink={(url) => {
|
|
59
|
+
const id = myProductIdOf(url); // vos routes
|
|
60
|
+
if (!id) return false;
|
|
61
|
+
navigation.navigate("Product", { id });
|
|
62
|
+
return true;
|
|
63
|
+
}} />
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
`onLink` existe aussi sur `OryksaChat`, `OryksaChatModal` et `OryksaVoiceScreen`.
|
|
67
|
+
|
|
68
|
+
## Joindre une photo ou un document (1.1.3)
|
|
69
|
+
|
|
70
|
+
Le chat a un bouton pour joindre (un trombone, activé par défaut) : une photo de la galerie, une photo de l'appareil photo ou un document (PDF, Word, texte, CSV, jusqu'à 8 Mo). L'IA regarde la photo (réduite à 1600 pixels, JPEG 80 %, jusqu'à 2 Mo) et lit le document ; la bulle du client montre la photo, ou l'icône du document et son nom. `attachments={false}` masque le bouton.
|
|
71
|
+
|
|
72
|
+
React Native n'a pas de sélecteur propre, donc le SDK utilise deux bibliothèques optionnelles que votre app installe (dépendances peer optionnelles, comme celles de la voix). Chaque option n'apparaît que lorsque sa bibliothèque est là ; sans les deux, le bouton est masqué :
|
|
73
|
+
|
|
74
|
+
```sh
|
|
75
|
+
npm install react-native-image-picker @react-native-documents/picker
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
* `react-native-image-picker` : galerie et appareil photo. Info.plist iOS : `NSPhotoLibraryUsageDescription` et `NSCameraUsageDescription`. Android : aucune autorisation pour la galerie ; pour l'appareil photo, `CAMERA` n'est nécessaire que si votre app la déclare dans son propre manifest (accordez-la alors avant d'ouvrir l'appareil photo).
|
|
79
|
+
* `@react-native-documents/picker` : documents, dans le sélecteur de documents du système (sans autorisation). Les documents sont lus avec `react-native-fs` quand il est installé, sinon avec `fetch`.
|
|
80
|
+
|
|
81
|
+
```jsx
|
|
82
|
+
<OryksaChatButton client={client} lang="en" attachments={false} /> {/* sans bouton pour joindre */}
|
|
83
|
+
|
|
84
|
+
// Expo ou une autre stack : vos propres sélecteurs (s'il en manque un, ce choix est masqué)
|
|
85
|
+
const picker = {
|
|
86
|
+
pickPhoto: () => myPhotoPicker(), // { base64, mime } réduite (1600 px, JPEG 80 %), ou null
|
|
87
|
+
pickDocument: () => myDocumentPicker(), // { base64, name, mime }, ou null
|
|
88
|
+
};
|
|
89
|
+
<OryksaChat client={client} picker={picker} />
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
Sans l'interface : `client.send("Voici le devis", { file: { base64, name: "devis.pdf", mime: "application/pdf" } })` (photos : `{ image: { base64, mime } }`).
|
|
93
|
+
|
|
94
|
+
## Vos propres fonctions d'IA : `ai` (1.1.4)
|
|
95
|
+
|
|
96
|
+
Faites faire à l'IA ce dont votre app a besoin (lire une photo, extraire des données, classer, traduire, rédiger) et payez en interactions ORYKSA : 1 par réponse. Votre prompt et votre JSON Schema restent dans votre app ; le jeton de session suffit (n'embarquez jamais la clé secrète). Aucune conversation n'est créée dans votre boîte.
|
|
97
|
+
|
|
98
|
+
```js
|
|
99
|
+
const r = await client.ai({
|
|
100
|
+
instructions: "Read the tyre on the photo: brand, model and size exactly as written on the sidewall. " +
|
|
101
|
+
"If the size is not legible, readable=false and size=null. Never invent.",
|
|
102
|
+
images: [{ base64: photoBase64, mime: "image/jpeg" }], // resized to 1600 px
|
|
103
|
+
schema: {
|
|
104
|
+
type: "object",
|
|
105
|
+
properties: { readable: { type: "boolean" }, brand: { type: ["string", "null"] }, size: { type: ["string", "null"] } },
|
|
106
|
+
required: ["readable", "brand", "size"],
|
|
107
|
+
},
|
|
108
|
+
});
|
|
109
|
+
if (r.json?.readable) showProducts(r.json.size);
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
`r.text` contient la réponse en texte, `r.json` l'objet (avec un schema) et `r.interactionsSpent` les interactions utilisées. Quand les interactions du forfait sont épuisées, l'appel lève une `OryksaError` avec le status 402.
|
|
113
|
+
|
|
114
|
+
## Comment ça marche (et pourquoi la clé reste en sécurité)
|
|
115
|
+
|
|
116
|
+
1. Votre **serveur** garde la clé API secrète (`oryk_live_...`, créée sur developer.oryksa.com) et crée un **jeton de session** de courte durée pour chaque utilisateur connecté avec `POST /v1/sessions` (avec `@oryksa/sdk` sur Node : `oryksa.createSession(...)`).
|
|
117
|
+
2. Votre **app** ne reçoit que ce jeton de session (`oryk_cs_...`). La clé secrète n'entre jamais dans l'app.
|
|
118
|
+
3. Chaque réponse de l'IA compte comme une interaction de votre forfait ORYKSA, comme sur WhatsApp.
|
|
119
|
+
|
|
120
|
+
## Dans l'app
|
|
121
|
+
|
|
122
|
+
```jsx
|
|
123
|
+
import { OryksaClient, OryksaChatButton } from "@oryksa/react-native";
|
|
124
|
+
|
|
125
|
+
const client = new OryksaClient({
|
|
126
|
+
getToken: async () => (await fetch("https://your-server.example/oryksa-token").then((r) => r.json())).token,
|
|
127
|
+
});
|
|
128
|
+
|
|
129
|
+
export default function App() {
|
|
130
|
+
return (
|
|
131
|
+
<View style={{ flex: 1 }}>
|
|
132
|
+
<MyScreens />
|
|
133
|
+
<OryksaChatButton client={client} lang="en" /> {/* en, pt, br, es */}
|
|
134
|
+
</View>
|
|
135
|
+
);
|
|
136
|
+
}
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
Autres éléments :
|
|
140
|
+
|
|
141
|
+
* `<OryksaChatModal client={client} visible={open} onClose={() => setOpen(false)} />` : ouvrir le chat depuis votre propre bouton.
|
|
142
|
+
* `<OryksaChat client={client} />` : le panneau dans n'importe quel écran.
|
|
143
|
+
* `theme={{ accent: "#5B57E0" }}` : couleurs.
|
|
144
|
+
* Sans l'interface : `await client.agent()`, `await client.sendAndWait("Are you open on Saturday?")`, `await client.messages()`.
|
|
145
|
+
|
|
146
|
+
## Garder l'IA synchronisée avec votre app
|
|
147
|
+
|
|
148
|
+
Sur votre serveur, avec `@oryksa/sdk` :
|
|
149
|
+
|
|
150
|
+
```js
|
|
151
|
+
await oryksa.learnApp({ name: "FitTrack", description: "...", screens: [...], faq: [...] });
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
## Erreurs
|
|
155
|
+
|
|
156
|
+
Les appels qui échouent lèvent `OryksaError` avec `status`, `code` (par exemple `interaction_limit_reached`, `rate_limited`, `plan_required`) et `message`.
|
|
157
|
+
|
|
158
|
+
## Couleurs et thème
|
|
159
|
+
|
|
160
|
+
La prop `theme` prend un objet avec jusqu'à cinq couleurs en texte hexadécimal : `accent` (boutons, bulles du visiteur, liens), `ink` (texte principal), `soft` (bulles de l'IA), `background` (panneau) et `muted` (texte secondaire). Les clés absentes gardent la valeur par défaut, donc `{ accent: "#0E8A6B" }` suffit. Cela fonctionne sur `OryksaChatButton`, `OryksaChatModal` et `OryksaChat`, et les valeurs par défaut sont exportées sous `DEFAULT_THEME`.
|
|
161
|
+
|
|
162
|
+
```jsx
|
|
163
|
+
const theme = { accent: "#0E8A6B" };
|
|
164
|
+
|
|
165
|
+
<OryksaChatButton client={client} lang="en" theme={theme} />
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
Il n'y a pas de thème sombre automatique : pour le mode sombre, passez vos propres couleurs sombres.
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## À propos de l'auteur
|
|
173
|
+
|
|
174
|
+
**Weslley Harakawa** - Fondateur d'ORYKSA AI. À Lisbonne, Portugal. Spécialités : intelligence artificielle, développement web et mobile, tokenisation blockchain. Formation : University of the People.
|
|
175
|
+
|
|
176
|
+
- LinkedIn: https://www.linkedin.com/in/weslleyharakawa/
|
|
177
|
+
- ORYKSA AI Employees: https://oryksa.com (X: https://x.com/oryksa, Instagram: https://www.instagram.com/oryksaai, YouTube: https://www.youtube.com/@ORYKSA)
|
|
178
|
+
|
|
179
|
+
---
|
|
180
|
+
|
|
181
|
+
MIT License · ORYKSA AI Employees · W8 Atlantic Unipessoal Lda
|