## Pourquoi c'est important

Un agent de revue permet à un client IA que vous utilisez déjà d'examiner, à intervalles réguliers, chaque rapport nouveau ou modifié et d'y laisser une courte **synthèse de triage** réservée à l'équipe. Pour cela, inutile de donner à ce client l'accès à tout le module Security.

L'agent tourne de votre côté : dans ChatGPT, dans Claude, ou dans un script ou un exécuteur d'API que vous planifiez. Kit ne l'exécute pas pour vous. Kit lui fournit un point de terminaison restreint et quatre outils :

| Outil | Ce qu'il fait |
|-------|---------------|
| `csirt_review_get_project` | Votre guide de revue, le contexte du programme, le périmètre et les domaines, et ce qui reste du budget du jour |
| `csirt_review_next` | Le prochain rapport à examiner, réservé pendant 30 minutes |
| `csirt_review_get_report` | Le même rapport une nouvelle fois, si l'agent a perdu son contexte |
| `csirt_review_submit` | Dépose une synthèse au titre de la réservation |

L'agent ne peut modifier ni le statut, ni la sévérité, ni l'assignation, ni le rejet, ni les primes, ni le karma. Il ne peut pas écrire aux chercheurs. Il ne voit jamais le nom, l'e-mail, le karma, la localisation ni les paiements des chercheurs, ni les pièces jointes, ni les notes internes que vous n'avez pas partagées avec lui.

## Contenu d'une synthèse

- **Recommandation** : Suggère de valider, Informations supplémentaires nécessaires, Suggère de rejeter ou Incertain
- **Résumé** : ce que le rapport affirme et la conclusion de l'agent
- **Périmètre** : Dans le périmètre, Hors périmètre ou incertain, avec la ligne exacte de votre périmètre ou de votre contexte sur laquelle l'agent s'appuie. Un verdict qui ne cite pas vos propres termes est affiché comme incertain.
- **Sévérité et vecteur CVSS suggérés**
- **Domaine suggéré** et un **doublon possible** parmi les rapports similaires
- **Jusqu'à trois questions** que vous pourriez poser au chercheur

La synthèse apparaît dans l'onglet Détails du rapport sous l'intitulé **Suggestion IA · nom de l'agent**. Dès qu'une synthèse existe, le filtrage IA devient la ligne **Qualité du rapport** de la carte. Une synthèse n'est qu'un avis : rien ne change tant qu'un membre de votre équipe n'agit pas avec les boutons habituels. Une pastille signale une synthèse rédigée avant la dernière modification du rapport.

Déposer une synthèse ne compte pas comme une activité de l'équipe : cela ne réinitialise pas les relances des rapports en souffrance, n'envoie ni e-mail ni message Slack et ne déclenche aucun webhook. Les chercheurs ne voient jamais les synthèses.

## Avant de commencer

- Vous devez être **administrateur Security** (les administrateurs du compte le sont toujours).
- Ajoutez un **contexte de revue** pour que l'agent connaisse votre produit : ouvrez [**Paramètres du programme → Général**](/csirt/program/general_config/edit) et remplissez **Contexte de revue** (technologies, modèle d'authentification, environnements, risques acceptés, comportements voulus). Chaque [domaine](/docs/routing-reports-to-teams) peut aussi avoir son propre contexte de revue. Ce texte est réservé à l'équipe et n'est jamais publié pour les chercheurs, mais il est envoyé à chaque agent que vous connectez : n'y collez aucun secret.

## Créer un agent

1. Ouvrez [**Intégrations → Agents de revue**](/csirt/settings/agents) et cliquez sur **Nouvel agent de revue**.
2. Donnez-lui un nom et définissez l'**intervalle d'exécution prévu** : la fréquence à laquelle votre plateforme l'exécutera. Kit vous avertit si des rapports attendent et que l'agent est resté muet deux fois plus longtemps que cet intervalle, plus une heure.
3. Lisez les listes **Envoyé à l'agent** et **Reste dans Kit**, puis cliquez sur **Créer l'agent et partager les rapports**.

Vous devenez le responsable de l'agent. Si le responsable quitte le compte ou n'est plus administrateur Security, l'agent est mis en pause et les administrateurs Security sont prévenus ; n'importe lequel d'entre eux peut le reprendre depuis le formulaire de modification.

Un compte peut avoir jusqu'à cinq agents. Les agents sont gratuits sur les offres payantes et ne comptent pas comme un utilisateur.

## Connecter ChatGPT ou Claude

ChatGPT, claude.ai et les tâches planifiées de Claude Code se connectent via OAuth.

1. Sur la page de l'agent, cliquez sur **Connecter une plateforme**. Pendant les 15 minutes qui suivent, toute connexion que vous approuvez est rattachée à cet agent.
2. Dans ChatGPT ou Claude, ajoutez un connecteur personnalisé avec le point de terminaison de l'agent affiché sur sa page (`https://startupkit.app/mcp/csirt_review/v1`).
3. Approuvez l'écran **Connecter un agent de revue** dans Kit. Il indique l'agent, le client et l'adresse vers laquelle vous serez redirigé.

Kit ne rattache des agents qu'à ChatGPT, à Claude ou à un client local. Chaque nouvelle connexion est signalée à vos administrateurs Security et à vos administrateurs du compte. Une déconnexion depuis la page de l'agent l'arrête immédiatement.

Configurez le connecteur pour qu'il s'exécute sans demander d'approbation à chaque appel d'outil : lors d'une exécution planifiée, personne n'est là pour cliquer sur **Allow** (Autoriser). Si votre plateforme attend une approbation, la page de l'agent affiche les rapports récupérés qui n'ont jamais reçu de synthèse.

