Merge pull request #556 from mistralai/sync/latest

Sync docs to v1.4.3

Author: grebett

cookbooks.config.json

@@ -252,26 +252,6 @@
     },
     "displayDate": true
   },
-  {
-    "path": "mistral/fine_tune/pixtral_finetune_on_satellite_data.ipynb",
-    "labels": {
-      "integrations": [],
-      "useCases": [
-        "Pixtral",
-        "Finetuning"
-      ]
-    },
-    "availableInDocs": {
-      "page": true,
-      "displayed": true
-    },
-    "title": "",
-    "mainSection": {
-      "featured": "False",
-      "latest": "True"
-    },
-    "displayDate": true
-  },
   {
     "path": "quickstart.ipynb",
     "labels": {
@@ -1644,25 +1624,6 @@
     },
     "displayDate": true
   },
-  {
-    "path": "mistral/fine_tune/mistral_finetune_api.ipynb",
-    "labels": {
-      "integrations": [],
-      "useCases": [
-        "Finetuning"
-      ]
-    },
-    "availableInDocs": {
-      "page": true,
-      "displayed": true
-    },
-    "title": "",
-    "mainSection": {
-      "featured": "False",
-      "latest": "False"
-    },
-    "displayDate": true
-  },
   {
     "path": "mistral/embeddings/embeddings.ipynb",
     "labels": {
@@ -2478,6 +2439,44 @@
     },
     "displayDate": true
   },
+  {
+    "path": "mistral/agents/glm_code_modernizer/01-glm-code-modernizer.md",
+    "labels": {
+      "integrations": [],
+      "useCases": [
+        "Agents"
+      ]
+    },
+    "availableInDocs": {
+      "page": true,
+      "displayed": true
+    },
+    "title": "Modernize legacy Python code using GLM and the GitHub connector",
+    "mainSection": {
+      "featured": "False",
+      "latest": "True"
+    },
+    "displayDate": true
+  },
+  {
+    "path": "mistral/agents/glm_game_generator/01-glm-game-generator.md",
+    "labels": {
+      "integrations": [],
+      "useCases": [
+        "Agents"
+      ]
+    },
+    "availableInDocs": {
+      "page": true,
+      "displayed": true
+    },
+    "title": "Generate a playable HTML5 mini game using the GLM model via the Mistral API",
+    "mainSection": {
+      "featured": "False",
+      "latest": "True"
+    },
+    "displayDate": true
+  },
   {
     "path": "mistral/connectors/database-advisor-agent/01-connectors-management.md",
     "labels": {
@@ -2518,6 +2517,46 @@
     },
     "displayDate": true
   },
+  {
+    "path": "mistral/connectors/quickstart-generator-typescript/02-build-a-quickstart-generator-typescript.md",
+    "labels": {
+      "integrations": [],
+      "useCases": [
+        "Connectors",
+        "Agents"
+      ]
+    },
+    "availableInDocs": {
+      "page": true,
+      "displayed": true
+    },
+    "title": "Build a Quickstart Generator with Connectors and Web Search (TypeScript)",
+    "mainSection": {
+      "featured": "False",
+      "latest": "True"
+    },
+    "displayDate": true
+  },
+  {
+    "path": "mistral/connectors/02-build-a-quickstart-generator.ipynb",
+    "labels": {
+      "integrations": [],
+      "useCases": [
+        "Connectors",
+        "Agents"
+      ]
+    },
+    "availableInDocs": {
+      "page": true,
+      "displayed": true
+    },
+    "title": "Build a Quickstart Generator with Connectors and Web Search",
+    "mainSection": {
+      "featured": "False",
+      "latest": "True"
+    },
+    "displayDate": true
+  },
   {
     "path": "mistral/connectors/02-connectors-in-conversations-and-agents.md",
     "labels": {

route-utils.ts

@@ -127,8 +127,19 @@ function collectModelCardRoutes(): string[] {
   walkFiles(modelFilesRoot, filePath => {
     if (!filePath.endsWith(".ts") || filePath.endsWith(`${path.sep}index.ts`)) return;
     const source = fs.readFileSync(filePath, "utf8");
-    const match = source.match(/\bslug:\s*['"]([^'"]+)['"]/);
-    if (match?.[1]) addRoute(routes, `/models/${match[1]}`);
+    const slugMatch = source.match(/\bslug:\s*['"]([^'"]+)['"]/);
+    const aliasMatch = source.match(/\bslugAliases:\s*\[([^\]]*)\]/);
+    const apiNamesMatch = source.match(/\bapiNames:\s*\[([^\]]*)\]/);
+    const aliases = aliasMatch?.[1]?.match(/['"]([^'"]+)['"]/g)
+      ?.map(alias => alias.slice(1, -1)) ?? [];
+    const latestApiNames = apiNamesMatch?.[1]?.match(/['"]([^'"]+-latest)['"]/g)
+      ?.map(alias => alias.slice(1, -1)) ?? [];
+
+    for (const slug of [slugMatch?.[1], ...aliases, ...latestApiNames]) {
+      if (!slug) continue;
+      addRoute(routes, `/models/${slug}`);
+      addRoute(routes, `/models/model-cards/${slug}`);
+    }
   });
   return Array.from(routes);
 }

