Red Teams - List

Référence

Service:: AI Foundry

Version d'API:: 2025-05-15-preview

Listez une équipe rouge par son nom.

GET {endpoint}/redTeams/runs?api-version=2025-05-15-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
endpoint	path	True	string (uri)	Point final du projet. Sous la forme "https://.services.ai.azure.com/api/projects/_project" ; si votre Foundry Hub n’a qu’un seul projet, ou pour utiliser le projet par défaut dans votre Hub. Ou sous la forme "https://.services.ai.azure.com/api/projects/" ; si vous souhaitez spécifier explicitement le nom du projet Foundry.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

En-tête de la demande

Nom	Obligatoire	Type	Description
x-ms-client-request-id		string (uuid)	Identificateur de chaîne opaque, globalement unique et généré par le client pour la requête.

Réponses

Nom	Type	Description
200 OK	PagedRedTeam	La demande a réussi. En-têtes x-ms-client-request-id: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Réponse d’erreur inattendue. En-têtes x-ms-error-code: string

Nom

Type

Description

200 OK

PagedRedTeam

La demande a réussi.

En-têtes

x-ms-client-request-id: string

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Réponse d’erreur inattendue.

En-têtes

x-ms-error-code: string

Sécurité

OAuth2Auth

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Étendues

Nom	Description
https://ai.azure.com/.default

Exemples

RedTeams_List_MaximumSet

Exemple de requête

HTTP

GET {endpoint}/redTeams/runs?api-version=2025-05-15-preview

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "id": "tztegmf",
      "numTurns": 10,
      "attackStrategies": [
        "easy"
      ],
      "simulationOnly": true,
      "riskCategories": [
        "HateUnfairness"
      ],
      "applicationScenario": "qaxxxhjp",
      "tags": {
        "key1287": "gbklekkgmxkfbhehgh"
      },
      "properties": {
        "key9280": "fwzjtipl"
      },
      "status": "owgxaiudnkkeqwlnhtmihvhdkbgd",
      "target": {
        "type": "TargetConfig"
      }
    }
  ],
  "nextLink": "https://microsoft.com/a"
}

Définitions

Nom	Description
AttackStrategy	Stratégies d’attaques.
Azure.Core.Foundations.Error	Objet d’erreur.
Azure.Core.Foundations.ErrorResponse	Réponse contenant les détails de l’erreur.
Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
AzureOpenAIModelConfiguration	Configuration du modèle Azure OpenAI. La version de l’API est sélectionnée par le service pour interroger le modèle.
PagedRedTeam	Collection paginée d’articles RedTeam
RedTeam	Détails de l’équipe rouge.
RiskCategory	Catégorie de risque pour l’objectif d’attaque.

AttackStrategy

Énumération

Stratégies d’attaques.

Valeur	Description
ansii_attack	Utilise des séquences d’échappement ANSI pour manipuler l’apparence et le comportement du texte.
ascii_art	Génère de l’art visuel à l’aide de caractères ASCII, souvent utilisés à des fins créatives ou d’obfuscation.
ascii_smuggler	Masque les données au sein de caractères ASCII, ce qui complique la détection.
atbash	Implémente le chiffrement Atbash, un chiffrement de substitution simple où chaque lettre est mappée à son inverse.
base64	Encode les données binaires dans un format texte à l’aide de Base64, couramment utilisée pour la transmission de données.
baseline	Représente le sondage antagoniste direct de base, qui est utilisé par les stratégies d’attaque comme objectif d’attaque.
binary	Convertit du texte en code binaire, représentant des données dans une série de 0 et 1s.
caesar	Applique le chiffrement César, un chiffrement de substitution qui déplace les caractères par un nombre fixe de positions.
character_space	Modifie le texte en ajoutant des espaces entre des caractères, souvent utilisés pour l’obfuscation.
character_swap	Échange des caractères dans le texte pour créer des variantes ou obfusquer le contenu d’origine.
diacritic	Ajoute des marques diacritiques aux caractères, en modifiant leur apparence et parfois leur signification.
difficult	Représente un ensemble par défaut d’attaques de complexité difficile. Les attaques de complexité difficile comprennent les attaques qui nécessitent l’accès à des ressources et des efforts importants pour exécuter une attaque, tels que la connaissance d’algorithmes basés sur la recherche, en plus d’un modèle d’IA générative.
easy	Représente un ensemble par défaut d’attaques de complexité facile. Les attaques de complexité facile nécessitent moins d’efforts, comme la traduction d’une invite en encodage, et ne nécessitent aucun modèle de langage volumineux pour être converties ou orchestrées.
flip	Inverse l’ordre des caractères, créant ainsi un effet miroir.
jailbreak	Injecte des requêtes spécialement conçues pour contourner les mesures de protection de l’IA, connu sous le nom d’UPIA (User Injected Prompt Attack).
leetspeak	Transforme le texte en Leetspeak, une forme d’encodage qui remplace les lettres par des chiffres ou des symboles similaires.
moderate	Représente un ensemble par défaut d’attaques de complexité modérée. Les attaques de complexité modérée nécessitent d’avoir accès à des ressources telles qu’un autre modèle d’IA générative.
morse	Encode du texte dans du code Morse, à l’aide de points et de tirets pour représenter des caractères.
rot13	Applique le chiffrement ROT13, un chiffrement de substitution simple qui déplace les caractères par 13 positions.
string_join	Assemble plusieurs chaînes, souvent utilisé pour la concaténation ou l’obfuscation.
suffix_append	Ajoute un suffixe contradictoire à l’invite.
unicode_confusable	Utilise des caractères Unicode similaires aux caractères standard, ce qui crée une confusion visuelle.
unicode_substitution	Remplace les caractères standard par des équivalents Unicode, souvent pour l’obfuscation.
url	Encode le texte au format URL.

