Skip to content

Conversation

@ArthurJCQ
Copy link
Member

No description provided.

@github-actions
Copy link
Contributor

github-actions bot commented Oct 9, 2025

Images automagically compressed by Calibre's image-actions

Compression reduced images by 7.4%, saving 13.2 KB.

Filename Before After Improvement Visual comparison
_assets/tutorials/2025-10-29-mastra-ai-rag/rag-schema.png 178.6 KB 165.4 KB 7.4% View diff

1 image did not require optimisation.

@github-actions github-actions bot temporarily deployed to feat/add-tutorial-mastra-ai-rag October 9, 2025 16:03 Destroyed
@github-actions
Copy link
Contributor

github-actions bot commented Oct 9, 2025

⚡️🏠 Lighthouse report

Here's the summary:

Path Performance Accessibility Best practices SEO PWA
/feat/add-tutorial-mastra-ai-rag/ 🟠 85 🟠 88 🟢 96 🟢 92 🔴 NaN
/feat/add-tutorial-mastra-ai-rag/fr/authors/ajacquemin/ 🟠 75 🟠 88 🟢 96 🟢 91 🔴 NaN
/feat/add-tutorial-mastra-ai-rag/fr/comment-construire-site-web-avec-nextjs/ 🟢 93 🟠 80 🟢 96 🟢 100 🔴 NaN
/feat/add-tutorial-mastra-ai-rag/fr/nestjs-le-cycle-de-vie-dune-requete/ 🟠 71 🟠 80 🟢 96 🟢 100 🔴 NaN

Here's the audits:

Path FCP
1800 <=
LCP
2500 <=
Speed Index
3400 <=
TTI
3800 <=
TBT
200 <=
CLS
0.1 <=
/feat/add-tutorial-mastra-ai-rag/ 🔴 1972 🟢 1972 🟢 1972 🔴 5207 🟢 15 🟢 0
/feat/add-tutorial-mastra-ai-rag/fr/authors/ajacquemin/ 🔴 2002 🔴 6677 🟢 2002 🔴 6677 🟢 34 🟢 0.04
/feat/add-tutorial-mastra-ai-rag/fr/comment-construire-site-web-avec-nextjs/ 🔴 2521 🔴 2596 🟢 2521 🔴 5441 🟢 17 🟢 0.02
/feat/add-tutorial-mastra-ai-rag/fr/nestjs-le-cycle-de-vie-dune-requete/ 🔴 2270 🔴 3523 🟢 2330 🔴 5389 🟢 25 🟢 0.1

@ArthurJCQ ArthurJCQ marked this pull request as draft October 9, 2025 16:13
En l'occurence, nous nous servirons de certaines APIs de Mastra pour nous aider à faire du **RAG** (*Retrieval-Augmented Generation*). Si vous ne savez pas en quoi cela consiste, nous allon y venir dans la prochaine partie !

Mais tout d'abord, qu'allons-nous faire exactement ? Notre cas d'usage est très simple, prenons le Blog d'Eleven Labs, sur lequel nous nous trouvons actuellement.
Nous aimerions rendre la recherche d'article plus intelligent et plus pertinente. Quand un utilisateur fait une recherche, que ce soit par mot-clé, par problème renontré ou même sous la forme d'une simple question, il faudrait que le Blog réponde par une liste des articles et tutoriels les plus pertinents, et avec des petits résumés personnalisés expliquant en quoi chaque article correspond au problème de l'utilisateur.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Faute de frappe : Par problème rencontré
Tu peux aussi ajouter que l'on pourrait utiliser la partie recherche vectoriel pour remonter les articles similaires, ce n'est pas du RAG car il n'y a pas d'agent mais on utilise une partie du concept pour un autre besoin. Cela pourrait être un workflow pour remonter les articles similaires


Pareil ici, on n'aura pas à implémenter ces calculs nous-même. Mastra AI nous fournit toutes les APIs nécessaires pour transformer nos documents en vecteurs, les stocker en base, puis récupérer les vecteurs pertinents en fonction d'une requête.

![Et voici un petit schéma récapitulatif de ce que nous venons de voir]({BASE_URL}/imgs/tutorials/2025-10-29-mastra-ai-rag/rag-schema.png)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Il manque peut-être juste un petit picto user au niveau de la question
Et peut-être une information pour dire que c'est un workflow sur la partie documents qui se trouve en dessous

