Merge pull request #548 from mistralai/sync/latest

Sync docs to v1.3.3

Author: grebett

src/content/en/docs/robots/page.mdx

@@ -1,43 +1,50 @@
 ---
 id: robots
-title: Mistral AI Crawlers
+title: Mistral crawlers
 slug: robots
 ---
 
 import { SectionTab } from '@/components/layout/section-tab';
 
-# Mistral AI Crawlers
+# Mistral crawlers
 
-Mistral uses web crawlers, also known as robots, and user agents to run product tasks automatically or when a user requests them. To help webmasters manage how their sites and content interact with AI, Mistral uses specific `robots.txt` tags.
+Mistral uses web crawlers, also known as robots, and user-agent strings to run product tasks automatically or when a user requests them. To help webmasters manage how their sites and content interact with AI, Mistral uses specific `robots.txt` tags.
 
 <SectionTab as="h1" sectionId="mistralai-user">MistralAI-User</SectionTab>
 
 `MistralAI-User` is for **user actions in Vibe**. When users ask Vibe a question, it may **visit a web page** to help answer and **include a link to the source in its response**.
 
 `MistralAI-User` governs which sites these user requests can be made to. It is **not used for crawling the web in any automatic fashion, nor to crawl content for generative AI training**.
 
-For more information about Mistral policy for web crawlers used for generative AI training, see the [Mistral Legal Center](https://legal.mistral.ai/).
-
 <SectionTab as="h2" variant="secondary" sectionId="mistralai-user-info">Crawler info</SectionTab>
 
 Full user-agent string:
 - `Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; MistralAI-User/1.0; +https://docs.mistral.ai/robots)`
 
 All published IP addresses:
-- https://mistral.ai/mistralai-user-ips.json
+- [MistralAI-User IP addresses](https://mistral.ai/mistralai-user-ips.json)
 
 <SectionTab as="h1" sectionId="mistralai-index">MistralAI-Index</SectionTab>
 
 `MistralAI-Index` is for **automated crawling** of the web for **indexing purposes only**. It indexes content for Mistral search, which helps answer user questions in Vibe.
 
 Content crawled by `MistralAI-Index` is **not used for generative AI training of any kind**.
 
-For more information about Mistral policy for web crawlers used for generative AI training, see the [Mistral Legal Center](https://legal.mistral.ai/).
-
 <SectionTab as="h2" variant="secondary" sectionId="mistralai-index-info">Crawler info</SectionTab>
 
 Full user-agent string:
 - `Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; MistralAI-Index/1.0; +https://docs.mistral.ai/robots)`
 
 All published IP addresses:
-- https://mistral.ai/mistralai-index-ips.json
+- [MistralAI-Index IP addresses](https://mistral.ai/mistralai-index-ips.json)
+
+<SectionTab as="h1" sectionId="mistralai-training">MistralAI-Training</SectionTab>
+
+`MistralAI-Training` crawls web content to help build datasets for training Mistral generative AI models. Webmasters can disallow this user agent in their `robots.txt` file.
+
+This crawler is not used for search indexing or to answer live user queries in Vibe.
+
+<SectionTab as="h2" variant="secondary" sectionId="mistralai-training-info">Crawler info</SectionTab>
+
+Full user-agent string:
+- `Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; MistralAI-Training/1.0; +https://docs.mistral.ai/robots)`

src/content/en/docs/studio-api/regional-inference/page.mdx

@@ -4,11 +4,12 @@ title: Regional Inference
 sidebar_position: 99
 ---
 
+import { Tabs, TabItem } from '@/components/common/multi-codeblock';
 import { SectionTab } from '@/components/layout/section-tab';
 
 # Regional Inference
 
-Regional inference routes your API requests to models hosted in a specific geographic region, guaranteeing that inference occurs within that region and processed data never leaves it. If you don't specify a region, the API uses the global Mistral endpoint.
+Regional inference routes your API requests to models hosted in a specific geographic region. Inference occurs within that region, and processed data doesn't leave it. If you don't specify a region, the API uses the global Mistral endpoint.
 
 <SectionTab as="h2" sectionId="region-groups">Region groups</SectionTab>
 
@@ -21,10 +22,13 @@ Use a regional endpoint when your application needs requests processed in a spec
 
 <SectionTab as="h2" sectionId="use-regional-endpoint">How to use a regional endpoint</SectionTab>
 
-<SectionTab as="h3" variant="secondary" sectionId="python-sdk-version">Python SDK version ≥ 2.70</SectionTab>
+<SectionTab as="h3" variant="secondary" sectionId="python-sdk-version">SDK version ≥ 2.70</SectionTab>
 
 Use the `server` parameter when initializing the client to specify the region:
 
+<Tabs groupId="code">
+  <TabItem value="python" label="python">
+
 ```python
 import os
 from mistralai.client import Mistral
@@ -37,6 +41,34 @@ response = client.chat.complete(
 print(response.choices[0].message.content)
 ```
 
+  </TabItem>
+  <TabItem value="typescript" label="typescript">
+
+```typescript
+import { Mistral } from "@mistralai/mistralai";
+
+const mistral = new Mistral({
+  apiKey: process.env.MISTRAL_API_KEY,
+  server: "eu",
+});
+
+async function main() {
+  const response = await mistral.chat.complete({
+    model: "mistral-medium-latest",
+    messages: [
+      { role: "user", content: "What is the best French cheese?" },
+    ],
+  });
+
+  console.log(response.choices?.[0]?.message?.content);
+}
+
+main();
+```
+
+  </TabItem>
+</Tabs>
+
 <SectionTab as="h3" variant="secondary" sectionId="older-sdk-versions">Older SDK versions</SectionTab>
 
 If using an older SDK, use the `server_url` parameter instead:

src/content/fr/docs/robots/page.mdx

@@ -1,43 +1,56 @@
----
 id: robots
-title: Robots d'indexation Mistral AI
+title: Robots d'exploration Mistral
 slug: robots
 ---
 
 import { SectionTab } from '@/components/layout/section-tab';
 
-# Robots d’indexation de Mistral AI
+# Robots d'exploration Mistral
 
-Mistral utilise des robots d’indexation, également appelés crawlers ou agents utilisateur, pour exécuter automatiquement des tâches liées aux produits ou à la demande d’un utilisateur. Pour permettre aux webmasters de gérer la façon dont leurs sites et leur contenu interagissent avec l'IA, Mistral utilise des balises spécifiques dans le fichier `robots.txt`.
+Mistral utilise des robots d'exploration web, aussi appelés _crawlers_ ou _robots_, ainsi que des chaînes de 'user-agent' pour exécuter des tâches automatiques ou à la demande d'un utilisateur. Pour aider les webmasters à contrôler la façon dont leurs sites et leurs contenus interagissent avec l'IA, Mistral utilise des directives `robots.txt` spécifiques.
 
 <SectionTab as="h1" sectionId="mistralai-user">MistralAI-User</SectionTab>
 
-`MistralAI-User` correspond aux **actions utilisateur dans Vibe**. Lorsqu’un utilisateur pose une question à Vibe, celui-ci peut **visiter une page web** pour aider à formuler une réponse et **inclure un lien vers la source dans sa réponse**.
+`MistralAI-User` correspond aux **actions utilisateur dans Vibe**. Lorsqu'un utilisateur pose une question dans Vibe, Vibe peut **consulter une page web** pour produire une réponse et **inclure un lien vers la source utilisée**.
 
-`MistralAI-User` détermine les sites pouvant être consultés dans le cadre de telles demandes. Il **n’est pas utilisé pour explorer le web de façon automatique, ni pour collecter du contenu à des fins d’entraînement de modèles génératifs**.
+`MistralAI-User` détermine les sites que ces requêtes utilisateur peuvent consulter. Il ne sert **pas** à explorer le web de façon automatique ni à collecter du contenu pour l'entraînement de modèles d'IA générative.
 
-Pour plus d’informations sur la politique de Mistral concernant les robots d’indexation utilisés pour l’entraînement de l’IA générative, consultez le [Centre juridique de Mistral](https://legal.mistral.ai/).
+<SectionTab as="h2" variant="secondary" sectionId="mistralai-user-info">Informations sur le robot</SectionTab>
 
-<SectionTab as="h2" variant="secondary" sectionId="mistralai-user-info">Informations sur les crawlers</SectionTab>
+Chaîne de 'user-agent' complète :
 
-Chaîne complète de l’user-agent :
 - `Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; MistralAI-User/1.0; +https://docs.mistral.ai/robots)`
 
-Toutes les adresses IP publiées :
-- https://mistral.ai/mistralai-user-ips.json
+Adresses IP publiées :
+
+- [Adresses IP de MistralAI-User](https://mistral.ai/mistralai-user-ips.json)
 
 <SectionTab as="h1" sectionId="mistralai-index">MistralAI-Index</SectionTab>
 
-Le crawler `MistralAI-Index` est dédié à **l’exploration automatisée** du web **uniquement à des fins d’indexation**. Il indexe le contenu pour la recherche Mistral, ce qui permet de répondre aux questions des utilisateurs dans Vibe.
+`MistralAI-Index` correspond à l'**exploration automatisée** du web à des fins d'**indexation uniquement**. Il indexe du contenu pour la recherche Mistral, qui aide Vibe à répondre aux questions des utilisateurs.
 
-Le contenu exploré par `MistralAI-Index` **n’est jamais utilisé pour l’entraînement de modèles génératifs**.
+Le contenu exploré par `MistralAI-Index` n'est **pas** utilisé pour entraîner des modèles d'IA générative.
 
-Pour plus d’informations sur la politique de Mistral concernant les robots d’indexation utilisés pour l’entraînement de l’IA générative, consultez le [Centre juridique de Mistral](https://legal.mistral.ai/).
+<SectionTab as="h2" variant="secondary" sectionId="mistralai-index-info">Informations sur le robot</SectionTab>
 
-<SectionTab as="h2" variant="secondary" sectionId="mistralai-index-info">Informations sur les crawlers</SectionTab>
+Chaîne d'agent utilisateur complète :
 
-Chaîne complète de l’user-agent :
 - `Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; MistralAI-Index/1.0; +https://docs.mistral.ai/robots)`
 
-Toutes les adresses IP publiées :
-- https://mistral.ai/mistralai-index-ips.json
+Adresses IP publiées :
+
+- [Adresses IP de MistralAI-Index](https://mistral.ai/mistralai-index-ips.json)
+
+<SectionTab as="h1" sectionId="mistralai-training">MistralAI-Training</SectionTab>
+
+`MistralAI-Training` explore des contenus web pour aider à constituer des jeux de données destinés à l'entraînement des modèles d'IA générative de Mistral. Les webmasters peuvent interdire cet agent utilisateur dans leur fichier `robots.txt`.
+
+Ce robot ne sert pas à l'indexation de recherche ni aux réponses en direct dans Vibe.
+
+<SectionTab as="h2" variant="secondary" sectionId="mistralai-training-info">Informations sur le robot</SectionTab>
+
+Chaîne d'agent utilisateur complète :
+
+- `Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; MistralAI-Training/1.0; +https://docs.mistral.ai/robots)`
+
+`MistralAI-Training` explore des contenus web pour aider à constituer des jeux de données destinés à l'entraînement des modèles d'IA générative de Mistral. Les webmasters peuvent interdire ce 'user-agent' dans leur fichier `robots.txt`.

src/content/fr/docs/studio-api/regional-inference/page.mdx

@@ -4,11 +4,12 @@ title: Inférence régionale
 sidebar_position: 99
 ---
 
+import { Tabs, TabItem } from '@/components/common/multi-codeblock';
 import { SectionTab } from '@/components/layout/section-tab';
 
 # Inférence régionale
 
-Les routes d'inférence régionales acheminent vos requêtes API vers des modèles hébergés dans une région géographique spécifique, garantissant que l'inférence s'effectue dans cette région et que les données traitées n'en sortent jamais. Si vous ne spécifiez pas de région, l'API utilise l'endpoint global de Mistral.
+L'inférence régionale achemine vos requêtes API vers des modèles hébergés dans une région géographique spécifique. L'inférence s'effectue dans cette région, et les données traitées n'en sortent pas. Si vous ne spécifiez pas de région, l'API utilise l'endpoint global de Mistral.
 
 <SectionTab as="h2" sectionId="region-groups">Groupes de régions</SectionTab>
 
@@ -21,10 +22,13 @@ Utilisez un endpoint régional lorsque votre application doit traiter les requê
 
 <SectionTab as="h2" sectionId="use-regional-endpoint">Comment utiliser un endpoint régional</SectionTab>
 
-<SectionTab as="h3" variant="secondary" sectionId="python-sdk-version">Version du SDK Python ≥ 2.70</SectionTab>
+<SectionTab as="h3" variant="secondary" sectionId="python-sdk-version">Version du SDK ≥ 2.70</SectionTab>
 
 Utilisez le paramètre `server` lors de l'initialisation du client pour préciser la région :
 
+<Tabs groupId="code">
+  <TabItem value="python" label="Python">
+
 ```python
 import os
 from mistralai.client import Mistral
@@ -37,6 +41,34 @@ response = client.chat.complete(
 print(response.choices[0].message.content)
 ```
 
+  </TabItem>
+  <TabItem value="typescript" label="TypeScript">
+
+```typescript
+import { Mistral } from "@mistralai/mistralai";
+
+const mistral = new Mistral({
+  apiKey: process.env.MISTRAL_API_KEY,
+  server: "eu",
+});
+
+async function main() {
+  const response = await mistral.chat.complete({
+    model: "mistral-medium-latest",
+    messages: [
+      { role: "user", content: "What is the best French cheese?" },
+    ],
+  });
+
+  console.log(response.choices?.[0]?.message?.content);
+}
+
+main();
+```
+
+  </TabItem>
+</Tabs>
+
 <SectionTab as="h3" variant="secondary" sectionId="older-sdk-versions">Anciennes versions du SDK</SectionTab>
 
 Si vous utilisez une ancienne version du SDK, utilisez le paramètre `server_url` :

version.txt

@@ -1 +1 @@
-v1.3.2
+v1.3.3