Bicep 자원 정의
계정/프로젝트/애플리케이션/에이전트 배포 자원 유형은 다음을 대상으로 하는 작업으로 배포할 수 있습니다:
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft를 만드는 것. CognitiveServices/accounts/projects/applications/agentDeployments 리소스, 템플릿에 다음 Bicep를 추가하세요.
resource symbolicname 'Microsoft.CognitiveServices/accounts/projects/applications/agentDeployments@2026-05-15-preview' = {
parent: resourceSymbolicName
name: 'string'
properties: {
agents: [
{
agentId: 'string'
agentName: 'string'
agentVersion: 'string'
}
]
deploymentId: 'string'
description: 'string'
displayName: 'string'
protocols: [
{
protocol: 'string'
version: 'string'
}
]
state: 'string'
tags: {
{customized property}: 'string'
}
deploymentType: 'string'
// For remaining properties, see AgentDeploymentProperties objects
}
}
AgentDeploymentProperties 객체
deploymentType 속성을 설정하여 개체 형식을 지정합니다.
호스팅의 경우 다음을 사용합니다.
{
deploymentType: 'Hosted'
maxReplicas: int
minReplicas: int
}
관리형의 경우 다음을 사용합니다.
{
deploymentType: 'Managed'
}
속성 값
Microsoft. CognitiveServices/accounts/projects/applications/agentDeployments
| 이름 | Description | 가치 |
|---|---|---|
| 이름 | 리소스 이름 | string(필수) |
| parent | Bicep에서는 자식 리소스의 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다. 자세한 내용은 부모 리소스외부의 자식 리소스 |
유형의 리소스에 대한 기호 이름: 계정/프로젝트/애플리케이션 |
| properties | [필수] 엔터티의 추가 특성입니다. | AgentDeploymentProperties (필수) |
AgentDeploymentProperties
| 이름 | Description | 가치 |
|---|---|---|
| agents | 이 배포에 배포된 agent:version의 플랫 목록을 반환합니다. | 버전 관리 에이전트 참조[] |
| deploymentId | 배포의 고유 식별자를 가져오거나 설정합니다. | 문자열 |
| deploymentType | HostedAgentDeployment 형식에 대해 'Hosted'로 설정합니다. ManagedAgentDeployment 형식에 대해 '관리됨'으로 설정합니다. | '호스팅됨' '관리'(필수) |
| description | 자산 설명 텍스트입니다. | 문자열 |
| 디스플레이 이름 | 배포의 표시 이름을 가져오거나 설정합니다. | 문자열 |
| protocols | 이 배포에서 노출되는 지원되는 프로토콜 유형 및 버전을 가져오거나 설정합니다. | 에이전트프로토콜 버전[] |
| 주 | 배포의 현재 작동 상태(및 본질적으로 구성 에이전트의 상태)를 가져오거나 설정합니다. | '삭제됨' '삭제 중' '실패' 'Running' '시작 중' 'Stopped' '중지' '업데이트 중' |
| tags | 태그 사전입니다. 태그를 추가, 제거 및 업데이트할 수 있습니다. | ResourceBaseTags |
에이전트 프로토콜 버전
| 이름 | Description | 가치 |
|---|---|---|
| protocol | 에이전트에서 사용하거나 배포에서 노출하는 프로토콜입니다. | 'A2A' '에이전트' '응답' |
| version | 프로토콜의 버전입니다. | 문자열 |
HostedAgent배포
| 이름 | Description | 가치 |
|---|---|---|
| deploymentType | 에이전트에 대한 배포 유형을 가져오거나 설정합니다. | '호스팅'(필수) |
| maxReplicas | 이 호스팅된 배포에 대한 최대 복제본 수를 가져오거나 설정합니다. | int Constraints: 최소값 = 0 |
| 최소 복제본 | 이 호스팅된 배포에 대한 최소 복제본 수를 가져오거나 설정합니다. | int Constraints: 최소값 = 0 |
ManagedAgentDeployment
| 이름 | Description | 가치 |
|---|---|---|
| deploymentType | 에이전트에 대한 배포 유형을 가져오거나 설정합니다. | '관리'(필수) |
ResourceBaseTags
| 이름 | Description | 가치 |
|---|
버전이 지정된 에이전트 참조
| 이름 | Description | 가치 |
|---|---|---|
| agentId | 조직(구독) 내에서 에이전트의 고유 식별자를 가져옵니다. | 문자열 |
| 에이전트 이름 | 에이전트의 이름(프로젝트/앱 내에서 고유함)을 가져옵니다. | 문자열 |
| 에이전트 버전 | 에이전트의 버전을 가져옵니다(각 에이전트 계보에 대해 고유). | 문자열 |
ARM 템플릿 리소스 정의
계정/프로젝트/애플리케이션/에이전트 배포 자원 유형은 다음을 대상으로 하는 작업으로 배포할 수 있습니다:
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft를 만드는 것. CognitiveServices/accounts/projects/applications/agentDeployments 리소스, 템플릿에 다음 JSON 파일을 추가하세요.
{
"type": "Microsoft.CognitiveServices/accounts/projects/applications/agentDeployments",
"apiVersion": "2026-05-15-preview",
"name": "string",
"properties": {
"agents": [
{
"agentId": "string",
"agentName": "string",
"agentVersion": "string"
}
],
"deploymentId": "string",
"description": "string",
"displayName": "string",
"protocols": [
{
"protocol": "string",
"version": "string"
}
],
"state": "string",
"tags": {
"{customized property}": "string"
},
"deploymentType": "string"
// For remaining properties, see AgentDeploymentProperties objects
}
}
AgentDeploymentProperties 객체
deploymentType 속성을 설정하여 개체 형식을 지정합니다.
호스팅의 경우 다음을 사용합니다.
{
"deploymentType": "Hosted",
"maxReplicas": "int",
"minReplicas": "int"
}
관리형의 경우 다음을 사용합니다.
{
"deploymentType": "Managed"
}
속성 값
Microsoft. CognitiveServices/accounts/projects/applications/agentDeployments
| 이름 | Description | 가치 |
|---|---|---|
| API버전 | api 버전 | '2026-05-15-미리보기 |
| 이름 | 리소스 이름 | string(필수) |
| properties | [필수] 엔터티의 추가 특성입니다. | AgentDeploymentProperties (필수) |
| type | 리소스 종류 | 'Microsoft. CognitiveServices/accounts/project/applications/agentDeployments' |
AgentDeploymentProperties
| 이름 | Description | 가치 |
|---|---|---|
| agents | 이 배포에 배포된 agent:version의 플랫 목록을 반환합니다. | 버전 관리 에이전트 참조[] |
| deploymentId | 배포의 고유 식별자를 가져오거나 설정합니다. | 문자열 |
| deploymentType | HostedAgentDeployment 형식에 대해 'Hosted'로 설정합니다. ManagedAgentDeployment 형식에 대해 '관리됨'으로 설정합니다. | '호스팅됨' '관리'(필수) |
| description | 자산 설명 텍스트입니다. | 문자열 |
| 디스플레이 이름 | 배포의 표시 이름을 가져오거나 설정합니다. | 문자열 |
| protocols | 이 배포에서 노출되는 지원되는 프로토콜 유형 및 버전을 가져오거나 설정합니다. | 에이전트프로토콜 버전[] |
| 주 | 배포의 현재 작동 상태(및 본질적으로 구성 에이전트의 상태)를 가져오거나 설정합니다. | '삭제됨' '삭제 중' '실패' 'Running' '시작 중' 'Stopped' '중지' '업데이트 중' |
| tags | 태그 사전입니다. 태그를 추가, 제거 및 업데이트할 수 있습니다. | ResourceBaseTags |
에이전트 프로토콜 버전
| 이름 | Description | 가치 |
|---|---|---|
| protocol | 에이전트에서 사용하거나 배포에서 노출하는 프로토콜입니다. | 'A2A' '에이전트' '응답' |
| version | 프로토콜의 버전입니다. | 문자열 |
HostedAgent배포
| 이름 | Description | 가치 |
|---|---|---|
| deploymentType | 에이전트에 대한 배포 유형을 가져오거나 설정합니다. | '호스팅'(필수) |
| maxReplicas | 이 호스팅된 배포에 대한 최대 복제본 수를 가져오거나 설정합니다. | int Constraints: 최소값 = 0 |
| 최소 복제본 | 이 호스팅된 배포에 대한 최소 복제본 수를 가져오거나 설정합니다. | int Constraints: 최소값 = 0 |
ManagedAgentDeployment
| 이름 | Description | 가치 |
|---|---|---|
| deploymentType | 에이전트에 대한 배포 유형을 가져오거나 설정합니다. | '관리'(필수) |
ResourceBaseTags
| 이름 | Description | 가치 |
|---|
버전이 지정된 에이전트 참조
| 이름 | Description | 가치 |
|---|---|---|
| agentId | 조직(구독) 내에서 에이전트의 고유 식별자를 가져옵니다. | 문자열 |
| 에이전트 이름 | 에이전트의 이름(프로젝트/앱 내에서 고유함)을 가져옵니다. | 문자열 |
| 에이전트 버전 | 에이전트의 버전을 가져옵니다(각 에이전트 계보에 대해 고유). | 문자열 |
사용 예제
Terraform(AzAPI 공급자) 리소스 정의
계정/프로젝트/애플리케이션/에이전트 배포 자원 유형은 다음을 대상으로 하는 작업으로 배포할 수 있습니다:
- 리소스 그룹
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft를 만드는 것. CognitiveServices/accounts/projects/applications/agentDeployments 리소스, 템플릿에 다음 Terraform을 추가하세요.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.CognitiveServices/accounts/projects/applications/agentDeployments@2026-05-15-preview"
name = "string"
parent_id = "string"
body = {
properties = {
agents = [
{
agentId = "string"
agentName = "string"
agentVersion = "string"
}
]
deploymentId = "string"
description = "string"
displayName = "string"
protocols = [
{
protocol = "string"
version = "string"
}
]
state = "string"
tags = {
{customized property} = "string"
}
deploymentType = "string"
// For remaining properties, see AgentDeploymentProperties objects
}
}
}
AgentDeploymentProperties 객체
deploymentType 속성을 설정하여 개체 형식을 지정합니다.
호스팅의 경우 다음을 사용합니다.
{
deploymentType = "Hosted"
maxReplicas = int
minReplicas = int
}
관리형의 경우 다음을 사용합니다.
{
deploymentType = "Managed"
}
속성 값
Microsoft. CognitiveServices/accounts/projects/applications/agentDeployments
| 이름 | Description | 가치 |
|---|---|---|
| 이름 | 리소스 이름 | string(필수) |
| parent_id | 이 리소스의 부모인 리소스의 ID입니다. | 유형의 리소스 ID: 계정/프로젝트/애플리케이션 |
| properties | [필수] 엔터티의 추가 특성입니다. | AgentDeploymentProperties (필수) |
| type | 리소스 종류 | "Microsoft. CognitiveServices/accounts/projects/applications/agentDeployments@2026-05-15-preview" |
AgentDeploymentProperties
| 이름 | Description | 가치 |
|---|---|---|
| agents | 이 배포에 배포된 agent:version의 플랫 목록을 반환합니다. | 버전 관리 에이전트 참조[] |
| deploymentId | 배포의 고유 식별자를 가져오거나 설정합니다. | 문자열 |
| deploymentType | HostedAgentDeployment 형식에 대해 'Hosted'로 설정합니다. ManagedAgentDeployment 형식에 대해 '관리됨'으로 설정합니다. | '호스팅됨' '관리'(필수) |
| description | 자산 설명 텍스트입니다. | 문자열 |
| 디스플레이 이름 | 배포의 표시 이름을 가져오거나 설정합니다. | 문자열 |
| protocols | 이 배포에서 노출되는 지원되는 프로토콜 유형 및 버전을 가져오거나 설정합니다. | 에이전트프로토콜 버전[] |
| 주 | 배포의 현재 작동 상태(및 본질적으로 구성 에이전트의 상태)를 가져오거나 설정합니다. | '삭제됨' '삭제 중' '실패' 'Running' '시작 중' 'Stopped' '중지' '업데이트 중' |
| tags | 태그 사전입니다. 태그를 추가, 제거 및 업데이트할 수 있습니다. | ResourceBaseTags |
에이전트 프로토콜 버전
| 이름 | Description | 가치 |
|---|---|---|
| protocol | 에이전트에서 사용하거나 배포에서 노출하는 프로토콜입니다. | 'A2A' '에이전트' '응답' |
| version | 프로토콜의 버전입니다. | 문자열 |
HostedAgent배포
| 이름 | Description | 가치 |
|---|---|---|
| deploymentType | 에이전트에 대한 배포 유형을 가져오거나 설정합니다. | '호스팅'(필수) |
| maxReplicas | 이 호스팅된 배포에 대한 최대 복제본 수를 가져오거나 설정합니다. | int Constraints: 최소값 = 0 |
| 최소 복제본 | 이 호스팅된 배포에 대한 최소 복제본 수를 가져오거나 설정합니다. | int Constraints: 최소값 = 0 |
ManagedAgentDeployment
| 이름 | Description | 가치 |
|---|---|---|
| deploymentType | 에이전트에 대한 배포 유형을 가져오거나 설정합니다. | '관리'(필수) |
ResourceBaseTags
| 이름 | Description | 가치 |
|---|
버전이 지정된 에이전트 참조
| 이름 | Description | 가치 |
|---|---|---|
| agentId | 조직(구독) 내에서 에이전트의 고유 식별자를 가져옵니다. | 문자열 |
| 에이전트 이름 | 에이전트의 이름(프로젝트/앱 내에서 고유함)을 가져옵니다. | 문자열 |
| 에이전트 버전 | 에이전트의 버전을 가져옵니다(각 에이전트 계보에 대해 고유). | 문자열 |