Integración con aplicaciones nativas mediante el SDK de cliente de agentes

Importante

Este contenido está diseñado para profesionales de TI experimentados, como administradores de TI o desarrolladores, que están familiarizados con las herramientas de desarrollo, las utilidades y los entornos de desarrollo integrados (IDE). La creación de esta integración requiere experiencia en el desarrollo de software.

El SDK de cliente de agentes es un SDK para plataformas Android, iOS y Windows. Este SDK le permite comunicarse con agentes desarrollados mediante Copilot Studio o el SDK de agentes de Microsoft 365, desde aplicaciones nativas de Android, iOS y Windows.

Con el SDK de Cliente de Agentes, estamos introduciendo la multimodalidad en la interacción del usuario con el agente. Los usuarios ahora pueden comunicarse con agentes a través de texto o voz, al compartir contexto a través de imágenes o captura de pantalla.

La primera versión del SDK admite la comunicación basada en texto y la representación de tarjetas adaptables para usuarios finales no autenticados o anónimos con agentes creados en Copilot Studio. Puede agregar tarjetas adaptables a temas mediante la opción Preguntar con tarjeta adaptable .

Importante

Actualmente, el SDK solo admite usuarios no autenticados y se puede usar en aplicaciones nativas si considera que este uso es adecuado y necesario para los usuarios finales.

Configuración del agente para aplicaciones nativas

  1. Vaya a su agente en Copilot Studio seleccionando Agentes y, a continuación, su agente.

  2. En Configuración>Autenticación de seguridad>, seleccione Sin autenticación.

    Captura de pantalla de la configuración de seguridad Sin autenticación habilitada para un agente en Copilot Studio.

  3. Vaya a la página Canales del agente.

    Con La opción Sin autenticación seleccionada, se recomienda una revisión.

    Captura de pantalla de la página de Canales del agente que muestra una revisión recomendada debido a la falta de selección de autenticación.

  4. Seleccione Publicar.

    Aparece la pantalla Publicar este agente .

    Captura de pantalla de la pantalla de confirmación de publicación del agente en Copilot Studio.

  5. Seleccione Publicar. El agente se publica y está disponible para su uso con el SDK de cliente.

Obtenga la información que necesita para integrar con el SDK.

Antes de agregar la integración del agente al código de la aplicación, necesita algunos detalles de Copilot Studio sobre el agente.

  1. Vaya a su agente en Copilot Studio seleccionando Agentes y, a continuación seleccione su agente.

  2. Vaya a Configuración>Opciones avanzadas>Metadatos.

    Anote el identificador de entorno y el nombre del esquema.

    Captura de pantalla de la página Configuración avanzada que muestra environmentID y nombre de esquema para el agente.

  3. Tenga en cuenta el entorno de implementación para su agente. Para copilotstudio.microsoft.com y copilotstudio.preview.microsoft.com, el entorno de implementación es prod. Para copilotstudio.preprod.microsoft.com, el entorno de implementación es preprod.

Más información sobre el SDK de cliente de agentes

A continuación, con la información recopilada, puede integrar su agente en el código de su aplicación nativa utilizando el SDK del cliente de agentes.

Para obtener código y más información sobre cómo integrar el agente en la aplicación nativa, consulte el repositorio de GitHub para la plataforma de aplicaciones que prefiera:

  • Last updated on