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.
Es posible que tenga agentes dentro de la organización que haya compilado mediante C#, JavaScript o Python y que estén hospedados en Azure u otra infraestructura de hospedaje. Estos agentes son experiencias especializadas que podrían centrarse en un área específica que usan servicios de inteligencia artificial y que ya están integrados en aplicaciones web o personalizadas. Puede usar microsoft 365 Agents Toolkit para exponer el agente en Microsoft 365 Copilot Chat. Esto permite a los usuarios usar la interfaz de usuario de Microsoft 365 Copilot unificada para trabajar con agentes creados en toda la empresa, lo que hace que los agentes sean más reconocibles y accesibles para los usuarios.
Use el SDK de agentes de Microsoft 365
Para incorporar el agente a Microsoft 365 Copilot, use microsoft 365 Agents Toolkit para integrar el agente con el SDK de agentes de Microsoft 365. El SDK de Agentes admite C#, JavaScript y Python. Si el agente está escrito en uno de estos idiomas, no es necesario modificarlo de forma significativa. Simplemente puede agregar el código del SDK de Agentes al agente y usar los adaptadores de canal integrados para implementar el agente en Microsoft 365 Copilot.
Los adaptadores de canal integrados de la SDK de agentes de Microsoft 365 admiten varios canales, incluidos Microsoft 365 Copilot. Al encapsular el agente existente con el SDK de agentes, puede integrarse con la Bot Service de Azure que se encuentra entre una superficie de usuario o un canal (como Microsoft 365 Copilot) y el código. Azure Bot Service traduce lo que ese canal envía y lo transforma en actividades comunes para que coincidan con lo que entiende el código en este caso, el contenedor del SDK de agentes que acepta mensajes entrantes de Azure Bot Service.
Modificación de componentes del agente
Para traer el agente a Copilot, necesita modificar algunos componentes del agente, como se describe en esta sección.
Se recomienda empezar con microsoft 365 Agents Toolkit y usar el ejemplo echo/empty agent (actualmente disponible en C# en Visual Studio y JavaScript en Visual Studio Code). Para familiarizarse con la estructura del SDK de Agentes, siga los pasos para probar e implementar el agente mediante el Kit de herramientas de agentes y el SDK; estas herramientas simplifican las tareas descritas.
Cree el registro de la aplicación y el registro de Azure Bot Service para controlar la comunicación del canal: el SDK de agentes de Microsoft 365 usa Azure Bot Service para controlar la comunicación entre los canales y el código y administrar los componentes relacionados con esos canales. Debe crear un recurso de Azure Bot Service con un registro de aplicación al que haga referencia manualmente en el agente.
Configuración de los agentes de escucha de eventos del agente: un agente creado con el SDK de agentes de Microsoft 365 está estructurado para escuchar eventos desde el canal, en este caso, Microsoft 365 Copilot. Para empezar, use OnActivity. Para ver eventos específicos, vea TurnContext y ActivityHandler.
Actualice la estructura del agente para que pueda controlar la actividad enviada desde Microsoft 365 Copilot a azure Bot Service. Para ello, agregue el agente existente a la estructura de un agente creado con SDK de agentes de Microsoft 365. No es necesario llamar específicamente a muchas actividades; un agente puede escuchar cualquier mensaje del cliente mediante el método OnActivity. A continuación, se puede agregar o hacer referencia al agente existente en el método que se desencadena a partir del evento al que se escucha y, por tanto, se ejecuta cada vez que se envía una actividad. Una actividad puede ser un mensaje u otro tipo de acción dentro del canal. Para obtener más información sobre los eventos, consulte la documentación de referencia.
Cree manualmente o genere un archivo de manifiesto mediante agents toolkit. Microsoft 365 Copilot requiere un paquete de .zip que contenga un archivo de manifiesto. El archivo de manifiesto incluye un conjunto de instrucciones para indicar a Microsoft 365 Copilot dónde buscar el agente y otra información. Microsoft 365 Copilot requiere que se hospede un agente y un punto de conexión vinculado a través de un registro de aplicación (id) y al que se haga referencia en un archivo de manifiesto. Si el agente se ejecuta en Teams, puede modificar el archivo de manifiesto existente para admitir el esquema más reciente para Microsoft 365 Copilot.
Los agentes conectados a Microsoft 365 Copilot pueden solicitar opcionalmente permiso al usuario para actuar en su nombre. Si decide usar esta funcionalidad, configúrela durante el proceso de instalación del agente en Azure Bot Service. Herramientas para empezar
El esfuerzo necesario para incorporar el agente a Copilot varía en función de la complejidad del agente y de si necesita agregar la administración de tokens para permitir que el agente use la identidad del usuario para limitar sus conocimientos.
Para empezar, use microsoft 365 Agents Toolkit y el ejemplo de agente de eco para crear el agente y seguir la documentación de Visual Studio o Visual Studio Code para probarlo e implementarlo. Esto le ayudará a familiarizarse con cómo funcionan conjuntamente el Kit de herramientas de agentes, el SDK de agentes y Microsoft 365 Copilot.