CONFIGURATION DES AGENTS

Configurer et exécuter un playbook

Comment configurer un playbook et l'exécuter maintenant ?

Un playbook est une routine reproductible que votre agent peut exécuter à la demande ou selon un calendrier. Ouvrez Sydekick → Agent → Playbooks pour voir ce que vous avez, ce qui est actif, ce qui s'exécute cette semaine et ce qui est un brouillon. Tout ce que vous demandez chaque semaine à Sydekick a sa place ici à la place.

La page Playbooks avec une bande hebdomadaire montrant ce qui s'exécute chaque jour, les filtres All, Active, Paused et Custom, et des cartes pour les playbooks intégrés et personnalisés

Regarder: Configurer et exécuter un playbook

Points clés

Où le trouverSydekick → Agent → Playbooks (l'agent a son propre rail : Home, Playbooks, Capabilities, Audit logs, Memory)
Ce que vous voyezUne bande This week, des filtres (All, Active, Paused, Custom) et une carte par playbook, triée par prochaine exécution
Intégrés et personnalisésLes playbooks Built-in sont maintenus par Synup et verrouillés ; les Custom sont les vôtres. Seul un petit ensemble de playbooks intégrés est affiché
Un brouillonEnregistré mais non planifié. Il ne s'exécute jamais seul tant que vous ne sélectionnez pas Activate
Exécuter maintenantLance immédiatement une exécution réelle. Pour un playbook limité à un client, choisissez d'abord le client dans Run for…
CréerCreate a playbook ouvre un processus en cinq étapes : Describe, Plan, Build, Rehearse, Launch
Qui le voitL'accès à la page Playbooks se définit par membre de l'équipe : un membre peut donc ne pas voir du tout cette page

Étapes

  1. Ouvrez Sydekick dans la navigation de gauche, choisissez Agent, puis Playbooks dans le rail latéral de l'agent. Si la page indique que votre agent est encore en cours de configuration, la liste apparaît une fois la configuration terminée.

  2. Lisez la bande This week. Elle montre quels playbooks sont prévus chaque jour, et Month view → l'étend au mois. ← Week view la ramène à la semaine.

  3. Utilisez les filtres ou la zone de recherche pour réduire la liste. Active signifie que le calendrier est activé, Paused que quelqu'un l'a désactivé, Custom que votre équipe l'a créé. Chaque filtre affiche son nombre.

  4. Sélectionnez une carte pour ouvrir le playbook. La page montre ce qu'il fait, les étapes qu'il exécute, quand et pour qui il s'exécute, ses exécutions récentes et son historique.

  5. Pour essayer un playbook une fois, choisissez un client dans Run for… et sélectionnez Run now. Pour le placer sur son calendrier, activez-le ou sélectionnez Activate.

Lire une carte

Tout ce dont vous avez besoin pour évaluer un playbook d'un coup d'œil se trouve sur la carte.

  • Les badges en haut à droite indiquent son origine et s'il est actif : Built-in (avec un cadenas) pour ceux de Synup, Custom pour les vôtres, Draft pour un playbook enregistré mais jamais activé, Paused pour un playbook désactivé.
  • Les pastilles en bas indiquent son comportement. La première est le calendrier, par exemple ⏰ Mondays 9:00 AM, ou ⚡ On demand s'il n'y en a pas. Vient ensuite le périmètre : One client, Whole account ou Selected clients, avec le nombre de clients et d'établissements lorsqu'ils sont connus. Une pastille violette telle que runs local post ideas nomme la compétence utilisée.
  • La dernière exécution apparaît sous forme de petite pastille de résultat une fois que le playbook s'est exécuté. Une exécution terminée affiche ✓ avec le nombre d'éléments terminés, une exécution partiellement terminée affiche ⚠ partial, une exécution échouée ✕ failed, une exécution en cours ● running et une exécution ignorée — skipped. Considérez une pastille partial ou failed comme le signal d'ouvrir le playbook et son exécution avant de vous y fier de nouveau.

Un brouillon ne s'exécute jamais tout seul

C'est le piège numéro un dans lequel tombent les utilisateurs, le produit le mentionne donc deux fois : sur la carte sous forme de badge Draft, et à nouveau dans une bannière lorsque vous l'ouvrez.

Un playbook en brouillon avec le sélecteur Run for réglé sur un client, Run now et Edit, et une bannière indiquant qu'il ne s'exécutera pas seul tant qu'il n'est pas activé

« Saved, but it won't run on its own yet. Activating starts the schedule; you can still use Run now to try it once. »

Prenez try it once au sens littéral plutôt que figuré. Cela signifie une véritable exécution, pas une répétition.

  • Run now lance le playbook immédiatement au lieu d'attendre son calendrier. Il effectue tout le travail pour le client du sélecteur Run for…, avec de vraies données, un vrai résultat et de vrais crédits, et laisse le calendrier inchangé. Pour un playbook limité à un client, le bouton reste indisponible tant que vous n'avez pas choisi de client, et la page vous demande d'en choisir un d'abord, car l'exécution doit savoir de quelles données se servir.
  • Activate démarre le calendrier. À partir de ce moment, il s'exécute sans vous.

Une fois Run now lancé, une ligne indique Run started for suivi du client, avec des liens pour suivre l'exécution.

Run now peut aussi être refusé. Il ne démarre pas si l'agent n'est pas prêt, si un modèle de rapport que vous avez choisi n'a pas fini d'être enregistré dans le playbook, ou si la vérification des crédits ou de l'essai refuse : l'essai est terminé, le compte est inactif, les crédits de ce cycle de facturation sont épuisés ou les crédits restants sont retenus par des exécutions encore en cours de finalisation. Dans ce dernier cas, le message indique que cela se résout de lui-même en quelques minutes. Voir crédits et utilisation de l'agent.

Run now n'est pas un aperçu. Vérifiez quel client le sélecteur désigne et lisez The flow — what happens each run avant de l'utiliser. Pour voir le résultat sans que rien ne quitte Synup, utilisez Rehearse dans le processus de création, ci-dessous.

Ce qui nécessite votre approbation

Le fait qu'une exécution vous attende dépend de ce que fait le playbook, et la page du playbook vous l'indique.

  • Un playbook susceptible de publier, d'envoyer ou de mettre des brouillons en file d'attente affiche Approval required before anything goes live. Les brouillons qu'il produit attendent votre décision dans Inbox.
  • Un playbook dont les étapes se contentent de lire des données et de produire un rapport affiche Report only — it reads data and makes a report. Nothing is posted, sent or changed. Il n'y a rien à approuver : il n'attend donc pas.
  • Une exécution peut tout de même se mettre en pause en cours de route. Si une vérification automatique détecte un problème dans le résultat d'une étape, la page d'exécution indique Paused et vous renvoie vers Inbox.

L'approbation est une propriété de chaque playbook, et non un interrupteur général sur Sydekick : la désactiver pour un playbook ne dit rien des autres.

Fichiers : modèles de rapport et fichiers de référence

Sur un playbook personnalisé, ouvrez Edit. Le panneau Files dans la colonne de droite permet de téléverser un modèle de rapport qui façonne ce que le playbook produit, ou des fichiers de référence qui décrivent ce que vous souhaitez. Il accepte les fichiers HTML, PDF, texte, Markdown, CSV ou images, jusqu'à 2 Mo chacun.

Le panneau Files d'un playbook personnalisé listant un modèle de rapport prêt marqué Used for report, un fichier marqué Can't be used avec son motif, et un fichier de référence

Chaque fichier affiche un statut. Ready signifie qu'il peut être utilisé comme modèle, et Used for report marque celui à partir duquel le playbook construit son rapport. Can't be used s'accompagne d'un motif clair, par exemple que la mise en page diffère de la version prise en charge par Synup, ou que le fichier nécessite des fichiers annexes qui n'ont pas été inclus. Reference file sert pour tout ce qui n'est pas un modèle. Utilisez les choix Report template et Reference sur un fichier pour indiquer comment il est utilisé. Supprimer un fichier empêche le playbook de l'utiliser, tandis que les versions enregistrées et les exécutions qui l'ont déjà utilisé conservent leur propre copie.

Les playbooks intégrés ne peuvent pas recevoir de fichiers ; le panneau indique de créer plutôt une copie personnalisée. Si vous modifiez le modèle, le playbook doit enregistrer ce choix avant de pouvoir s'exécuter : tant que ce n'est pas fait, les répétitions et les exécutions se mettent en pause avec un message qui l'indique.

En créer un

Create a playbook ouvre le processus en cinq étapes, et l'en-tête précise la partie rassurante avant que vous ne saisissiez quoi que ce soit : nothing is created yet.

Le processus Create a playbook à l'étape Describe, montrant les cinq étapes Describe, Plan, Build, Rehearse et Launch, une zone de description avec des pastilles d'exemples, et des modèles hebdomadaires prêts à l'emploi

  1. Describe la routine comme vous l'expliqueriez à un collègue : ce qui se passe, dans quel ordre, pour qui. La planification vient à la fin : n'essayez donc pas de la préciser d'emblée. Les pastilles sous la zone sont des exemples concrets, et les cartes en dessous sont des routines prêtes à l'emploi, étiquetées SMALL · SAFE TO TRY ou NEEDS SEARCH DATA.
  2. Plan montre ce que Sydekick a compris, et chaque champ peut être modifié à la main. Rien n'est encore créé.
  3. Build transforme le plan en étapes et l'enregistre comme brouillon. Il ne s'exécutera pas seul tant que vous ne le lancerez pas.
  4. Rehearse essaie la routine sur les données réelles du client sans rien publier ni enregistrer. Le processus l'étiquette comme un essai à blanc : rien n'est envoyé ni enregistré, et une répétition n'attend jamais d'approbation. Elle lit tout de même des données en direct et consomme tout de même des crédits : répétez donc sur un client pour lequel un résultat inattendu est sans conséquence.
  5. Launch demande comment il doit s'exécuter : selon un calendrier, ou seulement quand vous le dites.

La répétition d'une étape qui se répète pour plusieurs établissements ou cibles l'exécute pour l'un d'entre eux. Sydekick construit le playbook avec une étape d'IA, ce qui peut prendre environ une minute, et la page indique si le service d'IA n'a pas répondu et que votre plan est sûr.

Suivre une exécution

Sélectionner une exécution, ou View run après Run now, ouvre sa propre page. Elle indique quand l'exécution a commencé et s'est terminée, ce qui l'a déclenchée, son périmètre et ses cibles, les crédits utilisés, le nombre d'éléments signalés, et chaque étape avec son résultat. Une étape affiche Automatic review, ou Not reviewed lorsque cette vérification n'a pas pu s'exécuter. Pour un playbook de rapport, la page propose aussi d'ouvrir ou de télécharger le rapport terminé.

Ce que vous verrez une fois terminé

  • Le playbook sur la page Playbooks, avec les bons badges, la pastille de calendrier et le périmètre
  • Pour un brouillon : la bannière Draft jusqu'à ce que vous sélectionniez Activate
  • Après Run now : Run started for suivi du client que vous avez choisi, et l'exécution dans Recent runs
  • Pour un playbook personnalisé avec un modèle : le fichier marqué Ready et Used for report dans Files

Points d’attention

Run now est réel. Il exécute tout le travail pour le client du sélecteur. Choisissez le client délibérément, car le sélecteur démarre vide, sauf si le playbook est déjà planifié pour un client.
La suppression emporte l'historique avec elle. La confirmation indique : « Its schedule and run history go with it. Drafts already waiting in the Inbox stay there. This can't be undone. » Seuls les playbooks personnalisés peuvent être supprimés. Mettez-le plutôt en pause si vous pensez en avoir de nouveau besoin.
  • Les playbooks intégrés sont figés. Seuls leur calendrier et le client qu'ils ciblent changent ; le travail lui-même n'est pas modifiable. Si vous avez besoin d'une routine différente, créez-en une personnalisée.
  • Un playbook n'est ni un sweep ni un plan. Un playbook est une routine que vous créez et exécutez depuis cette page. Un sweep est une vérification récurrente que Sydekick met en place à partir d'une conversation, et un plan est une campagne plus longue. Aucun des deux n'est créé ici.

Questions fréquentes

Pourquoi le filtre indique-t-il Active 3 alors que rien ne s'est exécuté aujourd'hui ?

Active signifie que le calendrier est activé, pas que l'exécution est prévue aujourd'hui. Utilisez la bande This week pour voir ce qui s'exécute réellement chaque jour.

Un seul playbook peut-il couvrir tous mes clients à la fois ?

Un playbook a un périmètre. Les playbooks Whole account n'ont pas besoin de client. Ceux en Selected clients s'exécutent pour les clients choisis dans le calendrier. Un playbook One client s'exécute sur un client par exécution : pour en couvrir plusieurs, il faut donc choisir un client à chaque fois, ou le planifier pour chacun.

Quelle est la différence entre Run now et Rehearse ?

Run now est une exécution réelle avec un vrai résultat et, lorsque le playbook peut publier ou envoyer, des brouillons qui attendent dans Inbox. Rehearse est un essai à blanc dans le processus de création : il utilise les données réelles du client mais ne publie ni n'enregistre rien. Les deux consomment des crédits.

Sydekick peut-il exécuter un playbook pour moi ?

Oui. Sydekick peut lister, expliquer, répéter, exécuter et planifier des playbooks lorsque vous le demandez dans le chat. Consultez ensuite la page du playbook pour le calendrier et le statut réels.

Un playbook continue-t-il de s'exécuter si je n'ai plus de crédits ?

Non. Lorsque les crédits du cycle de facturation sont épuisés, ou que l'essai est terminé, les exécutions sont refusées jusqu'à la réinitialisation des crédits ou jusqu'à ce que vous passiez à une offre supérieure. Voir crédits et utilisation de l'agent.

Suivant

Découvrez l'agent en action

Commencez votre essai gratuit. Annulez à tout moment.