이 문서에서는 Windows에서 에이전트 시작 관리자용 에이전트 정의 JSON 파일의 형식을 설명합니다. 이 파일은 빌드 작업이 "콘텐츠"로 설정되고 출력 디렉터리로 복사 가 "최신인 경우 복사"로 설정된 프로젝트에 포함되어야 합니다. 패키지 매니페스트 XML 파일에서 JSON 파일에 대한 패키지 상대 경로를 지정합니다.
에이전트 시작 관리자 등록은 에이전트 호출을 처리하는 앱 작업에 에이전트를 연결합니다. 앱 작업을 만드는 방법에 대한 자세한 내용은 Windows에서 에이전트 시작 관리자 시작을 참조하세요.
예제 에이전트 정의 JSON 파일
{
"manifest_version": "0.1.0",
"version": "1.0.0",
"name": "Zava.ZavaAgent",
"display_name": "ms-resource://zavaAgentDisplayName",
"description": "ms-resource://zavaAgentDescription",
"icon": "ms-resource://Files/Assets/ZavaLogo.png",
"action_id": "ZavaAgentAction"
}
에이전트 정의 JSON 속성
아래 표에서는 에이전트 정의 JSON 파일의 속성을 설명합니다.
문서 루트
| 재산 | 유형 | Description | 필수 |
|---|---|---|---|
| 매니페스트_버전 | 문자열 | 에이전트 정의 매니페스트의 스키마 버전입니다. 현재 버전은 "0.1.0"입니다. | Yes |
| version | 문자열 | 에이전트의 버전입니다. 의미 체계 버전 관리(예: "1.0.0")를 사용합니다. | Yes |
| 이름 | 문자열 | 일반적으로 역방향 도메인 표기법(예: "Zava.ZavaAgent")을 사용하는 에이전트의 고유 식별자입니다. 이 값은 지역화할 수 없으며 패키지 내에서 고유해야 합니다. | Yes |
| display_name | 문자열 | 에이전트의 사용자 연결 표시 이름입니다. 이 값은 앱 패키지에서 문자열 리소스를 ms-resource:// 참조하는 형식을 사용하여 지역화할 수 있습니다. |
Yes |
| description | 문자열 | 에이전트가 수행하는 일에 대한 사용자 측 설명입니다. 이 값은 앱 패키지에서 문자열 리소스를 ms-resource:// 참조하는 형식을 사용하여 지역화할 수 있습니다. |
Yes |
| icon | 문자열 | 에이전트의 아이콘입니다. 이 값은 형식을 ms-resource:// 사용하여 지역화하여 앱 패키지와 함께 배포된 아이콘 리소스를 참조할 수 있습니다. |
Yes |
| action_id | 문자열 | 이 에이전트의 호출을 처리할 앱 동작의 식별자입니다. 동일한 앱 패키지에 id 정의된 작업 필드와 일치해야 합니다. 연결된 앱 작업을 만드는 방법에 대한 자세한 내용은 Windows에서 에이전트 시작 관리자 시작을 참조하세요. |
Yes |
지역화
, display_name및 description 속성은 iconURI 체계를 ms-resource:// 통해 지역화를 지원합니다. 이를 통해 다양한 언어에 대해 지역화된 문자열 및 리소스를 제공할 수 있습니다.
문자열 리소스
문자열 속성을 지역화하려면 다음 형식을 사용합니다.
"display_name": "ms-resource://resourceName"
리소스 이름은 앱 패키지의 리소스 파일(.resw C# 프로젝트의 파일 또는 .rc C++ 프로젝트의 파일)에 정의된 문자열 리소스에 해당합니다.
아이콘 리소스
아이콘 속성을 지역화하려면 다음 형식을 사용합니다.
"icon": "ms-resource://Files/Assets/iconName.png"
경로는 패키지 루트를 기준으로 하며 앱의 리소스 시스템을 통해 다양한 언어에 대해 서로 다른 아이콘을 참조할 수 있습니다.
앱 작업과의 관계
각 에이전트 시작 관리자는 속성을 통해 action_id 앱 작업을 참조해야 합니다. 앱 작업은 다음을 포함하여 에이전트를 호출하는 방법을 정의합니다.
- 필수 입력 엔터티(
agentName및prompt) - 선택적 입력 엔터티(예:
attachedFile) - 호출 메커니즘(URI 활성화 또는 COM)
앱 작업 및 에이전트 시작 관리자가 동일한 앱 패키지에 있어야 합니다. 에이전트 시작 관리자가 호출되면 시스템은 action_id 해당 앱 동작을 찾아 적절한 입력으로 호출합니다.
에이전트 시작 관리자에 대한 앱 작업을 만드는 방법에 대한 자세한 내용은 Windows에서 에이전트 시작 관리자 시작을 참조하세요.