Filtrage du contenu

Important

Le système de filtrage de contenu n’est pas appliqué aux invites et aux complétions traitées par le modèle Whisper dans Azure OpenAI Service. Apprenez-en davantage sur le modèle Whisper dans Azure OpenAI.

Azure OpenAI Service inclut un système de filtrage du contenu qui fonctionne avec les modèles de base. Ce système fonctionne en exécutant l’invite et l’achèvement par le biais d’un ensemble de modèles de classification visant à détecter et à empêcher la sortie de contenu nuisible. Le système de filtrage du contenu détecte les catégories spécifiques de contenu potentiellement nuisible dans les invites d’entrée et les achèvements de sortie et prend des mesures correspondantes. Les écarts au niveau des configurations d’API et de la conception de l’application pourraient affecter les achèvements et, par conséquent, le comportement de filtrage.

Les modèles de filtrage de contenu pour les catégories haine, sexualité, violence et automutilation ont été spécifiquement entraînés et testés sur les langues suivantes : anglais, allemand, japonais, espagnol, français, italien, portugais et chinois. Le service peut toutefois fonctionner dans de nombreuses autres langues, mais il est possible que la qualité varie. Dans tous les cas, vous devez effectuer vos propres tests pour vous assurer qu’il fonctionne pour votre application.

En plus du système de filtrage du contenu, Azure OpenAI Service effectue une supervision pour détecter le contenu et/ou les comportements qui suggèrent une utilisation du service d’une manière susceptible de violer les conditions du produit applicables. Pour plus d’informations sur la compréhension et l’atténuation des risques associés à votre application, consultez la note de transparence pour Azure OpenAI. Pour plus d’informations sur le traitement des données pour le filtrage de contenu et la surveillance des abus, consultez Données, confidentialité et sécurité pour azure OpenAI Service.

Les sections ci-après fournissent des informations sur les catégories de filtrage du contenu, les niveaux de gravité de filtrage et leurs configuration et les scénarios d’API à prendre en compte lors de la conception et de l’implémentation d’applications.

Catégories de filtrage du contenu

Le système de filtrage de contenu intégré dans Azure OpenAI Service contient :

  • Des modèles de classification multiclasse neuronaux destinés à détecter et à filtrer le contenu nuisible. Les modèles couvrent quatre catégories (haine, sexualité, violence et automutilation) selon quatre niveaux de gravité (sans risque, faible, moyen et élevé). Le contenu détecté au niveau de gravité « sûr » est étiqueté dans les annotations mais n'est pas soumis au filtrage et n'est pas configurable.
  • Autres modèles de classification facultatifs visant à détecter le risque de jailbreak et le contenu connu pour le texte et le code ; ces modèles sont des classifieurs binaires qui indiquent si le comportement de l’utilisateur ou du modèle est qualifié d’attaque de jailbreak ou de correspondance avec du texte ou du code source connu. L’utilisation de ces modèles est facultative, mais l’utilisation d’un modèle de code de matériel protégé peut être nécessaire pour la couverture de l’engagement du droit d’auteur du client.

Catégories préjudiciables

Category Description
Haine et impartialité Les préjudices liés à la haine et à l’impartialité décrit des attaques ou des utilisations de termes péjoratifs ou discriminatoires faisant référence à une personne ou à des groupes d’identité sur la base de certains attributs de différenciation de ces groupes, notamment la race, l’origine ethnique, la nationalité, les groupes et l’expression d’identité de genre, l’orientation sexuelle, la religion, le statut d’immigration, les aptitudes, l’apparence personnelle et la taille du corps. 

