Red Teams - Get

Referência

Serviço:: AI Foundry

Versão da API:: 2025-05-15-preview

Obtenha um redteam pelo nome.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
endpoint	path	True	string (uri)	Ponto final do projeto. Na forma "https://.services.ai.azure.com/api/projects/_project" se o seu Foundry Hub tiver apenas um Projeto, ou para usar o Projeto padrão em seu Hub. Ou na forma "https://.services.ai.azure.com/api/projects/" se quiser especificar explicitamente o nome do Projeto de Fundição.
name	path	True	string	Identificador da corrida da equipe vermelha.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
x-ms-client-request-id		string (uuid)	Um identificador de cadeia de caracteres opaco, globalmente exclusivo e gerado pelo cliente para a solicitação.

Respostas

Name	Tipo	Description
200 OK	RedTeam	O pedido foi bem-sucedido. Cabeçalhos x-ms-client-request-id: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Uma resposta de erro inesperada. Cabeçalhos x-ms-error-code: string

Name

Tipo

Description

200 OK

RedTeam

O pedido foi bem-sucedido.

Cabeçalhos

x-ms-client-request-id: string

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Uma resposta de erro inesperada.

Cabeçalhos

x-ms-error-code: string

Segurança

OAuth2Auth

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Âmbitos

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

Exemplos

RedTeams_Get_MaximumSet

Pedido de amostra

HTTP

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

Resposta da amostra

Código de estado:: 200

{
  "id": "tztegmf",
  "numTurns": 10,
  "attackStrategies": [
    "easy"
  ],
  "simulationOnly": true,
  "riskCategories": [
    "HateUnfairness"
  ],
  "applicationScenario": "qaxxxhjp",
  "tags": {
    "key1287": "gbklekkgmxkfbhehgh"
  },
  "properties": {
    "key9280": "fwzjtipl"
  },
  "status": "owgxaiudnkkeqwlnhtmihvhdkbgd",
  "target": {
    "type": "TargetConfig"
  }
}

Definições

Name	Description
AttackStrategy	Estratégias para ataques.
Azure.Core.Foundations.Error	O objeto de erro.
Azure.Core.Foundations.ErrorResponse	Uma resposta contendo detalhes do erro.
Azure.Core.Foundations.InnerError	Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API do Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
AzureOpenAIModelConfiguration	Configuração do modelo do Azure OpenAI. A versão da API seria selecionada pelo serviço para consultar o modelo.
RedTeam	Detalhes da equipe vermelha.
RiskCategory	Categoria de risco para o objetivo de ataque.

AttackStrategy

Enumeração

Estratégias para ataques.

Valor	Description
ansii_attack	Utiliza sequências de escape ANSI para manipular a aparência e o comportamento do texto.
ascii_art	Gera arte visual usando caracteres ASCII, muitas vezes usados para fins criativos ou ofuscação.
ascii_smuggler	Oculta dados em caracteres ASCII, dificultando sua deteção.
atbash	Implementa a cifra Atbash, uma cifra de substituição simples onde cada letra é mapeada para o seu reverso.
base64	Codifica dados binários em um formato de texto usando Base64, comumente usado para transmissão de dados.
baseline	Representa a sondagem adversária direta da linha de base, que é usada por estratégias de ataque como o objetivo de ataque.
binary	Converte texto em código binário, representando dados em uma série de 0s e 1s.
caesar	Aplica a cifra de César, uma cifra de substituição que desloca caracteres por um número fixo de posições.
character_space	Altera o texto adicionando espaços entre caracteres, frequentemente usados para ofuscação.
character_swap	Troca caracteres no texto para criar variações ou ofuscar o conteúdo original.
diacritic	Adiciona marcas diacríticas aos personagens, alterando sua aparência e, às vezes, seu significado.
difficult	Representa um conjunto padrão de ataques de complexidade difícil. Ataques de complexidade difícil incluem ataques que exigem acesso a recursos significativos e esforço para executar um ataque, como conhecimento de algoritmos baseados em pesquisa, além de um modelo de IA generativa.
easy	Representa um conjunto padrão de ataques de complexidade fácil. Ataques de complexidade fácil exigem menos esforço, como a tradução de um prompt em alguma codificação, e não exigem nenhum modelo de linguagem grande para converter ou orquestrar.
flip	Inverte os caracteres da frente para trás, criando um efeito espelhado.
jailbreak	Injeta prompts especialmente criados para contornar as proteções de IA, conhecidos como User Injected Prompt Attacks (UPIA).
leetspeak	Transforma texto em Leetspeak, uma forma de codificação que substitui letras por números ou símbolos de aparência semelhante.
moderate	Representa um conjunto padrão de ataques de complexidade moderada. Ataques de complexidade moderada exigem ter acesso a recursos como outro modelo de IA generativa.
morse	Codifica texto em código Morse, usando pontos e traços para representar caracteres.
rot13	Aplica a cifra ROT13, uma cifra de substituição simples que desloca caracteres em 13 posições.
string_join	Une várias sequências de caracteres, muitas vezes usadas para concatenação ou ofuscação.
suffix_append	Acrescenta um sufixo adversarial ao prompt.
unicode_confusable	Usa caracteres Unicode que se parecem com caracteres padrão, criando confusão visual.
unicode_substitution	Substitui caracteres padrão por equivalentes Unicode, muitas vezes para ofuscação.
url	Codifica o texto em formato URL.

