Localizza l'agente

Gli agenti sono essenzialmente app per Microsoft 365. Condividono uno schema di manifesto, una creazione di pacchetti di app e un processo di distribuzione e gestione comuni. Il manifesto dell'app fa riferimento al file di definizione per gli agenti dichiarativi nell'oggetto copilotAgents .

Il modo in cui si localizza un agente è leggermente diverso da quello di altre funzionalità (ad esempio schede, bot ed estensioni dei messaggi) in un manifesto di un'app di Microsoft 365.

Si usa lo stesso file di localizzazione (per lingua) per le funzionalità e gli agenti dell'app di Teams. Tuttavia, mentre in tutti gli altri campi manifesto dell'app viene fatto riferimento usando le espressioni JSONPath nei file di linguaggio, ai campi correlati all'agente viene fatto riferimento usando le chiavi del dizionario. A differenza delle funzionalità classiche dell'app Teams, che usano stringhe di lingua predefinite nel manifesto dell'app stessa, gli agenti localizzati richiedono un file di lingua per la lingua predefinita e per ogni lingua aggiuntiva.

Diagramma che mostra la relazione tra il manifesto dell'app, il manifesto dell'agente dichiarativo e un file di lingua ai fini della localizzazione di un agente

Questo articolo descrive come aggiungere il supporto per altre lingue (oltre alla lingua predefinita) ai tuoi agenti.

Aggiornare i manifesti dell'agente con chiavi tokenizzate

Aggiorna i manifesti dell'agente dichiarativo e/o del plug-in API con chiavi tokenizzate (indicate con doppie parentesi quadre, ad esempio [[PLUGIN_NAME]]) per tutti i valori di campo che vuoi localizzare. Le chiavi di localizzazione devono corrispondere a questa espressione regolare: ^[a-zA-Z_][a-zA-Z0-9_]*$

L'esempio seguente mostra un manifesto dell'agente dichiarativo con valori tokenizzati per il nome e la descrizione.

{
    "$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..."
}

Aggiungi localizationInfo al manifesto dell'app

Aggiungi la sezione al manifesto dell'app, con i tag di lingua e i localizationInfo percorsi relativi a ogni file di lingua supportato all'interno del pacchetto dell'app.

Se l'agente supporta più lingue, è necessario specificare un file di lingua autonomo per ogni lingua supportata, inclusa la lingua predefinita.

L'esempio seguente mostra la sezione in un manifesto dell'app localizationInfo .

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

Se l'agente non supporta altre lingue, le stringhe della lingua predefinita sono rappresentate all'interno del file manifesto dell'app stesso. I pacchetti di app in una sola lingua non richiedono un file di lingua separato per la lingua predefinita.

Crea un file di localizzazione per ogni lingua aggiuntiva

Crea un file di localizzazione per ogni lingua supportata con valori per le chiavi tokenizzate, usando i nomi file specificati (per le defaultLanguageFile proprietà e file ) nel manifesto dell'app nel passaggio precedente.

L'esempio seguente mostra un file di linguaggio, fr.jsoncon stringhe localizzate sia per una scheda agente che per quella personale.

{
    "$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"
}

Campi localizzabili nel manifesto dell'app

Per ogni file di lingua, specificate le seguenti proprietà dello schema di localizzazione dell'app che devono essere localizzate.

Campo manifesto Descrizione Lunghezza massima Obbligatorio
$schema URL dello schema di localizzazione. Per gli agenti, usare devPreview: https://developer.microsoft.com/en-us/json-schemas/teams/vDevPreview/MicrosoftTeams.Localization.schema.json. La versione dello schema manifesto deve essere la stessa per i file manifesto e di localizzazione dell'app. ✔️
name.short Sostituisce il nome breve del manifesto dell'app con il valore specificato. 30 caratteri ✔️
name.full Sostituisce il nome completo del manifesto dell'app con il valore fornito 100 caratteri ✔️
description.short Sostituisce la breve descrizione del manifesto dell'app con il valore specificato. 80 caratteri ✔️
description.full Sostituisce la descrizione completa del manifesto dell'app con il valore specificato. 4.000 caratteri ✔️
Coppie chiave/valore per stringhe localizzate negli agenti Per gli agenti, utilizzare chiavi tokenizzate (come specificato nell'app manifest.json, ma senza doppie parentesi quadre) con i relativi valori localizzati. Ad esempio: "DA_Name": "Agent de Communications"
Coppie JSONPath/valore per stringhe localizzate di qualsiasi altro componente dell'app Per tutti gli altri componenti dell'app (Teams classico), usare le espressioni JSONPath come chiavi per i valori localizzati. Ad esempio: "staticTabs[0].name": "Accueil"

Per altre informazioni, vedere Localizzare l'app (Microsoft Teams) e Riferimento allo schema di localizzazione.

Campi localizzabili nel manifesto dell'agente dichiarativo

I campi seguenti sono localizzabili all'interno del manifesto dell'agente dichiarativo.

Campo manifesto Descrizione Lunghezza massima Obbligatorio
name Nome dell'agente dichiarativo. Deve contenere almeno uno spazio non vuoto. 100 caratteri ✔️
description Descrizione dell'agente dichiarativo. Deve contenere almeno uno spazio non vuoto. 1.000 caratteri ✔️
conversation_starters Un elenco (matrice) di esempi di domande a cui l'agente dichiarativo può rispondere, dove ogni esempio è un oggetto con title e text, entrambi localizzabili. 12 oggetti nell'array

Per altre informazioni, vedere Informazioni di riferimento sui manifesti degli agenti dichiarativi.

Campi localizzabili nel manifesto del plug-in API

I campi seguenti sono localizzabili all'interno del manifesto del plug-in API.

Campo manifesto Descrizione Lunghezza massima Obbligatorio
name_for_human Nome breve e leggibile per il plug-in. Deve contenere almeno uno spazio non vuoto. 20 caratteri ✔️
description_for_model Descrizione del plug-in fornita al modello, inclusi lo scopo del plug-in e le circostanze in cui le sue funzioni sono rilevanti. 2.048 caratteri
description_for_human Descrizione leggibile del plug-in. 100 caratteri ✔️
logo_url URL usato per recuperare un logo che può essere usato dall'agente di orchestrazione.
legal_info_url URL assoluto che individua un documento contenente le condizioni di servizio per il plug-in.
privacy_policy_url URL assoluto che individua un documento contenente l'informativa sulla privacy per il plug-in.
conversation_starters Un elenco (matrice) di esempi di domande a cui il plugin può rispondere, dove ogni esempio è un oggetto con title e text, entrambi localizzabili.

Per altre informazioni, vedi Riferimento al manifesto del plug-in.