Red Teams - List

Referencia

Servicio:: AI Foundry

Versión de la API:: 2025-05-15-preview

Enumera un equipo rojo por su nombre.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string (uri)	Punto final del proyecto. En la forma "https://.services.ai.azure.com/api/projects/_project" si su Foundry Hub tiene solo un proyecto, o para usar el proyecto predeterminado en su Hub. O en la forma "https://.services.ai.azure.com/api/projects/" si desea especificar explícitamente el nombre del proyecto de fundición.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
x-ms-client-request-id		string (uuid)	Identificador de cadena globalmente único y generado por el cliente para la solicitud.

Respuestas

Nombre	Tipo	Description
200 OK	PagedRedTeam	La solicitud se ha realizado correctamente. Encabezados x-ms-client-request-id: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Una respuesta de error inesperada. Encabezados x-ms-error-code: string

Nombre

Tipo

Description

200 OK

PagedRedTeam

La solicitud se ha realizado correctamente.

Encabezados

x-ms-client-request-id: string

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Una respuesta de error inesperada.

Encabezados

x-ms-error-code: string

Seguridad

OAuth2Auth

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Ámbitos

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

Ejemplos

RedTeams_List_MaximumSet

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 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"
}

Definiciones

Nombre	Description
AttackStrategy	Estrategias para los ataques.
Azure.Core.Foundations.Error	Objeto de error.
Azure.Core.Foundations.ErrorResponse	Respuesta que contiene los detalles del error.
Azure.Core.Foundations.InnerError	Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
AzureOpenAIModelConfiguration	Configuración del modelo de Azure OpenAI. El servicio seleccionaría la versión de la API para consultar el modelo.
PagedRedTeam	Colección paginada de artículos de RedTeam
RedTeam	Detalles del equipo rojo.
RiskCategory	Categoría de riesgo para el objetivo del ataque.

AttackStrategy

Enumeración

Estrategias para los ataques.

Valor	Description
ansii_attack	Utiliza secuencias de escape ANSI para manipular la apariencia y el comportamiento del texto.
ascii_art	Genera arte visual ASCII usando caracteres ASCII, que a menudo se usan con fines creativos o para ofuscación.
ascii_smuggler	Oculta los datos en caracteres ASCII, lo que dificulta la detección.
atbash	Implementa el cifrado Atbash, un cifrado de sustitución simple donde cada letra se asigna a su inversa.
base64	Codifica los datos binarios en un formato de texto mediante Base64, que se usa habitualmente para la transmisión de datos.
baseline	Representa el sondeo adversario directo de línea base, que utilizan las estrategias de ataque como objetivo de ataque.
binary	Convierte el texto en código binario, que representa los datos de una serie de 0 y 1s.
caesar	Aplica el cifrado César, un cifrado de sustitución que desplaza los caracteres por un número fijo de posiciones.
character_space	Modifica el texto agregando espacios entre caracteres, que a menudo se usan para ofuscar.
character_swap	Intercambia caracteres dentro del texto para crear variaciones o ofuscar el contenido original.
diacritic	Agrega marcas diacríticas a los caracteres, cambiando su apariencia y a veces su significado.
difficult	Representa un conjunto predeterminado de ataques de complejidad difícil. Los ataques de difícil complejidad incluyen ataques que requieren acceso a recursos significativos y esfuerzo para ejecutar un ataque, como el conocimiento de algoritmos basados en búsquedas, además de un modelo de IA generativa.
easy	Representa un conjunto predeterminado de ataques de complejidad fácil. Los ataques de complejidad fácil requieren menos esfuerzo, como la traducción de un mensaje a alguna codificación, y no requieren ningún modelo de lenguaje grande para convertirlo u orquestarlo.
flip	Voltea los caracteres de delante a atrás, creando un efecto reflejado.
jailbreak	Inserta avisos especialmente diseñados para omitir las medidas de seguridad de inteligencia artificial, conocidas como ataques de avisos insertados por el usuario (UPIA).
leetspeak	Transforma el texto en Leetspeak, una forma de codificación que reemplaza las letras por números o símbolos similares.
moderate	Representa un conjunto predeterminado de ataques de complejidad moderada. Los ataques de complejidad moderada requieren tener acceso a recursos como otro modelo de IA generativa.
morse	Codifica el texto en código morse, usando puntos y guiones para representar caracteres.
rot13	Aplica el cifrado ROT13, un cifrado de sustitución simple que desplaza caracteres por 13 posiciones.
string_join	Combina varias cadenas, que a menudo se usan para la concatenación o ofuscación.
suffix_append	Anexa un sufijo adverso a la solicitud.
unicode_confusable	Usa caracteres Unicode que tienen un aspecto similar a los caracteres estándar, lo que crea confusión visual.
unicode_substitution	Sustituye los caracteres estándar por equivalentes Unicode, a menudo por ofuscación.
url	Codifica el texto en formato de URL.

