你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Red Teams - List

参考

服务:: AI Foundry

API 版本:: 2025-05-15-preview

按名称列出 redteam。

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

URI 参数

名称	在	必需	类型	说明
endpoint	path	True	string (uri)	Project 端点。在格式 “https://.services.ai.azure.com/api/projects/_project"如果您的 Foundry Hub 只有一个 Project，或者使用 Hub 中的默认 Project。或以 “https://.services.ai.azure.com/api/projects/"如果要显式指定 Foundry Project 名称。
api-version	query	True	string minLength: 1	用于此操作的 API 版本。

请求头

名称	必需	类型	说明
x-ms-client-request-id		string (uuid)	请求的不透明、全局唯一的客户端生成的字符串标识符。

响应

名称	类型	说明
200 OK	PagedRedTeam	请求已成功。标头 x-ms-client-request-id: string
Other Status Codes	Azure.Core.Foundations.ErrorResponse	意外的错误响应。标头 x-ms-error-code: string

名称

类型

说明

200 OK

PagedRedTeam

请求已成功。

标头

x-ms-client-request-id: string

Other Status Codes

Azure.Core.Foundations.ErrorResponse

意外的错误响应。

标头

x-ms-error-code: string

安全性

OAuth2Auth

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

作用域

名称	说明
https://ai.azure.com/.default

示例

RedTeams_List_MaximumSet

示例请求

HTTP

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

示例响应

状态代码:: 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"
}

定义

名称	说明
AttackStrategy	攻击策略。
Azure.Core.Foundations.Error	错误对象。
Azure.Core.Foundations.ErrorResponse	包含错误详细信息的响应。
Azure.Core.Foundations.InnerError	包含有关错误的更具体信息的对象。根据Microsoft一个 API 指南 - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。
AzureOpenAIModelConfiguration	Azure OpenAI 模型配置。 API 版本将由服务选择以查询模型。
PagedRedTeam	RedTeam 项的分页集合
RedTeam	红队详情。
RiskCategory	攻击目标的风险类别。

AttackStrategy

枚举

攻击策略。

值	说明
ansii_attack	利用 ANSI 转义序列来操作文本的外观和行为。
ascii_art	使用 ASCII 字符生成视觉艺术，通常用于创造性或混淆目的。
ascii_smuggler	在 ASCII 字符中隐藏数据，使检测难度更大。
atbash	实现 Atbash 密码，这是一个简单的替换密码，其中每个字母映射到其反向。
base64	使用 Base64 将二进制数据编码为文本格式，通常用于数据传输。
baseline	表示基线直接对抗性探测，攻击策略将其用作攻击目标。
binary	将文本转换为二进制代码，表示一系列 0 和 1 中的数据。
caesar	应用 Caesar 密码，这是一个替换密码，该密码将字符移入固定数目的位置。
character_space	通过添加字符之间的空格来更改文本，通常用于模糊处理。
character_swap	交换文本中的字符以创建变体或模糊处理原始内容。
diacritic	向字符添加变音符号，更改其外观，有时更改其含义。
difficult	表示一组默认的困难复杂性攻击。困难复杂性攻击包括需要访问大量资源并努力执行攻击的攻击，例如除了生成式 AI 模型之外，还需要了解基于搜索的算法。
easy	表示一组默认的 easy complexity 攻击。简单复杂性攻击需要较少的工作量，例如将提示转换为某种编码，并且不需要任何大型语言模型进行转换或编排。
flip	将字符从正面翻转到背面，创建出镜像效果。
jailbreak	注入特制提示以绕过 AI 防护措施，称为“用户注入提示攻击”（UPIA）。
leetspeak	将文本转换为 Leetspeak，这是一种编码形式，将字母替换为类似数字或符号。
moderate	表示一组默认的中等复杂度攻击。中等复杂度的攻击需要访问其他生成式 AI 模型等资源。
morse	使用点和短划线将文本编码为 Morse 代码，以表示字符。
rot13	应用 ROT13 密码，这是一个简单的替换密码，该密码将字符移入 13 个位置。
string_join	将多个字符串联接在一起，通常用于串联或混淆。
suffix_append	将 adversarial 后缀附加到提示符。
unicode_confusable	使用看起来类似于标准字符的 Unicode 字符，从而造成视觉混乱。
unicode_substitution	将标准字符替换为 Unicode 等效项，通常用于模糊处理。
url	将文本编码为 URL 格式。

Azure.Core.Foundations.Error

Object

错误对象。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
details	Azure.Core.Foundations.Error[]	导致此报告错误的特定错误的详细信息数组。
innererror	Azure.Core.Foundations.InnerError	包含与当前对象有关错误的更具体信息的对象。
message	string	有关错误的可读的表示形式。
target	string	错误的目标。

Azure.Core.Foundations.ErrorResponse

Object

包含错误详细信息的响应。

名称	类型	说明
error	Azure.Core.Foundations.Error	错误对象。

Azure.Core.Foundations.InnerError

Object

包含有关错误的更具体信息的对象。根据Microsoft一个 API 指南 - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
innererror	Azure.Core.Foundations.InnerError	内部错误。

AzureOpenAIModelConfiguration

Object

Azure OpenAI 模型配置。 API 版本将由服务选择以查询模型。

名称	类型	说明
modelDeploymentName	string	AOAI 模型的部署名称。示例：gpt-4o 如果在 AIServices 中或基于 `connection_name/deployment_name` 连接（即 `my-aoai-connection/gpt-4o`.
type	string: AzureOpenAIModel	模型配置的类型。

PagedRedTeam

Object

RedTeam 项的分页集合

名称	类型	说明
nextLink	string (uri)	指向下一页项的链接
value	RedTeam[]	此页面上的 RedTeam 项目

RedTeam

Object

红队详情。

名称	类型	默认值	说明
applicationScenario	string		应用场景为红队作，生成场景特定的攻击。
attackStrategies	AttackStrategy[]		攻击策略列表或攻击策略的嵌套列表。
displayName	string		红队运行的名称。
id	string		红队运行的标识符。
numTurns	integer (int32)		模拟轮次数。
properties	object		红队的属性。与标记不同，属性是仅添加属性。添加后，无法删除属性。
riskCategories	RiskCategory[]		要为其生成攻击目标的风险类别列表。
simulationOnly	boolean	False	仅仿真或仿真 + 评估。默认为 false，如果为 true，则扫描输出对话而不是评估结果。
status	string		红队的状态。它由服务设置，并且是只读的。
tags	object		红队的标签。与属性不同，标记完全可变。
target	TargetConfig: AzureOpenAIModelConfiguration		红队运行的目标配置。

RiskCategory

枚举

攻击目标的风险类别。

值	说明
HateUnfairness	表示与仇恨或不公平相关的内容。
SelfHarm	表示与自残相关的内容。
Sexual	表示性内容。
Violence	表示与暴力相关的内容。

通过

Red Teams - List

URI 参数

请求头

响应

安全性

OAuth2Auth

作用域

示例

RedTeams_List_MaximumSet

示例请求

示例响应

定义

AttackStrategy

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

AzureOpenAIModelConfiguration

PagedRedTeam

RedTeam

RiskCategory