Red Teams - Get

Odwołanie

Usługa:: AI Foundry

Wersja interfejsu API:: 2025-05-15-preview

Zdobądź redteam według nazwy.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string (uri)	Punkt końcowy projektu. W formie "https://.services.ai.azure.com/api/projects/_project" , jeśli centrum Foundry ma tylko jeden projekt lub użyć domyślnego projektu w centrum. Lub w formie "https://.services.ai.azure.com/api/projects/" , jeśli chcesz jawnie określić nazwę projektu odlewni.
name	path	True	string	Identyfikator biegu drużyny czerwonej.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
x-ms-client-request-id		string (uuid)	Nieprzezroczystym, globalnie unikatowym identyfikatorem ciągu generowanego przez klienta dla żądania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	RedTeam	Żądanie zakończyło się pomyślnie. Nagłówki x-ms-client-request-id: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Nieoczekiwana odpowiedź na błąd. Nagłówki x-ms-error-code: string

Nazwa

Typ

Opis

200 OK

RedTeam

Żądanie zakończyło się pomyślnie.

Nagłówki

x-ms-client-request-id: string

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Nagłówki

x-ms-error-code: string

Zabezpieczenia

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Zakresy

Nazwa	Opis
https://ai.azure.com/.default

Przykłady

RedTeams_Get_MaximumSet

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:: 200

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

Definicje

Nazwa	Opis
AttackStrategy	Strategie ataków.
Azure.Core.Foundations.Error	Obiekt błędu.
Azure.Core.Foundations.ErrorResponse	Odpowiedź zawierająca szczegóły błędu.
Azure.Core.Foundations.InnerError	Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi dotyczącymi interfejsu MICROSOFT One API — https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
AzureOpenAIModelConfiguration	Konfiguracja modelu usługi Azure OpenAI. Wersja interfejsu API zostanie wybrana przez usługę do wykonywania zapytań dotyczących modelu.
RedTeam	Szczegóły czerwonej drużyny.
RiskCategory	Kategoria ryzyka dla celu ataku.

AttackStrategy

Wyliczanie

Strategie ataków.

Wartość	Opis
ansii_attack	Wykorzystuje sekwencje ucieczki ANSI do manipulowania wyglądem i zachowaniem tekstu.
ascii_art	Generuje grafikę wizualną przy użyciu znaków ASCII, często używanych do celów kreatywnych lub zaciemnianych.
ascii_smuggler	Ukrywa dane w znakach ASCII, co utrudnia wykrywanie.
atbash	Implementuje szyfr Atbash, prosty szyfr podstawieniowy, w którym każda litera jest przypisywana do swojego odwrotnego odpowiednika.
base64	Koduje dane binarne do formatu tekstowego przy użyciu bazy 64, często używanej do transmisji danych.
baseline	Reprezentuje podstawowe bezpośrednie sondowanie przeciwstawne, które jest używane przez strategie ataku jako cel ataku.
binary	Konwertuje tekst na kod binarny reprezentujący dane w serii 0 i 1s.
caesar	Stosuje szyfr Cezara, szyfr podstawieniowy, który przesuwa znaki o stałą liczbę pozycji.
character_space	Zmienia tekst, dodając spacje między znakami, często używanymi do zaciemniania.
character_swap	Zamienia znaki w tekście, aby utworzyć odmiany lub zaciemnić oryginalną zawartość.
diacritic	Dodaje znaki diakrytyczne do znaków, zmieniając ich wygląd i czasami ich znaczenie.
difficult	Reprezentuje domyślny zestaw ataków o trudnej złożoności. Ataki o trudnej złożoności obejmują ataki, które wymagają dostępu do znacznych zasobów i wysiłku w celu wykonania ataku, takiego jak znajomość algorytmów opartych na wyszukiwaniu, a także generatywnego modelu sztucznej inteligencji.
easy	Reprezentuje domyślny zestaw łatwych ataków o złożoności. Łatwe ataki o złożoności wymagają mniej wysiłku, takiego jak tłumaczenie monitu na kodowanie, i nie wymagają żadnego dużego modelu językowego do konwersji lub orkiestracji.
flip	Przerzuca znaki od przodu do tyłu, tworząc efekt dublowany.
jailbreak	Wstrzykuje specjalnie spreparowane monity w celu obejścia zabezpieczeń sztucznej inteligencji, znane jako ataki UPIA (User Injected Prompt Attacks).
leetspeak	Przekształca tekst w leetspeak, formę kodowania, która zastępuje litery podobnymi liczbami lub symbolami.
moderate	Reprezentuje domyślny zestaw ataków o umiarkowanej złożoności. Ataki o umiarkowanej złożoności wymagają dostępu do zasobów, takich jak inny generatywny model sztucznej inteligencji.
morse	Koduje tekst do kodu Morse, używając kropek i kreski do reprezentowania znaków.
rot13	Stosuje szyfr ROT13, prosty szyfr podstawienia, który przesuwa znaki o 13 pozycji.
string_join	Łączy ze sobą wiele ciągów, często używanych do łączenia lub zaciemniania.
suffix_append	Dołącza sufiks przeciwnika do monitu.
unicode_confusable	Używa znaków Unicode, które wyglądają podobnie do standardowych znaków, tworząc zamieszanie wizualne.
unicode_substitution	Podstawia standardowe znaki odpowiednikami Unicode, często w celu zaciemniania.
url	Koduje tekst do formatu adresu URL.