L’impartialité consiste à veiller à ce que les systèmes d’IA traitent tous les groupes de personnes de manière équitable sans contribuer aux inégalités sociales existantes. À l’instar du discours haineux, les préjudices liés à l’impartialité dépendent du traitement disparate des groupes d’identité.  
Contenu sexuel La sexualité décrit le langage relatif aux organes anatomiques et génitaux, aux relations amoureuses, aux actes présentés en termes érotiques ou affectueux, à la grossesse, aux actes sexuels physiques, y compris les actes présentés comme une agression ou un acte violent sexuel forcé contre la volonté d’une personne, la prostitution, la pornographie et les abus.  
Violence La violence décrit le langage lié aux actions physiques destinées à blesser, nuire, endommager ou tuer quelqu’un ou quelque chose ; cela décrit les armes, les fusils et les entités connexes, telles que les fabricants, les associations, la législation, etc.
Automutilation L’automutilation décrit le langage lié aux actions physiques destinées à blesser ou nuire le corps d’une personne ou à se tuer.
Risque de jailbreak Les attaques de jailbreak sont des invites utilisateur conçues pour provoquer le modèle d’IA Générative afin de présenter des comportements qu’il a été entraîné pour éviter ou pour briser les règles définies dans le message système. Ces attaques peuvent varier d’un jeu rôle complexe à une subversion subtile de l’objectif de sécurité.
Matériel protégé pour le texte* Le texte matériel protégé décrit le contenu texte connu (par exemple, les paroles de chanson, les articles, les recettes et le contenu web sélectionné) qui peut être généré par de grands modèles de langage.
Matériel protégé pour le code Le code matériel protégé décrit le code source qui correspond à un ensemble de codes sources provenant de référentiels publics, qui peuvent être produits par de grands modèles de langage sans que les référentiels de sources soient correctement cités.

* Si vous êtes propriétaire de matériel texte et que vous souhaitez envoyer du contenu texte à des fins de protection, envoyez une demande.

Contenu textuel

Avertissement

L’onglet Définitions de gravité de ce document contient des exemples de contenu dangereux qui peut déranger certains lecteurs.

Contenu du fichier image

Avertissement

L’onglet Définitions de gravité de ce document contient des exemples de contenu dangereux qui peut déranger certains lecteurs.

Configuration (préversion)

La configuration du filtrage du contenu par défaut est définie pour filtrer au niveau de gravité moyen pour les quatre catégories de contenu pour les invites et les achèvements. Cela signifie que le contenu détecté au niveau de gravité moyen ou élevé est filtré, tandis que le contenu détecté au niveau de gravité faible n'est pas filtré par les filtres de contenu. La fonctionnalité de configuration est disponible en préversion et permet aux clients d’ajuster les paramètres, séparément pour les invites et la saisie semi-automatique, afin de filtrer le contenu pour chaque catégorie de contenu à différents niveaux de gravité, comme décrit dans le tableau ci-dessous :

Gravité filtrée Configurable pour les invites Configurable pour la saisie semi-automatique Descriptions
Faible, moyen, élevé Oui Oui Configuration de filtrage la plus stricte. Le contenu détecté aux niveaux de gravité bas, moyen et élevé est filtré.
Moyen, élevé Oui Oui Paramètre par défaut. Le contenu détecté au niveau de gravité faible n’est pas filtré. Le contenu moyen et élevé est filtré.
Élevé Oui Oui Le contenu détecté aux niveaux de gravité faible et moyen n'est pas filtré. Seul le contenu au niveau de gravité élevé est filtré.
Aucun filtre En cas d’approbation* En cas d’approbation* Aucun contenu n’est filtré quel que soit le niveau de gravité détecté. Nécessite une approbation*.

* Seuls les clients qui ont été approuvés pour le filtrage de contenu modifié ont un contrôle de filtrage de contenu complet et peuvent désactiver partiellement ou complètement les filtres de contenu. Le contrôle de filtrage de contenu ne s’applique pas aux filtres de contenu pour DALL-E (préversion) ou GPT-4 Turbo avec Vision (préversion). Appliquez des filtres de contenu modifiés à l'aide de ce formulaire : Azure OpenAI Limited Access Review : Filtrage de contenu modifié (microsoft.com).

Les clients sont chargés de s’assurer que les applications intégrant Azure OpenAI sont conformes au Code de conduite.

Les configurations de filtrage de contenu sont créées dans une ressource dans Azure AI Studio et peuvent être associées à des déploiements. Apprenez-en plus sur la configuration ici.

Détails du scénario