title: Introduction
---

## Qu'allons-nous faire ?
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Peut-être ajouter une introduction à mastra un peu avant, d'où il sort, ce sur quoi il se base comme l'outil ai sdk de vercel qui fait partie de son socle principale et ces possibilités


Intégrer des modèles d'IA (LLMs, embeddings, ...) à notre application peut-être compliqué car chacun de ces modèles peut se configurer de manière différente, et cela devient donc compliquer si l'on veut en changer ou simplement en tester plusieurs pour faire un benchmark du meilleur modèle pour nos besoins.

C'est là qu'intervient la librairie [**OpenRouter**](https://openrouter.ai/). Elle nous permet de standardiser l'intégration de nos modèles d'IA à nos applications, quelque soit le provider de ces modèles.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Il faut spécifier que open router applique les conventions et standardisation d'open ai sur l'ensemble des providers

@github-actions
Copy link
Contributor

Images automagically compressed by Calibre's image-actions

Compression reduced images by 44.4%, saving 184.8 KB.

Filename Before After Improvement Visual comparison
_assets/tutorials/2025-10-29-mastra-ai-rag/agent-playground.png 184.5 KB 58.7 KB 68.2% View diff
_assets/tutorials/2025-10-29-mastra-ai-rag/mastra-playground.png 66.4 KB 17.9 KB 73.0% View diff
_assets/tutorials/2025-10-29-mastra-ai-rag/rag-schema.png 165.4 KB 154.7 KB 6.5% View diff

1 image did not require optimisation.

@ArthurJCQ ArthurJCQ force-pushed the feat/add-tutorial-mastra-ai-rag branch from 089a5dd to 02b0240 Compare October 10, 2025 16:02
@github-actions
Copy link
Contributor

Images automagically compressed by Calibre's image-actions

Compression reduced images by 44.4%, saving 184.8 KB.

Filename Before After Improvement Visual comparison
_assets/tutorials/2025-10-29-mastra-ai-rag/agent-playground.png 184.5 KB 58.7 KB 68.2% View diff
_assets/tutorials/2025-10-29-mastra-ai-rag/mastra-playground.png 66.4 KB 17.9 KB 73.0% View diff
_assets/tutorials/2025-10-29-mastra-ai-rag/rag-schema.png 165.4 KB 154.7 KB 6.5% View diff

1 image did not require optimisation.

@github-actions
Copy link
Contributor

Images automagically compressed by Calibre's image-actions

Compression reduced images by 10%, saving 21.3 KB.

Filename Before After Improvement Visual comparison
_assets/tutorials/2025-10-29-mastra-ai-rag/rag-schema.png 154.7 KB 137.8 KB 10.9% View diff
_assets/tutorials/2025-10-29-mastra-ai-rag/agent-playground.png 58.7 KB 54.4 KB 7.5% View diff

2 images did not require optimisation.

@github-actions github-actions bot temporarily deployed to feat/add-tutorial-mastra-ai-rag October 10, 2025 16:05 Destroyed
@fpasquet
Copy link
Contributor

fpasquet commented Nov 2, 2025

Il manque une chose hyper importante dans le tutoriel, c'est la partie chunking.
Il faudrait parler des différentes stratégies qui existe sur mastra et montrer et expliquer pourquoi on a utilisé le markdown.
Il faut aussi aborder le maxSize et overlap qui sont des points indispensables pour le RAG.

@fpasquet
Copy link
Contributor

fpasquet commented Nov 2, 2025

On ne parle pas non plus de la notion de dimension d'un model embedding qui est techniquement très important.

@fpasquet
Copy link
Contributor

fpasquet commented Nov 2, 2025

Il faut aussi aborder le topk et les filters lors de la recherche vectorielle

@fpasquet
Copy link
Contributor

fpasquet commented Nov 2, 2025

Mentionner le reranking et graph qui sont les solutions avancées pour le RAG en conclusion.

@fpasquet
Copy link
Contributor

fpasquet commented Nov 2, 2025

Citer l'ensemble des vector databases prise en charge par mastra car c'est son point fort par rapport aux concurrents

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants