Partager via


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 comprend un système de filtrage de contenu qui fonctionne avec les modèles de base, notamment les modèles de génération d’image DALL-E. 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 de risques

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.
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.

Boucliers d’invite

Type Description
Bouclier contre les prompts utilisés pour les attaques par jailbreak Les attaques par jailbreak sont des prompts utilisateur conçus pour inciter le modèle d’IA générative à adopter des comportements qu’il a été entraîné à éviter ou à enfreindre les règles définies dans le message système. De telles attaques peuvent aller d’un jeu de rôle complexe à une subversion subtile de l’objectif de sécurité.
Bouclier contre les prompts utilisés pour les attaques indirectes Les attaques indirectes, également appelées attaques par prompt indirectes ou attaques par injection de prompt inter-domaines, constituent une vulnérabilité potentielle dans laquelle des tiers placent des instructions malveillantes à l’intérieur de documents auxquels le système d’IA générative peut accéder et traiter. Nécessite l’incorporation et la mise en forme de documents.

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 de contenu par défaut pour la série de modèles GPT est définie pour filtrer au seuil de gravité moyenne pour les quatre catégories de contenu dangereux (haine, violence, sexuel et automutilation) et s’applique aux invites (texte, texte/image multimodal) et aux achèvements (texte). Cela signifie que le contenu détecté au niveau de gravité moyenne ou élevée est filtré, tandis que le contenu détecté au niveau de gravité faible n’est pas filtré par les filtres de contenu. Pour DALL-E, le seuil de gravité par défaut est défini sur faible pour les invites (texte) et les achèvements (images), de sorte que le contenu détecté aux niveaux de gravité faible, moyenne ou élevée est filtré. 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 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é. Nécessite une approbation1.
Aucun filtre En cas d’approbation1 En cas d’approbation1 Aucun contenu n’est filtré quel que soit le niveau de gravité détecté. Nécessite une approbation1.

1 Pour les modèles Azure OpenAI, seuls les clients qui ont été approuvés pour le filtrage de contenu modifié disposent d’un contrôle total du filtrage de contenu et peuvent désactiver les filtres de contenu. Demander des filtres de contenu modifiés via ce formulaire : Révision d’accès limité Azure OpenAI : filtres de contenu modifiés

Cette fonctionnalité en préversion est disponible pour les modèles Azure OpenAI suivants :

  • Série de modèles GPT (texte)
  • GPT-4 Turbo Vision 2024-04-09 (image/texte multimodal)
  • DALL-E 2 et 3 (image)

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.

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

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 :

Modèle Sortie
jailbreak détection (true ou false),
filtrage (true ou false)
attaques indirectes détection (true ou false),
filtrage (true ou false)
texte de matériel protégé détection (true ou false),
filtrage (true ou false)
code de matériel protégé détection (true ou false),
filtrage (true ou false),
exemple de citation du dépôt GitHub public où l’extrait de code a été trouvé,
licence du dépôt

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.

Consultez le tableau suivant pour connaître la disponibilité des annotations dans chaque version d’API :

Catégorie 2024-02-01 GA 2024-04-01-preview 2023-10-01-preview 2023-06-01-preview
Déteste
Violence
Contenu sexuel
Automutilation
Bouclier contre les prompts utilisés pour les attaques par jailbreak
Bouclier contre les prompts utilisés pour les attaques indirectes
Texte de matériel protégé
Code de matériel protégé
Liste de blocage des vulgarités
Liste de blocage personnalisée
# 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"
                }
            }
        }
    }
}

Incorporation de documents dans les prompts

Un aspect clé des mesures d’Azure OpenAI en matière d’IA responsable est le système de sécurité du contenu. Ce système fonctionne aux côtés du modèle GPT de base pour monitorer toute irrégularité dans l’entrée et la sortie du modèle. Ses performances augmentent lorsqu’il peut différencier divers éléments de votre prompt, comme l’entrée système, l’entrée utilisateur et la sortie de l’assistant IA.

