Avant de commencer
- Une équipe agence sur une offre Business, Agency Business ou Enterprise active. Les outils d’écriture des audits de prospection ne sont pas disponibles autrement.
- Un rôle de Manager ou de Propriétaire dans l’équipe agence.
- Une connexion avec le scope
write:pitch-auditspour les outils d’écriture etread:pitch-auditspour lire l’audit. Consultez Authentification OAuth. - Des crédits pour l’audit. L’aperçu indique le montant avant que vous confirmiez.
Étapes
1
Trouver votre équipe agence
Demandez l’identifiant de l’équipe à l’assistant.
list_brands le renvoie dans l’objet team de chaque workspace. Les audits précédents renvoyés par list_pitch_audits indiquent aussi leur workspace.2
Créer l’audit
L’assistant appelle Qwairy prépare les prompts et ne consomme aucun crédit à ce stade. Laissez
create_pitch_audit :autoStartResponses non défini : il supprime la relecture des prompts.3
Attendre l’état de relecture
L’assistant lit l’audit avec
list_pitch_audits jusqu’à ce que son statut soit AWAITING_PROMPTS, puis l’ouvre avec get_pitch_audit. Le rapport renvoie les prompts et la version de l’audit.4
Relire et enregistrer les prompts
Lisez les prompts avec l’assistant. Retirez ou réécrivez ceux qui ne conviennent pas au prospect, puis enregistrez la liste complète avec L’appel remplace tout l’ensemble de prompts. Un conflit de version signifie que l’audit a changé : relisez-le.
save_pitch_audit_prompts, en passant la version lue comme expectedVersion :5
Prévisualiser le coût
Demandez à l’assistant d’appeler
confirm_pitch_audit avec dryRun défini sur true, ou de l’appeler sans jeton. Qwairy renvoie les crédits que l’audit consommera, d’éventuels avertissements et un confirmationToken. Rien n’a démarré.6
Confirmer
Si le coût est acceptable, approuvez-le. L’assistant appelle de nouveau
confirm_pitch_audit avec les mêmes arguments et le jeton. Le jeton est à usage unique et valable 10 minutes, et il est rejeté si les prompts ou le coût ont changé depuis l’aperçu. Votre client MCP peut aussi demander sa propre approbation.7
Lire le rapport
Interrogez
get_pitch_audit jusqu’à ce que le statut soit COMPLETED. Pour comparer un co-concurrent, réutilisez un subjectId de coCompetitors. Consultez Outils de lecture des audits de prospection. Une intégration REST peut s’abonner à pitch_audit.completed au lieu d’interroger.Exemple de conversation
Limites
- Relancer un audit échoué et exporter un rapport restent des actions du tableau de bord.
- Le contenu du site du prospect peut parvenir à l’assistant via le rapport. Lisez les aperçus avant de confirmer. Consultez Sécurité.

