다음을 통해 공유


az cognitiveservices agent

이 명령 그룹은 미리 보기 상태이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

파운드리 에이전트를 제어합니다.

명령

Name Description 형식 상태
az cognitiveservices agent create

컨테이너 이미지 또는 소스 코드에서 호스트된 새 에이전트를 만듭니다.

Core Preview
az cognitiveservices agent delete

호스트된 에이전트 버전 또는 모든 버전을 삭제합니다.

Core Preview
az cognitiveservices agent delete-deployment

호스트된 에이전트 배포를 삭제합니다.

Core Preview
az cognitiveservices agent list

에이전트를 나열합니다.

Core Preview
az cognitiveservices agent list-versions

호스트된 에이전트의 모든 버전을 나열합니다.

Core Preview
az cognitiveservices agent show

호스트된 에이전트의 세부 정보를 표시합니다.

Core Preview
az cognitiveservices agent start

호스트된 에이전트 배포를 시작합니다.

Core Preview
az cognitiveservices agent stop

호스트된 에이전트 배포를 중지합니다.

Core Preview
az cognitiveservices agent update

호스트된 에이전트 배포를 업데이트합니다.

Core Preview

az cognitiveservices agent create

미리 보기

명령 그룹 'cognitiveservices 에이전트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

컨테이너 이미지 또는 소스 코드에서 호스트된 새 에이전트를 만듭니다.

미리 빌드된 컨테이너 이미지를 지정하거나 소스 코드에서 빌드하여 호스트된 새 에이전트 배포를 만듭니다. --source를 사용하는 경우 컨테이너 이미지가 자동으로 빌드되고 Azure Container Registry로 푸시됩니다. 컴퓨팅 리소스, 크기 조정 동작, 환경 변수 및 통신 프로토콜을 구성합니다.

az cognitiveservices agent create --account-name
                                  --name
                                  --project-name
                                  [--build-remote]
                                  [--cpu]
                                  [--description]
                                  [--dockerfile]
                                  [--env --environment-variables]
                                  [--image]
                                  [--max-replicas]
                                  [--memory]
                                  [--min-replicas]
                                  [--no-start]
                                  [--protocol {responses, streaming}]
                                  [--protocol-version]
                                  [--registry]
                                  [--skip-acr-check]
                                  [--source]
                                  [--timeout]

예제

기존 컨테이너 이미지에서 에이전트 만들기

az cognitiveservices agent create \
  --account-name myAccount \
  --project-name myProject \
  --name my-agent \
  --image myregistry.azurecr.io/my-agent:v1.0

원본에서 빌드하여 에이전트 만들기(빌드 방법 자동 검색)

az cognitiveservices agent create \
  --account-name myAccount \
  --project-name myProject \
  --name my-agent \
  --source ./my-agent-code \
  --registry myregistry

사용자 지정 Dockerfile 이름을 사용하여 원본에서 빌드하여 에이전트 만들기

az cognitiveservices agent create \
  --account-name myAccount \
  --project-name myProject \
  --name my-agent \
  --source ./my-agent-code \
  --dockerfile Dockerfile.prod \
  --registry myregistry

ACR 작업을 사용하여 원격으로 빌드하여 에이전트 만들기

az cognitiveservices agent create \
  --account-name myAccount \
  --project-name myProject \
  --name my-agent \
  --source ./my-agent-code \
  --registry myregistry \
  --build-remote

사용자 지정 CPU 및 메모리를 사용하여 에이전트 만들기

az cognitiveservices agent create \
  --account-name myAccount \
  --project-name myProject \
  --name my-agent \
  --image myregistry.azurecr.io/my-agent:v2.0 \
  --cpu 2 \
  --memory 4Gi

크기 조정 구성을 사용하여 에이전트 만들기

az cognitiveservices agent create \
  --account-name myAccount \
  --project-name myProject \
  --name my-agent \
  --image myregistry.azurecr.io/my-agent:v1.0 \
  --min-replicas 2 \
  --max-replicas 10

환경 변수를 사용하여 에이전트 만들기

az cognitiveservices agent create \
  --account-name myAccount \
  --project-name myProject \
  --name my-agent \
  --image myregistry.azurecr.io/my-agent:v1.0 \
  --env MODEL_NAME=gpt-4 API_TIMEOUT=30 LOG_LEVEL=info

스트리밍 프로토콜을 사용하여 에이전트 만들기

az cognitiveservices agent create \
  --account-name myAccount \
  --project-name myProject \
  --name my-agent \
  --image myregistry.azurecr.io/my-agent:v1.0 \
  --protocol streaming \
  --protocol-version v1

짧은 레지스트리 이름을 사용하여 에이전트 만들기

az cognitiveservices agent create \
  --account-name myAccount \
  --project-name myProject \
  --name my-agent \
  --image my-agent:v1.0 \
  --registry myregistry

