By name: knowledge-searching description: >- Nutrition science Q&A — facts, definitions, recommendations. MANDATORY for any factual nutrition question. Triggers: "c'est quoi / what is", "is it good to / est-ce bon de", "combien de protéines / how much protein", "macros", "déficit / deficit", "suppléments / supplements", "régimes / diet", "BMR / TDEE", "explique / explain a nutrition concept". NOT for recipe generation or meal planning (use meal-planning) or food logging (use food-tracking). Always call retrieve_relevant_documents BEFORE answering.
Knowledge Searching - Recherche Documentaire
Quand utiliser
- L'utilisateur pose une question sur la nutrition, les macronutriments, les supplements, les regimes
- L'utilisateur demande des recommandations basees sur la science
- Tu as besoin de verifier une information nutritionnelle
Workflow OBLIGATOIRE
- TOUJOURS appeler
retrieve_relevant_documentsEN PREMIER avec la question de l'utilisateur - Si les documents ne repondent pas a la question, utilise
web_search - Base ta reponse sur les documents recuperes et cite les sources (ISSN, AND, EFSA, WHO)
- Explique le raisonnement scientifique en referencant les etudes
- Ne te fie JAMAIS uniquement a tes connaissances internes - verifie toujours avec le RAG
Decision RAG vs Web Search
| Situation | Outil | Raison |
|---|---|---|
| Question sur proteines, macros, BMR | retrieve_relevant_documents |
Base de connaissances validee |
| Question sur supplement specifique | retrieve_relevant_documents d'abord, puis web_search |
Completer si necessaire |
| Actualite nutritionnelle recente | web_search |
Informations post-2024 |
| Question medicale specifique | Aucun - recommande un medecin | Hors competence |
Exécution
# RAG — base de connaissances nutritionnelles
run_skill_script("knowledge-searching", "retrieve_relevant_documents", {
"user_query": "protein requirements muscle gain"
})
# Web search — informations récentes
run_skill_script("knowledge-searching", "web_search", {
"query": "omega-3 recommendations 2025 ISSN guidelines"
})
Scripts disponibles :
scripts/retrieve_relevant_documents.py: Embedding query → pgvector similarity search → top 4scripts/web_search.py: Brave API / SearXNG → parse results → top 5 formatted
MealCard — quand tu suggères une recette
Si ta réponse inclut une recette concrète (ingrédients + instructions), émets un marqueur MealCard à la fin, comme pour le skill meal-planning. Sans ce marqueur, la recette n'est pas sauvegardable par l'utilisateur.
<!--UI:MealCard:{"meal_type":"dejeuner","recipe_name":"Nom de la recette","calories":600,"macros":{"protein_g":45,"carbs_g":60,"fat_g":18},"ingredients":["..."],"instructions":"..."}-->