Lorsque le système de filtrage de contenu détecte le contenu dangereux, vous recevez une erreur lors de l’appel d’API si l’invite a été jugée inappropriée, ou le finish_reason sur la réponse sera content_filter pour indiquer que la saisie semi-automatique a été filtrée. Lors de la génération de votre application ou de votre système, vous devez tenir compte de ces scénarios où le contenu retourné par l’API d’achèvement est filtré, ce qui peut entraîner un contenu incomplet. La façon dont vous agissez sur ces informations sera spécifique à l’application. Le comportement peut être résumé dans les points suivants :

  • Les invites classées dans une catégorie filtrée à un niveau de gravité donné retournent une erreur HTTP 400.
  • Les appels de saisie semi-automatique sans diffusion en continu ne retournent aucun contenu lorsque le contenu est filtré. La valeur finish_reason est définie sur content_filter. Dans de rares cas avec des réponses longues, un résultat partiel peut être retourné. Dans ce cas, finish_reason est mis à jour.
  • Pour les appels de saisie semi-automatique de diffusion en continu, les segments sont renvoyés à l’utilisateur à mesure qu’ils sont terminés. Le service continue la diffusion en continu jusqu’à ce qu’il atteigne un jeton d’arrêt ou une certaine longueur ou que du contenu classé dans une catégorie filtrée à un niveau de gravité donné soit détecté.

Scénario : Vous envoyez un appel d’achèvement sans diffusion en continu demandant plusieurs sorties ; aucun contenu n’est classé dans une catégorie filtrée à un niveau de gravité donné

Le tableau ci-dessous présente les différentes façons dont le filtrage de contenu peut apparaître :

Code de réponse HTTP Comportement de la réponse
200 Dans les cas où toutes les générations transmettent les filtres tels qu’ils sont configurés, aucun détail de modération de contenu n’est ajouté à la réponse. La valeur finish_reason de chaque génération est soit stop, soit length.

Exemple de charge utile de requête :

{
    "prompt":"Text example", 
    "n": 3,
    "stream": false
}

Exemple JSON de réponse :

{
    "id": "example-id",
    "object": "text_completion",
    "created": 1653666286,
    "model": "davinci",
    "choices": [
        {
            "text": "Response generated text",
            "index": 0,
            "finish_reason": "stop",
            "logprobs": null
        }
    ]
}

Scénario : votre appel d’API demande plusieurs réponses (N>1) et au moins une des réponses est filtrée

Code de réponse HTTP Comportement de la réponse
200 Les générations qui ont été filtrées ont la valeur content_filter pour finish_reason.

Exemple de charge utile de requête :

{
    "prompt":"Text example",
    "n": 3,
    "stream": false
}

Exemple JSON de réponse :

{
    "id": "example",
    "object": "text_completion",
    "created": 1653666831,
    "model": "ada",
    "choices": [
        {
            "text": "returned text 1",
            "index": 0,
            "finish_reason": "length",
            "logprobs": null
        },
        {
            "text": "returned text 2",
            "index": 1,
            "finish_reason": "content_filter",
            "logprobs": null
        }
    ]
}

Scénario : une invite d’entrée inappropriée est envoyée à l’API de saisie semi-automatique (pour la diffusion en continu ou la non-diffusion en continu)

Code de réponse HTTP Comportement de la réponse
400 L’appel d’API échoue quand l’invite déclenche un filtre de contenu tel que configuré. Modifiez l’invite et réessayez.

Exemple de charge utile de requête :

{
    "prompt":"Content that triggered the filtering model"
}

Exemple JSON de réponse :

"error": {
    "message": "The response was filtered",
    "type": null,
    "param": "prompt",
    "code": "content_filter",
    "status": 400
}

Scénario : Vous effectuez un appel d’achèvement en diffusion en continu ; aucun contenu de sortie n’est classé dans une catégorie filtrée à un niveau de gravité donné

Code de réponse HTTP Comportement de la réponse
200 Dans ce cas, l’appel retourne la génération complète et la valeur de finish_reason est « length » ou « stop » pour chaque réponse générée.

Exemple de charge utile de requête :

{
    "prompt":"Text example",
    "n": 3,
    "stream": true
}

Exemple JSON de réponse :

{
    "id": "cmpl-example",
    "object": "text_completion",
    "created": 1653670914,
    "model": "ada",
    "choices": [
        {
            "text": "last part of generation",
            "index": 2,
            "finish_reason": "stop",
            "logprobs": null
        }
    ]
}

Scénario : Vous effectuez un appel d’achèvement de diffusion en continu demandant plusieurs achèvements et au moins une partie du contenu de sortie est filtrée

Code de réponse HTTP Comportement de la réponse
200 Pour un index de génération donné, le dernier segment de la génération inclut une valeur non null finish_reason. La valeur est content_filter quand la génération a été filtrée.

