Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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.
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.