Pour améliorer les fonctionnalités de détection, mettez en forme les prompts selon les méthodes recommandées suivantes.

API de saisie semi-automatique de conversation

L’API de saisie semi-automatique de conversation est structurée par définition. Elle se compose d’une liste de messages, chaque message ayant un rôle attribué.

Le système de sécurité analyse ce format structuré et applique le comportement suivant :

  • Sur le dernier contenu « utilisateur », les catégories suivantes de risques RAI sont détectées :
    • Déteste
    • Contenu sexuel
    • Violence
    • Automutilation
    • Jailbreak (facultatif)

Voici un exemple de tableau de messages :

{"role": "system", "content": "Provide some context and/or instructions to the model."}, 
{"role": "user", "content": "Example question goes here."}, 
{"role": "assistant", "content": "Example answer goes here."}, 
{"role": "user", "content": "First question/message for the model to actually respond to."} 

Incorporation de documents dans votre prompt

En plus de la détection sur le dernier contenu utilisateur, Azure OpenAI prend en charge la détection de risques spécifiques à l’intérieur de documents contextuels via des boucliers contre les prompts qui détectent les attaques par prompt indirectes. Vous devez identifier les parties de l’entrée constituant un document (site web récupéré, e-mail, etc.) avec le délimiteur de document suivant.

<documents> 
*insert your document content here* 
</documents>

Au cours de cette opération, les options suivantes sont disponibles à des fins de détection sur des documents étiquetés :

  • Sur chaque contenu de « document » étiqueté, détection des catégories suivantes :
    • Attaques indirectes (facultatives)

Voici un exemple de tableau de messages de saisie semi-automatique de conversation :

{"role": "system", "content": "Provide some context and/or instructions to the model, including document context. \"\"\" <documents>\n*insert your document content here*\n<\\documents> \"\"\""}, 

{"role": "user", "content": "First question/message for the model to actually respond to."} 

Échappement JSON

Lorsque vous étiquetez des documents non validés à des fins de détection, vous devez placer le contenu du document dans une séquence d’échappement JSON pour que le système de sécurité Azure OpenAI puisse effectuer l’analyse.

Par exemple, prenez le corps de l’e-mail suivant :

Hello Josè, 

I hope this email finds you well today.

Avec l’échappement JSON, cela donne :

Hello Jos\u00E9,\nI hope this email finds you well today. 

Voici le texte placé dans une séquence d’échappement dans un contexte de saisie semi-automatique de conversation :

{"role": "system", "content": "Provide some context and/or instructions to the model, including document context. \"\"\" <documents>\n Hello Jos\\u00E9,\\nI hope this email finds you well today. \n<\\documents> \"\"\""}, 

{"role": "user", "content": "First question/message for the model to actually respond to."}

Streaming de contenu

Cette section décrit l’expérience et les options de diffusion en continu du contenu Azure OpenAI. Les clients ont la possibilité de recevoir du contenu de l’API au fur et à mesure de sa génération, au lieu d’attendre que des blocs de contenu vérifiés passent 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 asynchrone

Les clients peuvent choisir le Filtre asynchrone comme option supplémentaire, ce qui offre 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 expérience de diffusion en continu rapide sans latence associée à la sécurité du contenu.

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.

Engagement vis-à-vis des droits d’auteur des clients : il est possible que le contenu signalé de manière rétroactive comme matériel protégé ne soit pas éligible pour la couverture Engagement vis-à-vis des droits d’auteur des clients.

Pour activer Filtre asynchrone dans 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 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 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 une réponse réelle de saisie semi-automatique de conversation utilisant Filtre 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 un prompt et qu’un "status": 400 est reçu dans le cadre de la réponse, des frais sont facturés pour cette requête puisque le prompt a été évalué par le service. En raison de la nature asynchrone du système de filtrage de contenu, une facturation aura lieu pour les jetons d’invite et de saisie semi-automatique. 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