Exemple de charge utile de requête :

{
    "prompt":"Text example",
    "n": 3,
    "stream": true
}

Exemple JSON de réponse :

 {
    "id": "cmpl-example",
    "object": "text_completion",
    "created": 1653670515,
    "model": "ada",
    "choices": [
        {
            "text": "Last part of generated text streamed back",
            "index": 2,
            "finish_reason": "content_filter",
            "logprobs": null
        }
    ]
}

Scénario : Le système de filtrage du contenu ne s’exécute pas lors de l’achèvement

Code de réponse HTTP Comportement de la réponse
200 Si le système de filtrage du contenu est en panne ou si vous ne parvenez pas à terminer l’opération à temps, votre requête est toujours terminée sans filtrage du contenu. Vous pouvez déterminer que le filtrage n’a pas été appliqué en recherchant un message d’erreur dans l’objet content_filter_result.

Exemple de charge utile de requête :

{
    "prompt":"Text example",
    "n": 1,
    "stream": false
}

Exemple JSON de réponse :

{
    "id": "cmpl-example",
    "object": "text_completion",
    "created": 1652294703,
    "model": "ada",
    "choices": [
        {
            "text": "generated text",
            "index": 0,
            "finish_reason": "length",
            "logprobs": null,
            "content_filter_result": {
                "error": {
                    "code": "content_filter_error",
                    "message": "The contents are not filtered"
                }
            }
        }
    ]
}

Annotations

Filtres de contenu

Lorsque les annotations sont activées comme indiqué dans l’extrait de code ci-dessous, les informations suivantes sont retournées via l’API pour les catégories haine et équité, sexuelle, violence et auto-préjudice :

  • catégorie de filtrage de contenu (haine, sexualité, violence, automutilation)
  • niveau de gravité (sans risque, faible, moyen et élevé) dans chaque catégorie de contenu
  • état de filtrage (true ou false).

Modèles facultatifs

Les modèles optionnels peuvent être activés en mode annotation (ils renvoient des informations lorsque le contenu a été marqué, mais pas filtré) ou en mode filtrage (ils renvoient des informations lorsque le contenu a été marqué et filtré).

Lorsque les annotations sont activées comme indiqué dans l’extrait de code ci-dessous, les informations suivantes sont retournées par l’API pour les modèles facultatifs à risque de jailbreak, le texte matériel protégé et le code matériel protégé :

  • catégorie (jailbreak, protected_material_text, protected_material_code),
  • détecté (true ou false),
  • filtré (true ou false).

Pour le modèle de code matériel protégé, les informations supplémentaires suivantes sont retournées par l’API :

  • un exemple de citation d’un référentiel GitHub public où un extrait de code a été trouvé
  • la licence du référentiel.

Lors de l’affichage du code dans votre application, nous vous recommandons vivement d’afficher également l’exemple de citation des annotations. La conformité à la licence citée peut également être requise pour la couverture de l’engagement du droit d’auteur du client.

Les annotations sont actuellement disponibles dans la version de l’API GA 2024-02-01 et dans toutes les versions préliminaires à partir de 2023-06-01-preview pour les achèvements et les achèvements de conversation (modèles GPT). L’extrait de code suivant montre comment utiliser des annotations :

# os.getenv() for the endpoint and key assumes that you are using environment variables.

import os
from openai import AzureOpenAI
client = AzureOpenAI(
    api_key=os.getenv("AZURE_OPENAI_API_KEY"),  
    api_version="2024-03-01-preview",
    azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT") 
    )

response = client.completions.create(
    model="gpt-35-turbo-instruct", # model = "deployment_name".
    prompt="{Example prompt where a severity level of low is detected}" 
    # Content that is detected at severity level medium or high is filtered, 
    # while content detected at severity level low isn't filtered by the content filters.
)

print(response.model_dump_json(indent=2))

Sortie

