Notifications relatives à l’application des règles de sécurité

Utilisez les webhooks de sécurité et l’API de lecture des dossiers de sécurité pour intégrer les avis d’OpenAI aux workflows de votre équipe. Par exemple, à la réception d’un avertissement, votre application peut récupérer les détails du dossier, identifier l’utilisateur concerné et créer un ticket pour examen interne.

Quand utiliser cette intégration

Utilisez cette intégration pour :

• Transmettre les avis d’avertissement et de désactivation à votre équipe chargée de la confiance et de la sécurité ou à votre équipe d’assistance.
• Ajouter les informations d’un dossier à un ticket d’enquête ou d’assistance.
• Associer un avis à un utilisateur grâce à la correspondance que votre application conserve entre les identifiants de sécurité et les utilisateurs.

Les étapes de ce guide illustrent le workflow à partir d’un avertissement. Vous pouvez utiliser la même intégration pour les avis de désactivation.

Fonctionnement

Les webhooks de sécurité informent votre application lorsqu’OpenAI émet un avis.

Chaque événement contient un identifiant de dossier. Utilisez-le avec GET /v1/safety/cases/{id} pour récupérer l’identifiant de sécurité, le type d’avis, la date et l’heure de création du dossier ainsi que le motif lié aux règles de sécurité, s’il est disponible.

Ces notifications concernent l’ensemble de l’organisation et sont distinctes des alertes de désalignement propres à chaque projet. La consultation du dossier ne modifie ni n’annule la mesure prise.

Intégration à votre application

Configurez d’abord un webhook au niveau de l’organisation et une clé pour consulter les dossiers. Intégrez ensuite les notifications à votre workflow d’examen.

Configurez votre webhook et recevez les événements

Utilisez un identifiant de sécurité stable pour chaque utilisateur et conservez dans votre application la correspondance entre cet identifiant et l’utilisateur. Évitez d’inclure des informations personnelles dans l’identifiant.

Créez un point de terminaison de webhook au niveau de l’organisation dans les paramètres des webhooks de votre organisation et abonnez-vous aux événements safety.warning_issued et safety.deactivation_issued.

Une notification d’avertissement présente la structure suivante :

123456789{
  "id": "evt_example",
  "object": "event",
  "created_at": 1787659200,
  "type": "safety.warning_issued",
  "data": {
    "id": "C-abc123"
  }
}

Pour connaître les bonnes pratiques générales, consultez le guide des webhooks.

Le champ id identifie l’événement du webhook. Le champ data.id identifie le dossier de sécurité à récupérer.

Récupérez le dossier

Pour consulter les dossiers, configurez une clé API de la même organisation. Sélectionnez Restricted pour les autorisations et réglez Safety sur Read (api.safety.read).

Récupérez les métadonnées du dossier avec l’API de lecture des dossiers de sécurité :

curl "https://api.openai.com/v1/safety/cases/C-abc123" \
  -H "Authorization: Bearer ${OPENAI_API_KEY}"

Si la requête aboutit, l’API renvoie le code HTTP 200 et un objet contenant les données du dossier. Par exemple :

12345678910{
  "id": "C-abc123",
  "object": "safety.case",
  "created_at": 1787659100,
  "entity_identifier": "entity_identifier",
  "reason": "cyber_abuse",
  "notice": {
    "type": "warning"
  }
}

Le champ entity_identifier contient l’identifiant de sécurité concerné. La date et l’heure de création du dossier peuvent vous aider dans votre enquête. Pour connaître la définition des champs, consultez la référence de l’API des dossiers de sécurité.

Intégrez les avis à vos workflows

Recevez les notifications par webhook, puis utilisez les métadonnées des dossiers pour acheminer automatiquement les avis vers vos systèmes d’enquête ou d’assistance existants.

Dépannage