큰 이미지에 대한 시간 제한이 연장된 에이전트 만들기

az cognitiveservices agent create \
  --account-name myAccount \
  --project-name myProject \
  --name my-agent \
  --image myregistry.azurecr.io/my-large-agent:v1.0 \
  --timeout 1200

필수 매개 변수

--account-name -a

Cognitive Services 계정의 이름입니다.

--name -n

만들 에이전트의 이름입니다.

--project-name -p

AI Foundry 프로젝트의 이름입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--build-remote

Azure Container Registry 작업을 사용하여 원격 빌드를 강제 적용합니다.

기본적으로 CLI는 Docker를 사용할 수 있는 경우 로컬로 빌드하려고 시도하며, 그렇지 않으면 원격으로 빌드됩니다. 이 플래그를 사용하여 원격 빌드를 강제 적용합니다. --source가 지정된 경우에만 사용됩니다.

속성
Default value: False
--cpu

CPU 할당(기본값: 1코어).

속성
Default value: 1
--description

에이전트에 대한 사람이 읽을 수 있는 설명입니다.

--dockerfile

원본 디렉터리에 있는 Dockerfile의 이름입니다(기본값은 'Dockerfile').

--source가 지정된 경우에만 사용됩니다.

속성
Default value: Dockerfile
--env --environment-variables

key=value 형식의 환경 변수입니다.

'key1=value1 key2=value2' 형식의 공백으로 구분된 목록입니다.

--image

에이전트에 사용할 태그가 있는 Docker 이미지 URI입니다.

태그를 포함한 전체 Docker 이미지 URI(예: myregistry.azurecr.io/myagent:v1.0). 태그는 사용할 컨테이너 이미지 버전을 식별합니다. AI Foundry 서비스는 에이전트 버전을 독립적으로 자동으로 만들고 관리합니다. --source와 함께 사용할 수 없습니다.

--max-replicas

크기 조정을 위한 최대 복제본 수입니다(기본값은 3).

--memory

단위를 사용한 메모리 할당(기본값: 2Gi).

2기비바이트에는 '2Gi', 512메비트에는 '512Mi'와 같은 단위를 사용합니다.

속성
Default value: 2Gi
--min-replicas

크기 조정을 위한 최소 복제본 수입니다(기본값은 0).

--no-start

에이전트 버전을 만든 후 자동 배포를 건너뜁니다. 배포를 시작하지 않고 에이전트 버전을 만드는 데 사용합니다. --min-replicas 또는 --max-replicas와 함께 사용할 수 없습니다.

속성
Default value: False
--protocol

통신 프로토콜(응답 또는 스트리밍).

속성
Default value: responses
허용되는 값: responses, streaming
--protocol-version

프로토콜 버전(기본값: v1).

속성
Default value: v1
--registry

Azure Container Registry 이름 또는 전체 URI입니다.

짧은 이름(예: 'myregistry')이 myregistry.azurecr.io 확장됩니다. 전체 URI(myregistry.azurecr.io)도 허용됩니다. --source를 사용할 때 필요합니다.

--skip-acr-check

프로젝트 관리 ID가 컨테이너 레지스트리에 액세스할 수 있는 유효성 검사를 건너뜁니다. 사용자 할당 ID, 서비스 주체, 네트워크 수준 권한 또는 검사에서 검색할 수 없는 다른 방법을 통해 액세스가 구성된 경우 사용합니다.

속성
Default value: False
--source

Dockerfile을 포함하는 원본 디렉터리의 경로입니다.

제공되면 소스 코드에서 Docker 이미지를 빌드하고 ACR로 푸시합니다. 이미지는 로컬로(Docker를 사용할 수 있는 경우) 또는 ACR 작업을 사용하여 원격으로 빌드됩니다. --image와 함께 사용할 수 없습니다.

--timeout

배포가 준비될 때까지 대기하는 최대 시간(초)입니다.

기본값은 600초(10분)입니다. 큰 컨테이너 이미지 또는 느린 네트워크 조건의 경우 증가합니다. 배포 프로세스에는 컨테이너 이미지 끌어와 컨테이너 시작 및 상태 검사가 포함됩니다.

속성
Default value: 600
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az cognitiveservices agent delete

미리 보기

명령 그룹 'cognitiveservices 에이전트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

호스트된 에이전트 버전 또는 모든 버전을 삭제합니다.

agent_version 제공된 경우 해당 버전과 연결된 에이전트 인스턴스 및 에이전트 정의를 삭제합니다. agent_version 제공되지 않으면 에이전트 이름과 연결된 모든 에이전트 인스턴스 및 에이전트 정의를 삭제합니다.

az cognitiveservices agent delete --account-name
                                  --name
                                  --project-name
                                  [--agent-version]

