> ## Documentation Index > Fetch the complete documentation index at: https://docs.famulor.io/llms.txt > Use this file to discover all available pages before exploring further. # Famulor Skill > Installez le skill open source pour les prompts vocaux, WhatsApp, le chat web, l’e-mail et les workflows **Famulor Skill** guide votre client IA dans la conception d’assistants et l’utilisation de Famulor. Il comprend des modèles de prompts, des conseils par canal, des scénarios de test et des références pour l’API publique, MCP, la CLI et le SDK TypeScript. [Voir le dépôt](https://github.com/bekservice/Famulor-Skill) · [Télécharger la dernière version](https://github.com/bekservice/Famulor-Skill/releases/latest) · [Guide d’installation détaillé](https://github.com/bekservice/Famulor-Skill/blob/main/docs/installation.md) > [!NOTE] > > Le **skill fournit les instructions**. Une **connexion MCP donne un accès autorisé à votre espace**. Installer le skill ne connecte pas automatiquement votre compte et n’élargit pas les droits d’une connexion existante. Vous pouvez rédiger des prompts sans connexion ; la lecture ou la modification des données de l’espace en nécessite une. ## Choisir votre point de départ | Vous souhaitez… | Commencez par | | - | - | | Créer un assistant d’accueil vocal ou de réservation | [Conception d’assistants et modèles vocaux](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/assistant-design.md) | | Adapter un assistant à WhatsApp, au chat web ou à l’e-mail | [Guide des canaux et exemples de prompts](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/messaging-and-channels.md) | | Améliorer la qualité des conversations | [Tests et évaluation](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/testing-and-evaluation.md) | | Trouver un endpoint, une commande CLI ou une méthode SDK | [Guide API et SDK](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/api-and-sdk.md) | | Préparer campagnes, connaissances ou automatisations | [Exemples de workflows](https://github.com/bekservice/Famulor-Skill/blob/main/docs/use-cases.md) et [cas d’usage MCP](/fr/mcp/use-cases) | ## Apprendre avec des exemples complets La [bibliothèque d’exemples](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/examples/README.md) présente des conceptions complètes d’assistants inspirées des [démos publiques Famulor](https://app.famulor.io/demo). | Exemple | Ce qu’il montre | | - | - | | [Réception d’hôtel](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/examples/hotel-front-desk.md) | Accueil, connaissances de l’hôtel, disponibilités réelles, confirmation et gestion des erreurs | | [Service au volant](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/examples/drive-thru.md) | Corriger le panier, vérifier le devis et soumettre une seule commande | | [Suivi des commandes](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/examples/order-support.md) | Règles communes avec adaptations pour la voix, WhatsApp, le chat web et l’e-mail | | [Qualification de prospects](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/examples/lead-qualification.md) | Questions utiles, prochaine étape pertinente et respect du refus de contact | Chaque exemple contient un brief rempli, un prompt complet, les réglages correspondants, les outils d’exécution nécessaires, une conversation illustrative et des critères de validation. Le [modèle de livrable](https://github.com/bekservice/Famulor-Skill/blob/main/skills/famulor-skill/references/examples/assistant-deliverable.md) montre comment présenter la proposition finale et son état de vérification. Les entreprises et les résultats sont fictifs : un jeu de rôle dans une démo ne prouve pas qu’une réservation ou une commande a eu lieu. Connectez les outils réels et vérifiez leurs résultats avant de l’affirmer aux clients. Les exemples complets du dépôt sont en anglais. ## Installation Pour les agents de code compatibles avec Agent Skills : ```bash theme={null} npx skills add bekservice/Famulor-Skill --skill famulor-skill ``` Choisissez votre client dans l’installateur. L’installation s’effectue dans le projet courant par défaut ; ajoutez `-g` pour une installation globale. Examinez le paquet avant de l’installer. Pour agir dans votre espace, ajoutez une connexion MCP distante **Streamable HTTP** et authentifiez-vous via OAuth : ```text theme={null} https://app.famulor.io/mcp ``` Pour un espace en marque blanche, utilisez le domaine indiqué dans **Settings → API & MCP**. Votre forfait doit inclure **Connect AI / MCP**, et votre rôle ainsi que les autorisations approuvées doivent permettre l’action. Une URL ciblée comme `https://app.famulor.io/mcp?toolsets=assistants,calls` réduit les outils proposés sans accorder de droits supplémentaires. **Claude Code** Installez le plugin complet depuis la marketplace du dépôt : ```text theme={null} /plugin marketplace add bekservice/Famulor-Skill /plugin install famulor@famulor ``` Ouvrez `/mcp` et authentifiez Famulor. Ce paquet contient le skill et la configuration MCP. Si vous avez installé seulement le skill avec `npx skills`, ajoutez la connexion séparément : ```bash theme={null} claude mcp add --transport http famulor https://app.famulor.io/mcp ``` **Claude web et bureau** 1. Téléchargez **`famulor-skill.zip`** depuis la [dernière version](https://github.com/bekservice/Famulor-Skill/releases/latest). 2. Ouvrez **Customize → Skills → + → Create skill → Upload a skill** et importez ce ZIP. N’utilisez pas le ZIP du dépôt entier. 3. Activez le skill. Votre compte ou organisation doit autoriser les skills et l’exécution de code. 4. Connectez Famulor sous **Customize → Connectors**. Utilisez un connecteur personnalisé avec l’URL MCP pour les outils nécessaires. 5. Démarrez une nouvelle conversation et demandez à Claude d’utiliser Famulor Skill. Le [connecteur d’annuaire Famulor Assistants & History](https://claude.ai/directory/famulor-assistants-history) donne un accès en lecture seule. Il ne peut ni enregistrer des prompts ni envoyer des messages. Si votre interface diffère, consultez le [guide d’importation de skills de Claude](https://support.claude.com/en/articles/12512180-use-skills-in-claude). **ChatGPT** Installez le [plugin officiel Famulor](https://chatgpt.com/plugins/plugin_asdk_app_6a8a46791ed08191a79aa4c98f34d772), connectez votre compte et sélectionnez **@Famulor** dans une conversation. Cette fiche propose **11 outils en lecture seule** pour examiner les assistants et l’historique. Pour un domaine personnalisé ou des outils autorisés supplémentaires, ouvrez **ChatGPT Plugins → + → Add custom MCP server** sur le web. Saisissez l’URL MCP, choisissez **OAuth**, vérifiez la connexion et créez-la comme plugin. Connectez-vous, choisissez votre espace et approuvez les accès nécessaires. Installez ensuite le plugin créé et sélectionnez-le avec **@**. Installer un skill localement ne configure pas ChatGPT web. Le plugin officiel n’inclut pas non plus automatiquement cette version du skill GitHub. Pour rédiger un prompt, fournissez le modèle adapté et vos besoins dans la conversation. Les règles de votre compte ou organisation peuvent limiter les connexions personnalisées ; consultez le [guide MCP actuel d’OpenAI](https://developers.openai.com/api/docs/guides/custom-mcp-server). **Codex** Après l’installation du skill, configurez et vérifiez MCP : ```bash theme={null} codex mcp add famulor --url https://app.famulor.io/mcp codex mcp login famulor codex mcp get famulor ``` Redémarrez la session et demandez à Codex d’utiliser `$famulor-skill`. Dans les clients IDE, vous pouvez aussi ajouter la connexion sous **MCP servers → Add server → Streamable HTTP**. **Cursor** Choisissez Cursor dans l’installateur du skill. Ajoutez l’URL distante dans les paramètres MCP de Cursor, ou utilisez cette configuration de projet dans `.cursor/mcp.json` : ```json theme={null} { "mcpServers": { "famulor": { "url": "https://app.famulor.io/mcp" } } } ``` Authentifiez-vous à l’invite et vérifiez que les outils Famulor sont activés. **Gemini CLI** Installez l’extension qui regroupe le skill et la configuration MCP : ```bash theme={null} gemini extensions install https://github.com/bekservice/Famulor-Skill ``` Vérifiez les capacités demandées. Exécutez `/mcp auth famulor` si une authentification est requise, puis `/extensions list` pour contrôler l’installation. Pour les autres clients compatibles, utilisez l’installateur ou copiez le dossier complet `skills/famulor-skill/`, avec ses références, scripts et modèles. Copier seulement `SKILL.md` omet les guides complémentaires. La version publiée fournit aussi `famulor.skill` pour les importateurs compatibles. ## Vérifier avec une demande en lecture seule > Utilise Famulor pour lister mes assistants. Indique quel espace est connecté. Ne modifie rien. Essayez ensuite une analyse ciblée : > Avec Famulor Skill, examine mon assistant de support pour le chat texte du site. Propose un prompt amélioré et trois conversations de test. N’enregistre et n’envoie rien. Un paquet téléchargé ou une autorisation OAuth terminée ne prouve pas qu’un outil a fonctionné. Vérifiez que le client retourne de vraies données du bon espace. Une connexion en lecture seule permet l’analyse et les brouillons ; enregistrer des modifications exige les droits d’écriture correspondants. ## Adapter les prompts à chaque canal Conservez les règles métier, les sources fiables et les conditions d’action dans le prompt système partagé. Utilisez **Additional channel instructions** pour le ton, la longueur et la présentation lorsque les réponses manuelles par canal sont incluses dans votre forfait. * **Voix :** réponses parlées courtes, une question claire, un accueil adapté et de véritables outils de transfert ou de réservation. * **WhatsApp :** messages compacts, reprise humaine, fenêtre de service actuelle et modèles approuvés pour les prises de contact autorisées qui l’exigent. * **Chat web :** liens lisibles, contexte du formulaire préalable, réponses écrites utiles et test du widget réel. * **E-mail :** corps de message complet, bon fil de discussion et signature appropriée, avec une distinction claire entre brouillon et réponse envoyée. Un prompt ne peut pas connecter un calendrier, créer un outil, accorder des droits ou prouver une livraison. Le skill guide le client pour vérifier la configuration, résoudre les identifiants réels, utiliser les actions prises en charge et contrôler le résultat. Commencez par les [exemples de demandes](https://github.com/bekservice/Famulor-Skill/blob/main/docs/use-cases.md), puis testez le canal réellement utilisé par vos clients. ## Mise à jour et dépannage Pour un skill géré par l’installateur, exécutez `npx skills check`, puis `npx skills update`. Pour un skill importé manuellement dans Claude, importez le ZIP de la dernière version. L’autorisation MCP reste distincte ; supprimer les fichiers locaux ne révoque pas nécessairement l’accès OAuth. | Symptôme | Étape suivante | | - | - | | Skill installé, mais aucun outil | Ajoutez la connexion MCP, authentifiez-vous et redémarrez la session du client. | | Seulement 11 outils en lecture seule | Vous utilisez le profil d’annuaire. Une connexion personnalisée autorisée séparément est nécessaire pour davantage d’actions. | | Impossible d’enregistrer un assistant | Vérifiez l’espace, le rôle, les autorisations approuvées et le forfait. | | Une écriture a expiré | Lisez l’état actuel avant de réessayer ; la première action peut avoir abouti. | | Les commandes d’installation diffèrent | Consultez le [guide d’installation maintenu](https://github.com/bekservice/Famulor-Skill/blob/main/docs/installation.md) et la documentation officielle de votre client. | Signalez les problèmes reproductibles de skill ou de documentation dans les [issues du dépôt](https://github.com/bekservice/Famulor-Skill/issues). Retirez les données clients et les identifiants d’accès des exemples. Pour une question liée à votre compte, contactez le [support Famulor](/fr/support). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.