Azure.Core.Foundations.Error

Object

O objeto de erro.

Name	Tipo	Description
code	string	Um de um conjunto de códigos de erro definido pelo servidor.
details	Azure.Core.Foundations.Error[]	Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado.
innererror	Azure.Core.Foundations.InnerError	Um objeto que contém informações mais específicas do que o objeto atual sobre o erro.
message	string	Uma representação legível por humanos do erro.
target	string	O alvo do erro.

Azure.Core.Foundations.ErrorResponse

Object

Uma resposta contendo detalhes do erro.

Name	Tipo	Description
error	Azure.Core.Foundations.Error	O objeto de erro.

Azure.Core.Foundations.InnerError

Object

Um objeto que contém informações mais específicas sobre o erro. De acordo com as diretrizes da API do Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name	Tipo	Description
code	string	Um de um conjunto de códigos de erro definido pelo servidor.
innererror	Azure.Core.Foundations.InnerError	Erro interno.

AzureOpenAIModelConfiguration

Object

Configuração do modelo do Azure OpenAI. A versão da API seria selecionada pelo serviço para consultar o modelo.

Name	Tipo	Description
modelDeploymentName	string	Nome da implantação para o modelo AOAI. Exemplo: gpt-4o se em AIServices ou baseado `connection_name/deployment_name` em conexão (ou seja, `my-aoai-connection/gpt-4o`.
type	string: AzureOpenAIModel	Tipo de configuração do modelo.

RedTeam

Object

Detalhes da equipe vermelha.

Name	Tipo	Default value	Description
applicationScenario	string		Cenário de aplicação para a operação da equipe vermelha, para gerar ataques específicos do cenário.
attackStrategies	AttackStrategy[]		Lista de estratégias de ataque ou listas aninhadas de estratégias de ataque.
displayName	string		Nome da equipe vermelha executada.
id	string		Identificador da corrida da equipe vermelha.
numTurns	integer (int32)		Número de rondas de simulação.
properties	object		Propriedades da equipa vermelha. Ao contrário das tags, as propriedades são somente add-only. Uma vez adicionada, uma propriedade não pode ser removida.
riskCategories	RiskCategory[]		Lista de categorias de risco para gerar objetivos de ataque.
simulationOnly	boolean	False	Apenas simulação ou simulação + avaliação. Default false, se true a verificação produz conversa e não resultado da avaliação.
status	string		Estatuto da equipa vermelha. Ele é definido por serviço e é somente leitura.
tags	object		Tags do time vermelho. Ao contrário das propriedades, as tags são totalmente mutáveis.
target	TargetConfig: AzureOpenAIModelConfiguration		Configuração de destino para a execução da equipe vermelha.

RiskCategory

Enumeração

Categoria de risco para o objetivo de ataque.

Valor	Description
HateUnfairness	Representa conteúdo relacionado ao ódio ou injustiça.
SelfHarm	Representa conteúdo relacionado à automutilação.
Sexual	Representa conteúdo de natureza sexual.
Violence	Representa conteúdo relacionado à violência.

Partilhar via

Red Teams - Get

Parâmetros do URI

Cabeçalho do Pedido

Respostas

Segurança

OAuth2Auth

Âmbitos

Exemplos

RedTeams_Get_MaximumSet

Pedido de amostra

Resposta da amostra

Definições

AttackStrategy

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

AzureOpenAIModelConfiguration

RedTeam

RiskCategory