Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Los agentes son básicamente aplicaciones para Microsoft 365. Comparten un esquema de manifiesto común, empaquetado de aplicaciones y proceso de distribución y administración. El manifiesto de la aplicación hace referencia al archivo de definición de los agentes declarativos en el copilotAgents objeto.
La forma de localizar un agente es ligeramente diferente de cómo se localizan otras funcionalidades (como pestañas, bots y extensiones de mensajes) en un manifiesto de aplicación de Microsoft 365.
Usa el mismo archivo de localización (por idioma) para las capacidades de la aplicación y los agentes de Teams. Sin embargo, mientras que en los archivos de idioma se hace referencia a todos los demás campos de manifiesto de la aplicación, en los archivos de idioma se hace referencia a los campos relacionados con el agente. A diferencia de las funcionalidades clásicas de la aplicación de Teams, que usan cadenas de idioma predeterminadas en el propio manifiesto de la aplicación, los agentes localizados requieren un archivo de idioma para el idioma predeterminado y para cada idioma adicional.
En este artículo se describe cómo agregar compatibilidad con otros idiomas (además del idioma predeterminado) para los agentes.
Actualización de los manifiestos de agente con claves tokenizadas
Actualice los manifiestos del agente declarativo o del complemento de API con claves tokenizadas (indicadas con corchetes dobles, por ejemplo [[PLUGIN_NAME]]) para cualquier valor de campo que desee localizar. Las claves de localización deben coincidir con esta expresión regular: ^[a-zA-Z_][a-zA-Z0-9_]*$
En el ejemplo siguiente se muestra un manifiesto de agente declarativo con valores tokenizados para su nombre y descripción.
{
"$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..."
}
Agregar localizationInfo al manifiesto de la aplicación
Agregue la sección al manifiesto de la localizationInfo aplicación, con etiquetas de idioma y rutas de acceso relativas a cada archivo de idioma admitido dentro del paquete de la aplicación.
Si el agente admite más de un idioma, debe especificar un archivo de idioma independiente para cada idioma admitido, incluido el idioma predeterminado.
En el ejemplo siguiente se muestra la sección en un manifiesto de la localizationInfo aplicación.
"localizationInfo": {
"defaultLanguageTag": "en",
"defaultLanguageFile": "en.json",
"additionalLanguages": [
{
"languageTag": "fr",
"file": "fr.json"
}
]
},
Si el agente no admite otros idiomas, las cadenas de idioma predeterminadas se representan dentro del propio archivo de manifiesto de la aplicación. Los paquetes de aplicaciones para un solo idioma no requieren un archivo de idioma independiente para el idioma predeterminado.
Cree un archivo de localización para cada idioma adicional
Cree un archivo de localización para cada idioma admitido con valores para las claves tokenizadas, utilizando los nombres de archivo especificados (para las defaultLanguageFile propiedades y file ) en el manifiesto de la aplicación en el paso anterior.
En el ejemplo siguiente se muestra un archivo de idioma, fr.json, con cadenas localizadas para las pestañas de agente y personal.
{
"$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 localizables en el manifiesto de la aplicación
Para cada archivo de idioma, especifique las siguientes propiedades del esquema de localización de aplicaciones que deben localizarse.
| Campo de manifiesto | Descripción | Longitud máxima | Requerido |
|---|---|---|---|
$schema |
La dirección URL al esquema de localización. Para los agentes, use devPreview: https://developer.microsoft.com/en-us/json-schemas/teams/vDevPreview/MicrosoftTeams.Localization.schema.json. La versión del esquema del manifiesto debe ser la misma para los archivos de localización y de manifiesto de la aplicación. |
✔️ | |
name.short |
Reemplaza el nombre corto del manifiesto de la aplicación por el valor proporcionado. | 30 caracteres | ✔️ |
name.full |
Reemplaza el nombre completo del manifiesto de la aplicación por el valor proporcionado | 100 caracteres | ✔️ |
description.short |
Reemplaza la descripción breve del manifiesto de la aplicación por el valor proporcionado. | 80 caracteres | ✔️ |
description.full |
Reemplaza la descripción completa del manifiesto de la aplicación por el valor proporcionado. | 4.000 caracteres | ✔️ |
| Pares clave-valor para cadenas localizadas en agentes | Para los agentes, use claves tokenizadas (como se especifica en la aplicación manifest.json, pero sin corchetes dobles) con sus valores localizados. Por ejemplo: "DA_Name": "Agent de Communications" |
||
| Pares JSONPath/valor para cadenas localizadas de cualquier otro componente de la aplicación | Para todos los demás componentes de la aplicación (Teams clásico), use expresiones JSONPath como claves para los valores localizados. Por ejemplo: "staticTabs[0].name": "Accueil" |
Para obtener más información, consulte Localizar la aplicación (Microsoft Teams) y la Referencia de esquema de localización.
Campos localizables en el manifiesto del agente declarativo
Los siguientes campos se pueden localizar dentro del manifiesto de agente declarativo.
| Campo de manifiesto | Descripción | Longitud máxima | Requerido |
|---|---|---|---|
name |
Nombre del agente declarativo. Debe contener al menos un carácter que no sea de espacio en blanco. | 100 caracteres | ✔️ |
description |
La descripción del agente declarativo. Debe contener al menos un carácter que no sea de espacio en blanco. | 1000 caracteres | ✔️ |
conversation_starters |
Una lista (matriz) de ejemplos de preguntas que el agente declarativo puede responder, donde cada ejemplo es un objeto con title y text, ambos localizables. |
12 objetos en la matriz |
Para obtener más información, consulte Referencia de manifiesto de agente declarativo.
Campos localizables en el manifiesto del complemento de API
Los siguientes campos se pueden localizar dentro del manifiesto del complemento de API.
| Campo de manifiesto | Descripción | Longitud máxima | Requerido |
|---|---|---|---|
name_for_human |
Un nombre corto y legible para el complemento. Debe contener al menos un carácter que no sea de espacio en blanco. | 20 caracteres | ✔️ |
description_for_model |
La descripción del complemento que se proporciona al modelo, incluido para qué sirve el complemento y en qué circunstancias sus funciones son relevantes. | 2.048 caracteres | |
description_for_human |
Una descripción legible por humanos del complemento. | 100 caracteres | ✔️ |
logo_url |
Una dirección URL usada para capturar un logotipo que puede usar el orquestador. | ||
legal_info_url |
Una URL absoluta que localiza un documento que contiene los términos de servicio del complemento. | ||
privacy_policy_url |
Una URL absoluta que localiza un documento que contiene la política de privacidad del complemento. | ||
conversation_starters |
Una lista (matriz) de ejemplos de preguntas que el complemento puede responder, donde cada ejemplo es un objeto con title y text, ambos localizables. |
Para obtener más información, consulta Referencia de manifiesto de complemento.