Conseils & meilleures pratiques

Faites une ré-indexation complète si vous avez :

• modifié massivement la structure du repo (renommages, suppression/imports),
• changé la méthode d’embeddings ou le pipeline d’indexation,
• ou si vous suspectez des incohérences dans l’index. Action réelle : Ouvrez le repository dans l’interface et cliquez sur “RAG sync”. Le backend récupère les commits et met à jour l’index.

Pour le flux normal, activez la ré-indexation incrémentale : le webhook Git déclenche updateFileIndexAndMilvus sur push. Cela met à jour FileIndex et Milvus seulement pour les fichiers modifiés—plus rapide et moins coûteux.

Si vous gérez des corrections quotidiennes (typos, petites améliorations), laissez les webhooks déclencher updateFileIndexAndMilvus. Si vous migrez de Markdown à un autre format ou changez les embeddings, lancez un “RAG sync” complet.

Ouvrez Dialogue → Agents → Templates. Sélectionnez par exemple “SEO Article Generator” puis cliquez sur “Use template” pour créer une copie.

Dans l’éditeur d’agent, modifiez les steps JSON si besoin (titre, prompts, données d’entrée). Vous pouvez dupliquer un agent via “Duplicate” pour tester sans perdre l’original.

Pour chaque agent, choisissez le modèle LLM approprié dans le champ modèle :

• tâches rédactionnelles (SEO) : modèles orientés génération avec meilleur style,
• extraction/QA : modèles plus rapides et précis sur les faits. Testez le rendu en exécutant l’agent manuellement avant de l’automatiser.

Lancez l’agent depuis l’interface pour voir la sortie. Ajustez le prompt/modèle jusqu’à obtenir le résultat attendu, puis associez l’agent à un hook si besoin.

Dans Agents, ouvrez l’agent → “Associate Hook” → choisissez un Hook (webhook ou endpoint interne). Les hooks peuvent déclencher l’agent automatiquement (par ex. à chaque merge).

Si votre interface propose un scheduler pour hooks, créez un hook programmé (ex. tous les lundis) qui lance l’agent de publication ou génération. Sinon, utilisez un service externe pour appeler l’endpoint d’exécution de l’agent à intervalle régulier.

Exécutez le hook manuellement pour vérifier le flux complet : génération (agent) -> indexation (si nécessaire) -> publication.

Avant d’activer la publication automatique, lancez l’agent depuis l’interface pour générer le contenu.

Relisez la sortie et assurez-vous que les liens, le branding et les métadonnées sont corrects. Corrigez le prompt ou le template si besoin.

Répétez jusqu’à satisfaction, puis associez le hook/programmez la release.

Lors de la création d’un webhook, DeployIt génère un webhookSecret si nécessaire. Toujours utiliser ce secret pour vérifier la signature côté récepteur.

Si votre endpoint peut être temporairement indisponible, utilisez un mécanisme de retries avec backoff exponentiel (p.ex. 3 tentatives, 2s → 8s → 32s). Si l’interface propose ces réglages, ajustez-les dans la config du webhook.

Utilisez checkWebhook pour vérifier qu’un webhook existe côté provider et inspectez les logs d’échec pour ajuster les retries.

Aller à Paramètres → Site.

Saisissez l’URL publique que vous voulez utiliser comme référence, puis cliquez sur “Scrape”. L’outil récupère logo, couleurs et métadonnées pour pré-remplir le formulaire.

Ajustez les champs (title, colors, footer_links) puis sauvegardez. Le site utilisera ces variables et les tokens CSS dans src/assets/css/tailwind.css et tailwind.config.js pour le theming.

Ne copiez jamais tokens ou webhookSecret dans des canaux non sécurisés (chat, email public).

Lors de la création d’un webhook, laissez la plateforme générer le webhookSecret (DeployIt le fait automatiquement si nécessaire). Vérifiez la signature côté récepteur.

Quand un repo ou un projet est supprimé, la plateforme supprime aussi le webhook côté provider. Si vous retirez un service, supprimez ses webhooks et révoquez ses tokens.

Exécutez périodiquement checkWebhook pour confirmer la présence et validité des webhooks côté provider.