Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Este artigo descreve o formato do ficheiro JSON de definição de agente para Lançadores de Agentes no Windows. Este ficheiro deve ser incluído no seu projeto com a Ação de Compilação definida em "Conteúdo" e Copiar para o Diretório de Saída definida como "Copiar se for mais recente". Especifique o caminho relativo ao pacote para o arquivo JSON no arquivo XML do manifesto do pacote.
Um registo no Lançador de Agentes liga um agente a uma Ação de Aplicação que gere a invocação do agente. Para informações sobre como criar a Ação da Aplicação, consulte Começar com Lançadores de Agentes no Windows.
Exemplo de ficheiro JSON de definição de agente
{
"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"
}
Definição do agente Propriedades JSON
A tabela abaixo descreve as propriedades do ficheiro JSON de definição do agente.
Raiz do documento
| Propriedade | Tipo | Description | Obrigatório |
|---|---|---|---|
| manifest_version | cadeia (de caracteres) | A versão do esquema do manifesto de definição do agente. A versão atual é "0.1.0". | Yes |
| versão | cadeia (de caracteres) | A versão do teu agente. Use versionamento semântico (por exemplo, "1.0.0"). | Yes |
| nome | cadeia (de caracteres) | Um identificador único para o seu agente, normalmente usando notação de domínio inversa (por exemplo, "Zava.ZavaAgent"). Este valor não é localizável e deve ser único dentro do seu pacote. | Yes |
| display_name | cadeia (de caracteres) | O nome de visualização voltado para o utilizador do agente. Este valor é localizável usando o ms-resource:// formato para referenciar um recurso string no pacote da sua aplicação. |
Yes |
| descrição | cadeia (de caracteres) | Uma descrição dirigida ao utilizador do que o agente faz. Este valor é localizável usando o ms-resource:// formato para referenciar um recurso string no pacote da sua aplicação. |
Yes |
| icon | cadeia (de caracteres) | O ícone do agente. Este valor é localizável usando o ms-resource:// formato para referenciar um recurso de ícones implementado com o pacote da sua aplicação. |
Yes |
| action_id | cadeia (de caracteres) | O identificador da Ação de Aplicação que irá tratar das invocações deste agente. Isto deve corresponder ao id campo de uma ação definida no mesmo pacote da aplicação. Para informações sobre como criar a Ação de Aplicação associada, consulte Começar com Lançadores de Agentes no Windows. |
Yes |
Localização
As display_namepropriedades , description, e icon suportam a localização através do ms-resource:// esquema URI. Isto permite-lhe fornecer strings localizadas e recursos para diferentes línguas.
Recursos de cordas
Para localizar as propriedades das cadeias, use o seguinte formato:
"display_name": "ms-resource://resourceName"
O nome do recurso corresponde a um recurso string definido nos ficheiros de recursos do seu pacote de aplicação (.resw ficheiros para projetos C#, ou .rc ficheiros para projetos C++).
Recursos de ícones
Para localizar propriedades de ícones, use o seguinte formato:
"icon": "ms-resource://Files/Assets/iconName.png"
O caminho é relativo à raiz do teu pacote e pode referenciar ícones diferentes para diferentes línguas através do sistema de recursos da tua aplicação.
Relação com as Ações da Aplicação
Cada Lançador de Agente deve referenciar uma Ação de Aplicação através da action_id propriedade. A Ação App define como o agente é invocado, incluindo:
- Entidades de entrada necessárias (
agentNameeprompt) - Entidades de entrada opcionais (como
attachedFile) - O mecanismo de invocação (ativação do URI ou COM)
A App Action e o Agent Launcher devem estar no mesmo pacote de app. Quando um Lançador de Agentes é invocado, o sistema usa o action_id para localizar a Ação de Aplicação correspondente e invoca-a com os inputs apropriados.
Para informações detalhadas sobre como criar a Ação de Aplicação para o seu Lançador de Agentes, consulte Começar com Lançadores de Agentes no Windows.