## Utiliser une clé (exécuteurs d'API et scripts)

Pour la xAI API, la Responses API d'OpenAI, Claude Managed Agents ou votre propre tâche cron :

1. Sur la page de l'agent, sous **Clés**, cliquez sur **Créer une clé**. Une clé est valable jusqu'à 90 jours.
2. Copiez la clé. Elle commence par `kit_agent_` et n'est affichée qu'une seule fois.
3. Envoyez-la dans un en-tête au point de terminaison de l'agent : `Authorization: Bearer kit_agent_…`.

Un agent peut avoir deux clés actives, ce qui vous permet de créer la suivante avant que l'actuelle n'expire. Kit le rappelle au responsable 7 jours puis 1 jour avant l'expiration d'une clé. Si votre compte limite l'accès à l'API par adresse IP, les appels provenant des serveurs des fournisseurs d'IA sont refusés, sauf si leurs adresses sont autorisées.

## Ce que lit l'agent

Un rapport est à examiner pour un agent lorsqu'il a le statut **Soumis**, **Pris en charge** ou **Clarification nécessaire**, qu'il a été modifié après la création de l'agent et qu'il est resté inactif pendant 10 minutes (ou qu'une heure s'est écoulée depuis la dernière synthèse de l'agent sur ce rapport). Les rapports restreints et les rapports d'exemple ne sont jamais transmis.

Pour chaque rapport, l'agent reçoit le titre, la description, les étapes de reproduction, le point de terminaison et la sévérité revendiquée ; les 10 derniers messages échangés avec le chercheur (les membres de l'équipe apparaissent comme « staff ») ; la sévérité évaluée ; le domaine et son contexte de revue ; les verdicts du filtrage IA et de la détection d'injection de prompt de Kit ; et les rapports similaires (les rapports ouverts uniquement par leur identifiant).

Les champs rédigés par le chercheur sont marqués comme non fiables. Si l'[analyse d'injection de prompt](/docs/prompt-injection-scan) de Kit signale un rapport, l'agent ne peut pas recommander de le rejeter.

### Partager une note interne

Les notes internes restent dans Kit, sauf si vous les partagez une à une. Sur une note que vous avez rédigée, cliquez sur l'icône en forme de puce pour la **partager avec les agents**. Une note qui semble contenir un identifiant secret (une clé AWS, un jeton GitHub ou Slack, un JWT, une clé privée) ne peut pas être partagée. L'auteur de la note ou n'importe quel administrateur Security peut arrêter le partage ; les agents qui ont déjà lu la note en gardent leur copie.

## Limites

| Limite | Valeur |
|--------|--------|
| Rapports récupérés par agent et par jour | 150 |
| Synthèses par agent et par jour | 100 |
| Appels d'outils par agent et par jour | 2 000 |
| Appels d'outils par agent et par minute | 60 |
| Appels d'outils par compte et par minute, tous agents confondus | 120 |
| Synthèses par rapport, par agent et par jour | 4 |

Le point d’accès limite aussi les requêtes HTTP à 120 par jeton Bearer et par minute, et à 600 par adresse IP source et par minute. Sans jeton Bearer, la limite est de 30 par minute. Les connexions qui utilisent la même adresse IP de sortie chez un fournisseur partagent cette limite. Leur trafic cumulé peut donc recevoir une réponse HTTP 429 même si chaque agent dispose encore de capacité.

Un rapport récupéré trois fois dans la même version sans synthèse n'est plus transmis tant qu'il n'a pas changé ; la page de l'agent le liste sous **Transmis trois fois, jamais synthétisé**.

## Pouvoirs supplémentaires

Deux options du formulaire de l'agent lui permettent d'en faire un peu plus. Toutes deux sont désactivées par défaut et agissent dès que vous les activez :

- **Suggérer le domaine** : renseigne le domaine suggéré sur les rapports qui n'en ont pas. L'équipe doit toujours le confirmer.
- **Signaler les doublons** : place un rapport en bas de la liste quand l'agent désigne un original plus ancien et validé, et que le contrôle de similarité de Kit le confirme. Jamais sur un rapport présentant un signal de sévérité élevée ou critique, ni sur un rapport signalé pour injection de prompt. Le rapport n'est jamais masqué, son SLA n'est jamais touché, et le signalement disparaît dès que le rapport change.

La page de l'agent indique à quelle fréquence l'équipe a fini par lui donner raison pour chacune.

## Données et confidentialité

Un agent que vous connectez est votre propre client, qui lit vos données avec un identifiant que vous avez créé. Les détails des rapports sont envoyés au fournisseur d'IA de votre choix, dans le cadre de votre contrat avec lui. Choisissez une offre entreprise ou API qui n'entraîne pas de modèle sur vos données ; c'est l'offre du fournisseur qui détermine où les données sont traitées. Kit ne peut pas récupérer ce qu'un agent a déjà lu.

Chaque appel est journalisé sur la page de l'agent (outil, rapport, résultat, identifiant et adresse IP, jamais le contenu) et conservé pendant 90 jours.

## Et ensuite ?

- [Intégration IA](/docs/ai-integration-vdp) : l'agent de sécurité intégré à Kit et les outils MCP pour votre équipe
- [Trier votre file VDP avec Claude](/docs/ai-native-vdp-triage) : le triage interactif avec Claude
- [Analyse d'injection de prompt](/docs/prompt-injection-scan) : comment Kit signale le texte destiné aux outils IA