{ 
  "choices": [ 
    { 
      "content_filter_results": { 
        "hate": { 
          "filtered": false, 
          "severity": "safe" 
        }, 
        "protected_material_code": { 
          "citation": { 
            "URL": " https://github.com/username/repository-name/path/to/file-example.txt", 
            "license": "EXAMPLE-LICENSE" 
          }, 
          "detected": true,
          "filtered": false 
        }, 
        "protected_material_text": { 
          "detected": false, 
          "filtered": false 
        }, 
        "self_harm": { 
          "filtered": false, 
          "severity": "safe" 
        }, 
        "sexual": { 
          "filtered": false, 
          "severity": "safe" 
        }, 
        "violence": { 
          "filtered": false, 
          "severity": "safe" 
        } 
      }, 
      "finish_reason": "stop", 
      "index": 0, 
      "message": { 
        "content": "Example model response will be returned ", 
        "role": "assistant" 
      } 
    } 
  ], 
  "created": 1699386280, 
  "id": "chatcmpl-8IMI4HzcmcK6I77vpOJCPt0Vcf8zJ", 
  "model": "gpt-35-turbo-instruct", 
  "object": "text.completion",
  "usage": { 
    "completion_tokens": 40, 
    "prompt_tokens": 11, 
    "total_tokens": 417 
  },  
  "prompt_filter_results": [ 
    { 
      "content_filter_results": { 
        "hate": { 
          "filtered": false, 
          "severity": "safe" 
        }, 
        "jailbreak": { 
          "detected": false, 
          "filtered": false 
        }, 
        "profanity": { 
          "detected": false, 
          "filtered": false 
        }, 
        "self_harm": { 
          "filtered": false, 
          "severity": "safe" 
        }, 
        "sexual": { 
          "filtered": false, 
          "severity": "safe" 
        }, 
        "violence": { 
          "filtered": false, 
          "severity": "safe" 
        } 
      }, 
      "prompt_index": 0 
    } 
  ]
} 

Pour plus d’informations sur les points de terminaison d’API REST d’inférence pour Azure OpenAI et sur la création de conversations et d’achèvements, consultez le guide de référence de l’API REST d’Azure OpenAI Service. Les annotations sont retournées pour tous les scénarios lors de l’utilisation d’une version préliminaire de l’API à partir de 2023-06-01-preview, ainsi que de la version de l’API ga 2024-02-01.

Exemple de scénario : Une invite d’entrée contenant du contenu classé dans une catégorie filtrée à un niveau de gravité donné est envoyée à l’API d’achèvement

{
    "error": {
        "message": "The response was filtered due to the prompt triggering Azure Content management policy. 
                   Please modify your prompt and retry. To learn more about our content filtering policies
                   please read our documentation: https://go.microsoft.com/fwlink/?linkid=21298766",
        "type": null,
        "param": "prompt",
        "code": "content_filter",
        "status": 400,
        "innererror": {
            "code": "ResponsibleAIPolicyViolation",
            "content_filter_result": {
                "hate": {
                    "filtered": true,
                    "severity": "high"
                },
                "self-harm": {
                    "filtered": true,
                    "severity": "high"
                },
                "sexual": {
                    "filtered": false,
                    "severity": "safe"
                },
                "violence": {
                    "filtered":true,
                    "severity": "medium"
                }
            }
        }
    }
}

Streaming de contenu

Cette section décrit l’expérience et les options de diffusion en continu du contenu Azure OpenAI. Si vous y êtes autorisé, vous avez la possibilité de recevoir du contenu de l’API au fur et à mesure qu’il est généré, au lieu d’attendre des blocs de contenu vérifiés pour transmettre vos filtres de contenu.

Par défaut

Le système de filtrage de contenu est intégré et activé par défaut pour tous les clients. Dans le scénario de diffusion en continu par défaut, le contenu de complétion est mis en mémoire tampon, puis le système de filtrage eu contenu s’exécute sur le contenu mis en mémoire tampon. Ensuite, selon la configuration du filtrage de contenu, le contenu est soit retourné à l’utilisateur s’il ne viole pas la stratégie de filtrage de contenu (configuration Microsoft par défaut ou configuration utilisateur personnalisée), soit immédiatement bloqué (dans ce cas, une erreur de filtrage de contenu est retournée et le contenu de complétion nuisible n’est pas retourné). Ce processus est répété jusqu’à la fin du flux. Le contenu est entièrement vérifié en fonction de la stratégie de filtrage de contenu avant d’être retourné à l’utilisateur. Le contenu n’est pas retourné jeton par jeton dans ce cas, mais sous la forme de « blocs de contenu » de la taille de la mémoire tampon respective.

Filtre modifié asynchrone

