> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piperai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Créer des Piper Agents : Schedule, Scope, Brain et outils

> Configurez votre Piper Agent en quatre étapes : définissez un calendrier, délimitez le périmètre, rédigez les instructions et choisissez les outils accessibles à votre agent.

Créer un Piper Agent ne prend que quelques minutes. Vous parcourez quatre étapes de configuration — Schedule, Scope, Brain et Capabilities — et l'agent commence à s'exécuter automatiquement selon la cadence que vous définissez. L'étape la plus déterminante est la rédaction d'instructions claires et précises dans la section Brain, qui conditionne la qualité de tout ce que l'agent produit.

<Steps>
  <Step title="Schedule — quand travaille-t-il ?">
    Définissez la fréquence d'exécution de votre agent. Vous pouvez le déclencher selon une cadence récurrente ou après des événements spécifiques.

    Les options de planification courantes incluent :

    * **After every call** — idéal pour un coaching en temps réel ou des résumés post-appel immédiats
    * **Daily** — adapté au suivi du pipeline ou aux synthèses nocturnes
    * **Weekly** — idéal pour les rapports consolidés, les aperçus de sentiment ou les revues au niveau de l'équipe

    Choisissez une fréquence adaptée à la fraîcheur d'insights dont vous avez besoin. Une cadence hebdomadaire convient bien aux revues stratégiques ; un déclenchement post-appel est préférable pour le coaching au niveau du commercial.
  </Step>

  <Step title="Scope — qui surveille-t-il ?">
    Définissez les appels de quels membres de l'équipe l'agent analyse. Vous pouvez cibler :

    * **All users** de votre workspace
    * **Specific teams** ou groupes
    * **Individual reps** ou account managers

    Garder un périmètre restreint améliore la qualité des résultats. Un agent de coaching limité aux appels d'un seul commercial donnera un feedback plus précis et exploitable qu'un agent tentant de couvrir toute une organisation à la fois.

    <Note>
      Une seule exécution analyse jusqu'à **100 réunions**, et une exécution programmée couvre jusqu'à **15 utilisateurs ciblés** à la fois. Si les utilisateurs ciblés génèrent plus d'activité que cela, réduisez le périmètre ou augmentez la fréquence d'exécution pour ne manquer aucune réunion.
    </Note>
  </Step>

  <Step title="Brain — instructions et principes">
    Rédigez les instructions qui indiquent à votre agent ce qu'il doit rechercher, comment l'analyser, et ce qu'il doit produire. C'est la partie la plus importante de votre agent — la qualité de vos instructions détermine directement la qualité de vos résultats.

    Vos instructions doivent répondre à :

    * Quels signaux ou motifs l'agent doit-il rechercher ?
    * Que doit-il signaler, noter ou résumer ?
    * Quel format doit prendre le résultat (liste à puces, tableau, récit, etc.) ?
    * Y a-t-il des meeting types ou des périodes spécifiques à inclure ?

    <Tip>
      **Conseils pour rédiger d'excellentes instructions d'agent :**

      * **Soyez précis** sur ce que l'agent doit rechercher — des instructions vagues produisent des résultats vagues. Plutôt que "résume l'appel", écrivez "identifie si le commercial a posé une question de découverte sur le budget, le calendrier et le décideur dans les 10 premières minutes".
      * **Définissez clairement le format de sortie** — précisez si vous voulez une liste à puces, un tableau noté, un message de style Slack, ou un paragraphe narratif.
      * **Incluez des exemples** de ce à quoi ressemblent le "bon" et le "mauvais" si pertinent — cela ancre le jugement de l'agent sur vos standards.
      * **Mentionnez les meeting types ou les périodes** — par exemple, "analyse les démos et les appels de découverte des 7 derniers jours" est bien plus précis que "regarde les appels récents".
      * **Un objectif clair par agent** — les agents avec un objectif unique et ciblé surpassent toujours les agents multi-objectifs. Créez des agents séparés pour le coaching, la détection de risques et le suivi concurrentiel plutôt que de les combiner.
    </Tip>

    Si vous ne savez pas par où commencer, utilisez un des [templates pré-construits](./templates) comme base et personnalisez-le.
  </Step>

  <Step title="Capabilities — outils">
    Sélectionnez les outils et sources de données auxquels votre agent peut accéder pendant ses exécutions. Accorder les bonnes capacités garantit que l'agent dispose du contexte nécessaire sans accès superflu.

    Les capacités disponibles incluent :

    * **Transcriptions** — lire le texte intégral des appels enregistrés
    * **CRM Data** — accéder aux enregistrements de deal, contact et opportunity de votre CRM connecté (HubSpot, Salesforce ou Pipedrive)
    * **Notes** — lire les notes de réunion créées par vous ou votre équipe
    * **Tasks** — consulter et créer des tâches de suivi
    * **Email** — lire les fils d'e-mails de votre propre boîte Gmail/Outlook connectée, en lien avec un contact ou un deal. Récupéré à la demande et non stocké — cela ne récupère pas les e-mails enregistrés dans votre CRM (par ex. les enregistrements Salesforce EmailMessage), et l'accès est limité à votre propre boîte de réception.

    <Note>
      Si aucun CRM n'est connecté, la capacité CRM Data n'a rien à lire — les agents se replient alors sur les transcriptions, notes et tâches stockées dans Piper.
    </Note>

    N'activez que les capacités dont votre agent a besoin. Un agent de coaching centré sur la qualité des appels n'a besoin que de Transcriptions. Un détecteur de risque de deal bénéficie de combiner Transcriptions avec CRM Data pour un contexte complet.
  </Step>
</Steps>

## Après l'enregistrement

Une fois votre agent enregistré, il commence à s'exécuter automatiquement selon le calendrier défini. Vous pouvez revenir sur n'importe quel agent à tout moment pour mettre à jour ses instructions, changer son périmètre, ou ajuster son calendrier.

<Accordion title="Combien d'agents puis-je créer ?">
  Il n'y a pas de limite au nombre d'agents que vous pouvez créer dans Piper. Créez-en autant que votre équipe en a besoin — un par cas d'usage est l'approche recommandée pour garder chaque agent ciblé et ses résultats faciles à exploiter.
</Accordion>

<Accordion title="Puis-je tester un agent avant qu'il ne s'exécute selon son calendrier ?">
  Oui — après avoir enregistré votre agent, vous pouvez déclencher une exécution manuelle pour voir comment il se comporte avant que la cadence programmée ne prenne le relais. Consultez le résultat et affinez vos instructions dans l'étape Brain si nécessaire.
</Accordion>

<Accordion title="Quelle est la différence entre un agent et une requête Chat ?">
  Chat est interactif — vous posez une question et recevez une réponse immédiatement. Les Agents sont automatisés — ils s'exécutent selon un calendrier et font émerger des insights de manière proactive, sans que vous ayez besoin de les solliciter chaque fois. Utilisez Chat pour des questions à la demande et Agents pour des workflows récurrents.
</Accordion>