Azure.Core.Foundations.Error

Object

Objet d’erreur.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
details	Azure.Core.Foundations.Error[]	Tableau de détails sur des erreurs spécifiques qui ont conduit à cette erreur signalée.
innererror	Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message	string	Une représentation lisible par une personne de l'erreur.
target	string	Cible de l’erreur.

Azure.Core.Foundations.ErrorResponse

Object

Réponse contenant les détails de l’erreur.

Nom	Type	Description
error	Azure.Core.Foundations.Error	Objet d’erreur.

Azure.Core.Foundations.InnerError

Object

Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
innererror	Azure.Core.Foundations.InnerError	Erreur interne.

AzureOpenAIModelConfiguration

Object

Configuration du modèle Azure OpenAI. La version de l’API est sélectionnée par le service pour interroger le modèle.

Nom	Type	Description
modelDeploymentName	string	Nom de déploiement du modèle AOAI. Exemple : gpt-4o si dans AIServices ou basé sur `connection_name/deployment_name` une connexion (c’est-à-dire `my-aoai-connection/gpt-4o`.
type	string: AzureOpenAIModel	Type de configuration du modèle.

PagedRedTeam

Object

Collection paginée d’articles RedTeam

Nom	Type	Description
nextLink	string (uri)	Lien vers la page suivante des éléments
value	RedTeam[]	Les articles RedTeam sur cette page

RedTeam

Object

Détails de l’équipe rouge.

Nom	Type	Valeur par défaut	Description
applicationScenario	string		Scénario d’application pour l’opération de l’équipe rouge, pour générer des attaques spécifiques au scénario.
attackStrategies	AttackStrategy[]		Liste de stratégies d’attaque ou listes imbriquées de stratégies d’attaque.
displayName	string		Nom de la course de l’équipe rouge.
id	string		Identifiant de la course de l’équipe rouge.
numTurns	integer (int32)		Nombre de tours de simulation.
properties	object		Les propriétés de l’équipe rouge. Contrairement aux balises, les propriétés sont des compléments uniquement. Une fois ajoutée, une propriété ne peut pas être supprimée.
riskCategories	RiskCategory[]		Liste des catégories de risque pour lesquelles générer des objectifs d’attaque.
simulationOnly	boolean	False	Simulation uniquement ou Simulation + Évaluation. Par défaut false, si true, l’analyse génère la conversation et non le résultat de l’évaluation.
status	string		Statut de l’équipe rouge. Il est défini par le service et est en lecture seule.
tags	object		Tags de l’équipe rouge. Contrairement aux propriétés, les balises sont totalement mutables.
target	TargetConfig: AzureOpenAIModelConfiguration		Configuration cible pour l’exécution de l’équipe rouge.

RiskCategory

Énumération

Catégorie de risque pour l’objectif d’attaque.

Valeur	Description
HateUnfairness	Représente du contenu lié à la haine ou à l’injustice.
SelfHarm	Représente du contenu lié à l’automutilation.
Sexual	Représente du contenu à caractère sexuel.
Violence	Représente du contenu lié à la violence.

Partager via

Red Teams - List

Paramètres URI

En-tête de la demande

Réponses

Sécurité

OAuth2Auth

Étendues

Exemples

RedTeams_List_MaximumSet

Exemple de requête

Exemple de réponse

Définitions

AttackStrategy

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

AzureOpenAIModelConfiguration

PagedRedTeam

RedTeam

RiskCategory