Les clients autorisés à utiliser des filtres de contenu modifiés peuvent choisir l’option supplémentaire de filtre modifié asynchrone, offrant ainsi une nouvelle expérience de diffusion en continu. Dans ce cas, les filtres de contenu sont exécutés de manière asynchrone et le contenu de complétion est retourné immédiatement avec une expérience de diffusion en continu jeton par jeton fluide. Aucun contenu n’est mis en mémoire tampon, ce qui permet une latence nulle.

Bien que cette fonctionnalité améliore la latence, les clients doivent avoir conscience de ses conséquences sur la sécurité et la vérification en temps réel de plus petites sections de la sortie du modèle. Étant donné que les filtres de contenu sont exécutés de manière asynchrone, les messages de modération du contenu et les signaux de violation de la stratégie sont retardés, ce qui signifie que certaines sections de contenu nuisible qui sont normalement filtrées immédiatement peuvent être présentées à l’utilisateur.

Annotations : des annotations et des messages de modération du contenu sont retournés en continu pendant le flux. Nous vous recommandons vivement de consommer les annotations dans votre application et d’implémenter des mécanismes supplémentaires de sécurité du contenu IA, notamment le masquage du contenu ou le retour d’informations de sécurité supplémentaires à l’utilisateur.

Signal de filtrage de contenu : le signal d’erreur de filtrage du contenu est retardé. En cas de violation de la stratégie, il est retourné dès qu’il est disponible et le flux est arrêté. Le signal de filtrage de contenu est garanti dans des fenêtres d’environ 1 000 caractères pour le contenu qui enfreint la stratégie.

Vous devez être autorisé à utiliser le filtrage de contenu modifié pour accéder au filtre modifié asynchrone. Le formulaire de demande est disponible ici. Pour l’activer via Azure OpenAI Studio, suivez le guide pratique sur les filtres de contenu afin de créer une configuration de filtrage de contenu, puis sélectionnez Filtre modifié asynchrone dans la section Diffusion en continu.

Comparaison des modes de filtrage de contenu

Comparer Diffusion en continu – Par défaut Diffusion en continu – Filtre modifié asynchrone
État GA Version préliminaire publique
Éligibilité Tous les clients Clients autorisés à utiliser le filtrage de contenu modifié
Comment activer Activé par défaut, aucune action requise Les clients autorisés à utiliser le filtrage de contenu modifié peuvent le configurer directement dans Azure OpenAI Studio (dans le cadre d’une configuration de filtrage de contenu appliquée au niveau du déploiement)
Modalité et disponibilité Texte, tous les modèles GPT Texte, tous les modèles GPT sauf gpt-4-vision
Expérience de diffusion en continu Le contenu est mis en mémoire tampon et retourné en blocs Latence nulle (aucune mise en mémoire tampon, filtres exécutés de manière asynchrone)
Signal de filtrage de contenu Signal de filtrage immédiat Signal de filtrage retardé (jusqu’à 1 000 caractères environ par incrément)
Configurations de filtrage de contenu Prend en charge les paramètres de filtrage par défaut et définis par le client (y compris les modèles facultatifs) Prend en charge les paramètres de filtrage par défaut et définis par le client (y compris les modèles facultatifs)

Annotations et exemples de réponses

Message d’annotation d’invite

Équivaut aux annotations par défaut.

data: { 
    "id": "", 
    "object": "", 
    "created": 0, 
    "model": "", 
    "prompt_filter_results": [ 
        { 
            "prompt_index": 0, 
            "content_filter_results": { ... } 
        } 
    ], 
    "choices": [], 
    "usage": null 
} 

Message de jeton de complétion

Les messages de complétion sont transférés immédiatement. Aucune modération n’est effectuée en premier et aucune annotation n’est fournie initialement.

data: { 
    "id": "chatcmpl-7rAJvsS1QQCDuZYDDdQuMJVMV3x3N", 
    "object": "chat.completion.chunk", 
    "created": 1692905411, 
    "model": "gpt-35-turbo", 
    "choices": [ 
        { 
            "index": 0, 
            "finish_reason": null, 
            "delta": { 
                "content": "Color" 
            } 
        } 
    ], 
    "usage": null 
} 

Message d’annotation

Le champ de texte est toujours une chaîne vide, indiquant l’absence de nouveaux jetons. Les annotations ne concernent que les jetons déjà envoyés. Plusieurs messages d’annotation peuvent faire référence aux mêmes jetons.