Azure.Core.Foundations.Error

Object

Objeto de error.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
details	Azure.Core.Foundations.Error[]	Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innererror	Azure.Core.Foundations.InnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
message	string	Una representación en lenguaje natural del error.
target	string	Destino del error.

Azure.Core.Foundations.ErrorResponse

Object

Respuesta que contiene los detalles del error.

Nombre	Tipo	Description
error	Azure.Core.Foundations.Error	Objeto de error.

Azure.Core.Foundations.InnerError

Object

Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
innererror	Azure.Core.Foundations.InnerError	Error interno.

AzureOpenAIModelConfiguration

Object

Configuración del modelo de Azure OpenAI. El servicio seleccionaría la versión de la API para consultar el modelo.

Nombre	Tipo	Description
modelDeploymentName	string	Nombre de implementación para el modelo AOAI. Ejemplo: gpt-4o si está en AIServices o basado `connection_name/deployment_name` en conexión (es decir, `my-aoai-connection/gpt-4o`.
type	string: AzureOpenAIModel	Tipo de configuración del modelo.

PagedRedTeam

Object

Colección paginada de artículos de RedTeam

Nombre	Tipo	Description
nextLink	string (uri)	Vínculo a la página siguiente de elementos
value	RedTeam[]	Los elementos de RedTeam en esta página

RedTeam

Object

Detalles del equipo rojo.

Nombre	Tipo	Valor predeterminado	Description
applicationScenario	string		Escenario de aplicación para la operación del equipo rojo, para generar ataques específicos del escenario.
attackStrategies	AttackStrategy[]		Lista de estrategias de ataque o listas anidadas de estrategias de ataque.
displayName	string		Nombre de la carrera del equipo rojo.
id	string		Identificador de la carrera del equipo rojo.
numTurns	integer (int32)		Número de rondas de simulación.
properties	object		Propiedades del equipo rojo. A diferencia de las etiquetas, las propiedades son de solo complemento. Una vez agregado, no se puede quitar una propiedad.
riskCategories	RiskCategory[]		Lista de categorías de riesgo para las que generar objetivos de ataque.
simulationOnly	boolean	False	Solo Simulación o Simulación + Evaluación. Predeterminado false, si es true, el escaneo genera una conversación, no el resultado de la evaluación.
status	string		Estatus del equipo rojo. Lo establece el servicio y es de solo lectura.
tags	object		Etiquetas del equipo rojo. A diferencia de las propiedades, las etiquetas son completamente mutables.
target	TargetConfig: AzureOpenAIModelConfiguration		Configuración de destino para la ejecución del equipo rojo.

RiskCategory

Enumeración

Categoría de riesgo para el objetivo del ataque.

Valor	Description
HateUnfairness	Representa contenido relacionado con el odio o la injusticia.
SelfHarm	Representa contenido relacionado con la autolesión.
Sexual	Representa contenido de naturaleza sexual.
Violence	Representa contenido relacionado con la violencia.

Compartir a través de

Red Teams - List

Parámetros de identificador URI

Encabezado de la solicitud

Respuestas

Seguridad

OAuth2Auth

Ámbitos

Ejemplos

RedTeams_List_MaximumSet

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AttackStrategy

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

AzureOpenAIModelConfiguration

PagedRedTeam

RedTeam

RiskCategory