Localizar seu agente

Os agentes são essencialmente aplicativos para o Microsoft 365. Eles compartilham um esquema de manifesto comum, empacotamento de aplicativos e processo de distribuição e gerenciamento. O manifesto do aplicativo faz referência ao arquivo de definição para seus agentes declarativos no copilotAgents objeto.

A maneira como você localiza um agente é um pouco diferente de como você localiza outros recursos (como guias, bots e extensões de mensagem) em um manifesto do aplicativo Microsoft 365.

Você usa o mesmo arquivo de localização (por idioma) para os recursos e agentes de aplicativos do Teams. No entanto, enquanto todos os outros campos de manifesto do aplicativo são referenciados usando expressões JSONPath nos arquivos de idioma, os campos relacionados ao agente são referenciados usando chaves de dicionário. Ao contrário dos recursos clássicos do aplicativo Teams, que usam cadeias de caracteres de idioma padrão no próprio manifesto do aplicativo, os agentes localizados exigem um arquivo de idioma para o idioma padrão e para cada idioma extra.

Este artigo descreve como adicionar suporte para outros idiomas (além do idioma padrão) aos seus agentes.

Atualizar os manifestos do agente com chaves tokenizadas

Atualize seu agente declarativo e/ou manifestos de plug-in de API com chaves tokenizadas (indicadas com colchetes duplos, por exemplo [[PLUGIN_NAME]]) para todos os valores de campo que você deseja localizar. As chaves de localização devem corresponder a esta expressão regular: ^[a-zA-Z_][a-zA-Z0-9_]*$

O exemplo a seguir mostra um manifesto de agente declarativo com valores tokenizados para seu nome e descrição.

{
    "$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.0/schema.json",
    "name": "[[DA_Name]]",
    "description": "[[DA_Description]]",
    "instructions": "# You are an assistant..."
}

Adicionar localizationInfo ao manifesto do aplicativo

Adicione a seção ao manifesto do localizationInfo aplicativo, com marcas de idioma e caminhos relativos para cada arquivo de idioma com suporte no pacote do aplicativo.

Se o agente oferecer suporte a mais de um idioma, você deverá especificar um arquivo de idioma autônomo para cada idioma compatível, incluindo o idioma padrão.

O exemplo a seguir mostra a seção em um manifesto localizationInfo do aplicativo.

"localizationInfo": {
    "defaultLanguageTag": "en",
    "defaultLanguageFile": "en.json",
    "additionalLanguages": [
        {
            "languageTag": "fr",
            "file": "fr.json"
        }
    ]
},

Se o agente não for compatível com outros idiomas, as cadeias de caracteres de idioma padrão serão representadas no próprio arquivo de manifesto do aplicativo. Os pacotes de aplicativos de idioma único não exigem um arquivo de idioma separado para o idioma padrão.

Criar um arquivo de localização para cada idioma extra

Crie um arquivo de localização para cada idioma com suporte com valores para as chaves tokenizadas, usando os nomes de arquivo especificados (para as defaultLanguageFile propriedades and file ) no manifesto do aplicativo na etapa anterior.

O exemplo a seguir mostra um arquivo de idioma, fr.json, com cadeias de caracteres localizadas nas guias um agente e pessoal.

{
    "$schema": "https://developer.microsoft.com/json-schemas/teams/vDevPreview/MicrosoftTeams.Localization.schema.json",
    "name.short": "Agent de Communications",
    "name.full": "Agent pour les Communications",
    "description.short": "Outils pour les professionnels de la communication",
    "description.full": "Outils pour les professionnels de la communication Contoso, y compris la galerie de ressources et les assistants personnels",
    "localizationKeys": {
        "DA_Name": "Agent de Communications",
        "DA_Description": "Un assistant pour les professionnels de la communication et des relations publiques chez Contoso."
    },
    "staticTabs[0].name": "Accueil",
    "staticTabs[1].name": "Galerie de ressources",
    "staticTabs[2].name": "À propos de Contoso"
}

Campos localizáveis no manifesto do aplicativo

Para cada arquivo de idioma, especifique as seguintes propriedades do esquema de localização do aplicativo que precisam ser localizadas.

Para saber mais, consulte Localizar seu aplicativo (Microsoft Teams) e a referência do esquema de localização.

Campos localizáveis no manifesto do agente declarativo

Os campos a seguir podem ser localizados no manifesto do agente declarativo.

Para saber mais, consulte Referência do manifesto do agente declarativo.

Campos localizáveis no manifesto do plug-in da API

Os campos a seguir podem ser localizados no manifesto do plug-in da API.

Para saber mais, consulte Referência do manifesto do plug-in.

Conteúdo relacionado

• Pacote do aplicativo agente