"start_offset" et "end_offset" sont des décalages à faible granularité dans le texte (avec 0 au début de l’invite) pour marquer le texte auquel l’annotation s’applique.

"check_offset" représente la quantité de texte entièrement modérée. Il s’agit d’une limite inférieure exclusive sur les valeurs "end_offset" des annotations futures. Elle ne diminue pas.

data: { 
    "id": "", 
    "object": "", 
    "created": 0, 
    "model": "", 
    "choices": [ 
        { 
            "index": 0, 
            "finish_reason": null, 
            "content_filter_results": { ... }, 
            "content_filter_raw": [ ... ], 
            "content_filter_offsets": { 
                "check_offset": 44, 
                "start_offset": 44, 
                "end_offset": 198 
            } 
        } 
    ], 
    "usage": null 
} 

Exemple de flux de réponse (transmission de filtres)

Vous trouverez ci-dessous la réponse de complétion d’une conversation réelle utilisant le filtre modifié asynchrone. Notez que les annotations d’invite ne sont pas modifiées, que les jetons de complétion sont envoyés sans annotations et que les nouveaux messages d’annotation sont envoyés sans jetons (mais associés à certains décalages de filtre de contenu).

{"temperature": 0, "frequency_penalty": 0, "presence_penalty": 1.0, "top_p": 1.0, "max_tokens": 800, "messages": [{"role": "user", "content": "What is color?"}], "stream": true}

data: {"id":"","object":"","created":0,"model":"","prompt_annotations":[{"prompt_index":0,"content_filter_results":{"hate":{"filtered":false,"severity":"safe"},"self_harm":{"filtered":false,"severity":"safe"},"sexual":{"filtered":false,"severity":"safe"},"violence":{"filtered":false,"severity":"safe"}}}],"choices":[],"usage":null} 

data: {"id":"chatcmpl-7rCNsVeZy0PGnX3H6jK8STps5nZUY","object":"chat.completion.chunk","created":1692913344,"model":"gpt-35-turbo","choices":[{"index":0,"finish_reason":null,"delta":{"role":"assistant"}}],"usage":null} 

data: {"id":"chatcmpl-7rCNsVeZy0PGnX3H6jK8STps5nZUY","object":"chat.completion.chunk","created":1692913344,"model":"gpt-35-turbo","choices":[{"index":0,"finish_reason":null,"delta":{"content":"Color"}}],"usage":null} 

data: {"id":"chatcmpl-7rCNsVeZy0PGnX3H6jK8STps5nZUY","object":"chat.completion.chunk","created":1692913344,"model":"gpt-35-turbo","choices":[{"index":0,"finish_reason":null,"delta":{"content":" is"}}],"usage":null} 

data: {"id":"chatcmpl-7rCNsVeZy0PGnX3H6jK8STps5nZUY","object":"chat.completion.chunk","created":1692913344,"model":"gpt-35-turbo","choices":[{"index":0,"finish_reason":null,"delta":{"content":" a"}}],"usage":null} 

... 

data: {"id":"","object":"","created":0,"model":"","choices":[{"index":0,"finish_reason":null,"content_filter_results":{"hate":{"filtered":false,"severity":"safe"},"self_harm":{"filtered":false,"severity":"safe"},"sexual":{"filtered":false,"severity":"safe"},"violence":{"filtered":false,"severity":"safe"}},"content_filter_offsets":{"check_offset":44,"start_offset":44,"end_offset":198}}],"usage":null} 

... 

data: {"id":"chatcmpl-7rCNsVeZy0PGnX3H6jK8STps5nZUY","object":"chat.completion.chunk","created":1692913344,"model":"gpt-35-turbo","choices":[{"index":0,"finish_reason":"stop","delta":{}}],"usage":null} 

data: {"id":"","object":"","created":0,"model":"","choices":[{"index":0,"finish_reason":null,"content_filter_results":{"hate":{"filtered":false,"severity":"safe"},"self_harm":{"filtered":false,"severity":"safe"},"sexual":{"filtered":false,"severity":"safe"},"violence":{"filtered":false,"severity":"safe"}},"content_filter_offsets":{"check_offset":506,"start_offset":44,"end_offset":571}}],"usage":null} 

data: [DONE] 

Exemple de flux de réponse (blocage par filtres)