Azure.Core.Foundations.Error

Objekt

Obiekt błędu.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
details	Azure.Core.Foundations.Error[]	Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu.
innererror	Azure.Core.Foundations.InnerError	Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.
message	string	Czytelna dla człowieka reprezentacja błędu.
target	string	Element docelowy błędu.

Azure.Core.Foundations.ErrorResponse

Objekt

Odpowiedź zawierająca szczegóły błędu.

Nazwa	Typ	Opis
error	Azure.Core.Foundations.Error	Obiekt błędu.

Azure.Core.Foundations.InnerError

Objekt

Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi dotyczącymi interfejsu MICROSOFT One API — https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
innererror	Azure.Core.Foundations.InnerError	Błąd wewnętrzny.

AzureOpenAIModelConfiguration

Objekt

Konfiguracja modelu usługi Azure OpenAI. Wersja interfejsu API zostanie wybrana przez usługę do wykonywania zapytań dotyczących modelu.

Nazwa	Typ	Opis
modelDeploymentName	string	Nazwa wdrożenia dla modelu AOAI. Przykład: gpt-4o, jeśli w AIServices lub oparty `connection_name/deployment_name` na połączeniu (np. `my-aoai-connection/gpt-4o`.
type	string: AzureOpenAIModel	Typ konfiguracji modelu.

RedTeam

Objekt

Szczegóły czerwonej drużyny.

Nazwa	Typ	Domyślna wartość	Opis
applicationScenario	string		Scenariusz aplikacji dla operacji red team, w celu wygenerowania ataków specyficznych dla scenariusza.
attackStrategies	AttackStrategy[]		Lista strategii ataku lub zagnieżdżone listy strategii ataku.
displayName	string		Nazwa biegu czerwonej drużyny.
id	string		Identyfikator biegu drużyny czerwonej.
numTurns	integer (int32)		Liczba rund symulacji.
properties	object		Właściwości czerwonej drużyny. W przeciwieństwie do tagów właściwości są tylko do dodawania. Po dodaniu nie można usunąć właściwości.
riskCategories	RiskCategory[]		Lista kategorii ryzyka, dla których mają być generowane cele ataku.
simulationOnly	boolean	False	Tylko symulacja lub Symulacja + ocena. Wartość domyślna false, jeśli true skanowanie generuje wynik konwersacji, a nie wynik oceny.
status	string		Status czerwonej drużyny. Jest on ustawiany przez usługę i jest tylko do odczytu.
tags	object		Tagi czerwonej drużyny. W przeciwieństwie do właściwości tagi są w pełni modyfikowalne.
target	TargetConfig: AzureOpenAIModelConfiguration		Konfiguracja docelowa dla przebiegu red-team.

RiskCategory

Wyliczanie

Kategoria ryzyka dla celu ataku.

Wartość	Opis
HateUnfairness	Reprezentują treści związane z nienawiścią lub niesprawiedliwością.
SelfHarm	Reprezentuje treści związane z samookaleczeniem.
Sexual	Reprezentuje treści o charakterze seksualnym.
Violence	Reprezentują treści związane z przemocą.

Udostępnij za pośrednictwem

Red Teams - Get

Parametry identyfikatora URI

Nagłówek żądania

Odpowiedzi

Zabezpieczenia

OAuth2Auth

Zakresy

Przykłady

RedTeams_Get_MaximumSet

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

AttackStrategy

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

AzureOpenAIModelConfiguration

RedTeam

RiskCategory