Localizar el agente

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.

Diagrama que muestra la relación entre el manifiesto de la aplicación, el manifiesto de agente declarativo y un archivo de idioma con el fin de localizar un agente

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.