{"temperature": 0, "frequency_penalty": 0, "presence_penalty": 1.0, "top_p": 1.0, "max_tokens": 800, "messages": [{"role": "user", "content": "Tell me the lyrics to \"Hey Jude\"."}], "stream": true}

data: {"id":"","object":"","created":0,"model":"","prompt_filter_results":[{"prompt_index":0,"content_filter_results":{"hate":{"filtered":false,"severity":"safe"},"self_harm":{"filtered":false,"severity":"safe"},"sexual":{"filtered":false,"severity":"safe"},"violence":{"filtered":false,"severity":"safe"}}}],"choices":[],"usage":null} 

data: {"id":"chatcmpl-8JCbt5d4luUIhYCI7YH4dQK7hnHx2","object":"chat.completion.chunk","created":1699587397,"model":"gpt-35-turbo","choices":[{"index":0,"finish_reason":null,"delta":{"role":"assistant"}}],"usage":null} 

data: {"id":"chatcmpl-8JCbt5d4luUIhYCI7YH4dQK7hnHx2","object":"chat.completion.chunk","created":1699587397,"model":"gpt-35-turbo","choices":[{"index":0,"finish_reason":null,"delta":{"content":"Hey"}}],"usage":null} 

data: {"id":"chatcmpl-8JCbt5d4luUIhYCI7YH4dQK7hnHx2","object":"chat.completion.chunk","created":1699587397,"model":"gpt-35-turbo","choices":[{"index":0,"finish_reason":null,"delta":{"content":" Jude"}}],"usage":null} 

data: {"id":"chatcmpl-8JCbt5d4luUIhYCI7YH4dQK7hnHx2","object":"chat.completion.chunk","created":1699587397,"model":"gpt-35-turbo","choices":[{"index":0,"finish_reason":null,"delta":{"content":","}}],"usage":null} 

... 

data: {"id":"chatcmpl-8JCbt5d4luUIhYCI7YH4dQK7hnHx2","object":"chat.completion.chunk","created":1699587397,"model":"gpt-35- 

turbo","choices":[{"index":0,"finish_reason":null,"delta":{"content":" better"}}],"usage":null} 

data: {"id":"","object":"","created":0,"model":"","choices":[{"index":0,"finish_reason":null,"content_filter_results":{"hate":{"filtered":false,"severity":"safe"},"self_harm":{"filtered":false,"severity":"safe"},"sexual":{"filtered":false,"severity":"safe"},"violence":{"filtered":false,"severity":"safe"}},"content_filter_offsets":{"check_offset":65,"start_offset":65,"end_offset":1056}}],"usage":null} 

data: {"id":"","object":"","created":0,"model":"","choices":[{"index":0,"finish_reason":"content_filter","content_filter_results":{"protected_material_text":{"detected":true,"filtered":true}},"content_filter_offsets":{"check_offset":65,"start_offset":65,"end_offset":1056}}],"usage":null} 

data: [DONE] 

Important

Quand le filtrage de contenu est déclenché pour une invite et que "status": 400 est reçu dans le cadre de la réponse, des frais peuvent être facturés pour cette requête, car l’invite a été évaluée par le service. Des frais sont à prévoir également quand "status":200 est reçu avec "finish_reason": "content_filter". Dans le cas présent, l’invite n’a posé aucun problème. Toutefois, une violation des règles de filtrage de contenu a été détectée au niveau de la complétion générée par le modèle, ce qui a entraîné le filtrage de la complétion.

Bonnes pratiques

Dans le cadre de la conception de votre application, tenez compte des meilleures pratiques suivantes pour offrir une expérience positive liée à votre application tout en minimisant les dommages potentiels :

  • Déterminez la façon dont vous souhaitez gérer les scénarios dans lesquels vos utilisateurs envoient des invites contenant du contenu classé dans une catégorie filtrée à un niveau de gravité donné ou qui utilisent votre application de manière incorrecte.
  • Vérifiez la valeur finish_reason pour déterminer si un achèvement est filtré.
  • Vérifiez qu’il n’y a pas d’objet d’erreur dans content_filter_result (indiquant que les filtres de contenu n’ont pas été exécutés).
  • Si vous utilisez le modèle de code matériel protégé en mode annotation, affichez l’URL de citation lorsque vous affichez le code dans votre application.

Étapes suivantes