src/app/[locale]/(docs)/model-card/[slug]/model-page.tsx

@@ -1,6 +1,7 @@
 import { Metadata } from 'next';
 import { notFound } from 'next/navigation';
-import { models, findModelBySlug, getModelLicenses, isLegacyModel, Model } from '@/schema';
+import { permanentRedirect } from '@/i18n/navigation.server';
+import { models, findModelBySlug, findModelBySlugAlias, getModelLicenses, getModelSlugAliases, isLegacyModel, Model } from '@/schema';
 import { ThunderIcon, LampIcon, FlagIcon } from '@/components/icons/pixel';
 import { AVATAR_ICONS, getModelIconFallback } from '@/lib/icons';
 import { getModelColorFallback, MODEL_COLORS } from '@/lib/colors';
@@ -46,9 +47,10 @@ interface ModelPageProps {
 
 // Generate static params for all models
 export async function generateStaticParams() {
-  return models.map(model => ({
-    slug: model.slug,
-  }));
+  return models.flatMap(model => [
+    model.slug,
+    ...getModelSlugAliases(model),
+  ].map(slug => ({ slug })));
 }
 
 export const dynamicParams = true;
@@ -59,7 +61,7 @@ export async function generateMetadata({
 }: ModelPageProps): Promise<Metadata> {
   const { locale, slug } = (await params) as { locale: Locale; slug: string };
   const l = await getLingo(locale);
-  const model = findModelBySlug(slug);
+  const model = findModelBySlug(slug) ?? findModelBySlugAlias(slug);
 
   if (!model) {
     return {
@@ -143,12 +145,17 @@ const MAX_API_NAMES = 1;
 export default async function ModelPage({ params }: ModelPageProps) {
   const { locale, slug } = (await params) as { locale: Locale; slug: string };
   const l = await getLingo(locale);
-  const model = findModelBySlug(slug);
+  const aliasModel = findModelBySlugAlias(slug);
+  const model = aliasModel ?? findModelBySlug(slug);
 
   if (!model) {
     notFound();
   }
 
+  if (aliasModel) {
+    permanentRedirect(`/models/${aliasModel.slug}`, locale);
+  }
+
   const { description } = model.describe(l);
   const showRatings = !model.hideRatings;
   const speed = showRatings ? speedRating(model.ratings.speed, l) : null;

src/app/[locale]/(docs)/models/model-cards/[slug]/page.tsx

@@ -1,4 +1,5 @@
 import { permanentRedirect } from '@/i18n/navigation.server';
+import { findModelBySlugAlias } from '@/schema';
 import type { Locale } from '@/i18n/config';
 
 export {
@@ -13,5 +14,6 @@ export default async function OldModelCardPage({
   params: Promise<{ locale: string; slug: string }>;
 }) {
   const { locale, slug } = (await params) as { locale: Locale; slug: string };
-  permanentRedirect(`/models/${slug}`, locale);
+  const aliasModel = findModelBySlugAlias(slug);
+  permanentRedirect(`/models/${aliasModel?.slug ?? slug}`, locale);
 }

src/content/en/docs/studio/connectors/management/page.mdx

@@ -117,6 +117,56 @@ The `create` endpoint also accepts these optional fields:
 
 <SectionTab as="h1" sectionId="get-auth-url">Authenticate a Connector</SectionTab>
 
+When a Connector is first created, an authentication call is required to connect even without credentials.
+
+To connect when credentials aren't needed, pass empty credentials:
+
+<Tabs groupId="code">
+  <TabItem value="python" label="python" default>
+
+```python
+import asyncio
+from mistralai.client import Mistral
+
+client = Mistral(api_key="your-api-key")
+
+
+async def main() -> None:
+  await client.beta.connectors.create_or_update_user_credentials_async(
+      connector_id_or_name="connector-name",
+      name=f"credential-name",
+      credentials={'headers':{}},
+      is_default=True,
+  )
+
+asyncio.run(main())
+```
+
+  </TabItem>
+  <TabItem value="typescript" label="typescript">
+
+```typescript
+import { Mistral } from "@mistralai/mistralai";
+
+const client = new Mistral({ apiKey: "your-api-key" });
+
+async function main(): Promise<void> {
+  await client.beta.connectors.createOrUpdateUserCredentials({
+    connectorIdOrName: "connector-name",
+    credentialsCreateOrUpdate: {
+      name: "credential-name",
+      credentials: { headers: {} },
+      isDefault: true,
+    },
+  });
+}
+
+main();
+```
+
+  </TabItem>
+</Tabs>
+
 If the MCP server requires OAuth, retrieve the authorization URL and redirect the user so they can grant access. After the user completes the auth flow, they are redirected to `app_return_url`.
 
 :::caution