필수 매개 변수

--account-name -a

Cognitive Service 계정 이름입니다.

--name -n

Cognitive Services 호스팅 에이전트 이름입니다.

--project-name -p

AI 프로젝트 이름입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--agent-version

Cognitive Services 호스팅 에이전트 버전입니다. 제공되지 않으면 모든 버전을 삭제합니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az cognitiveservices agent delete-deployment

미리 보기

명령 그룹 'cognitiveservices 에이전트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

호스트된 에이전트 배포를 삭제합니다.

에이전트 배포만 삭제하고 배포와 연결된 에이전트 버전은 그대로 유지됩니다.

az cognitiveservices agent delete-deployment --account-name
                                             --agent-version
                                             --name
                                             --project-name

필수 매개 변수

--account-name -a

Cognitive Service 계정 이름입니다.

--agent-version

Cognitive Services 호스팅 에이전트 버전입니다.

--name -n

Cognitive Services 호스팅 에이전트 이름입니다.

--project-name -p

AI 프로젝트 이름입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az cognitiveservices agent list

미리 보기

명령 그룹 'cognitiveservices 에이전트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

에이전트를 나열합니다.

az cognitiveservices agent list --account-name
                                --project-name

필수 매개 변수

--account-name -a

Cognitive Service 계정 이름입니다.

--project-name -p

AI 프로젝트 이름입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az cognitiveservices agent list-versions

미리 보기

명령 그룹 'cognitiveservices 에이전트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

호스트된 에이전트의 모든 버전을 나열합니다.

az cognitiveservices agent list-versions --account-name
                                         --name
                                         --project-name

필수 매개 변수

--account-name -a

Cognitive Service 계정 이름입니다.

--name -n

Cognitive Services 호스팅 에이전트 이름입니다.

--project-name -p

AI 프로젝트 이름입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az cognitiveservices agent show

미리 보기

명령 그룹 'cognitiveservices 에이전트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

호스트된 에이전트의 세부 정보를 표시합니다.

az cognitiveservices agent show --account-name
                                --name
                                --project-name

필수 매개 변수

--account-name -a

Cognitive Service 계정 이름입니다.

--name -n

Cognitive Services 호스팅 에이전트 이름입니다.

--project-name -p

AI 프로젝트 이름입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az cognitiveservices agent start

미리 보기

명령 그룹 'cognitiveservices 에이전트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

호스트된 에이전트 배포를 시작합니다.

az cognitiveservices agent start --account-name
                                 --agent-version
                                 --name
                                 --project-name

예제

호스트된 에이전트 배포를 시작합니다.

az cognitiveservices agent start --account-name myAccount --project-name myProject --name myAgent --agent-version 1

필수 매개 변수

--account-name -a

Cognitive Service 계정 이름입니다.

--agent-version

Cognitive Services 호스팅 에이전트 버전입니다.

--name -n

Cognitive Services 호스팅 에이전트 이름입니다.

--project-name -p

AI 프로젝트 이름입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az cognitiveservices agent stop

미리 보기

명령 그룹 'cognitiveservices 에이전트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

호스트된 에이전트 배포를 중지합니다.

az cognitiveservices agent stop --account-name
                                --agent-version
                                --name
                                --project-name

예제

호스트된 에이전트 배포를 시작합니다.

az cognitiveservices agent stop --account-name myAccount --project-name myProject --name myAgent --agent-version 1

필수 매개 변수

--account-name -a

Cognitive Service 계정 이름입니다.

--agent-version

Cognitive Services 호스팅 에이전트 버전입니다.

--name -n

Cognitive Services 호스팅 에이전트 이름입니다.

--project-name -p

AI 프로젝트 이름입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az cognitiveservices agent update

미리 보기

명령 그룹 'cognitiveservices 에이전트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

호스트된 에이전트 배포를 업데이트합니다.

az cognitiveservices agent update --account-name
                                  --agent-version
                                  --name
                                  --project-name
                                  [--description]
                                  [--max-replicas]
                                  [--min-replicas]
                                  [--tags]

예제

호스트된 에이전트 배포를 시작합니다.

az cognitiveservices agent update --account-name myAccount --project-name myProject --name myAgent --agent-version 1 --min-replicas 1 --max-replicas 2

필수 매개 변수

--account-name -a

Cognitive Service 계정 이름입니다.

--agent-version

Cognitive Services 호스팅 에이전트 버전입니다.

--name -n

Cognitive Services 호스팅 에이전트 이름입니다.

--project-name -p

AI 프로젝트 이름입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--description

에이전트에 대한 설명입니다.

--max-replicas

수평 크기 조정을 위한 최대 복제본 수입니다.

--min-replicas

수평 크기 조정을 위한 최소 복제본 수입니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False