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.
Recomendación
Recomendado: Comience con las herramientas de desarrollo de Work IQ para escenarios de complemento y agente declarativo de código profesional compatibles. Consulte el inicio rápido de WIQD. Las instrucciones basadas en el kit de herramientas siguen estando disponibles para los proyectos existentes y los flujos de trabajo que las requieren. Compruebe la compatibilidad con la capacidad y la experiencia de destino antes de elegir una herramienta: WIQD no se dirige a agentes de motor personalizados.
Este tutorial conserva la plantilla de conector sincronizado de Toolkit. Construye un servicio de ingesta, no la configuración del conector MCP remoto utilizada por un complemento WIQD.
Los conectores de Microsoft 365 Copilot permiten ingerir los datos de la línea de negocio en Microsoft Graph para que estén disponibles para Microsoft 365 Copilot. Cuando se ingieren los datos, Copilot puede razonar sobre los datos y usarlos para responder a las indicaciones de los usuarios.
Este tutorial crea un conector Copilot sincronizado que puede proporcionar acceso a datos externos como componente de un complemento de Microsoft 365 Copilot. No crea ni empaqueta un complemento completo.
El kit de herramientas de agentes de Microsoft 365 incluye una plantilla que puede usar para crear conectores de Copilot. La plantilla del conector de Copilot está diseñada para ayudarle a crear conectores rápidamente mediante la API del conector de Copilot en Microsoft Graph. La plantilla aplica scaffolding a un conector que extrae datos de la API de GitHub en Microsoft Graph. Después de compilar el conector, puede ejecutarlo localmente a través de la experiencia F5 o implementarlo a través de Azure Functions.
Este artículo proporciona un tutorial de los pasos para crear su primer conector de Copilot mediante el Kit de herramientas de agentes de Microsoft 365 en Visual Studio Code.
Antes de empezar, confirme que el plan de componentes identifica un conector sincronizado como el modelo adecuado y que Microsoft 365 Agents Toolkit admite su experiencia de destino. Para obtener instrucciones de planeación, consulte Conectores como funcionalidades del complemento.
Nota
Este tutorial compila un conector sincronizado. No crea un conector federado, un complemento de MCP, un servidor MCP o un conector de agente.
Lo que compila
En este tutorial, Agents Toolkit aplica scaffolding a una implementación de conector sincronizado que recupera problemas de GitHub. Al ejecutar el proyecto, el kit de herramientas aprovisiona una aplicación de Microsoft Entra, crea una conexión externa y un esquema en Microsoft Graph e ingiere elementos externos del repositorio de GitHub configurado.
El conector es un componente de la solución. Complete los componentes adicionales del complemento por separado y, a continuación, integre y pruebe los componentes juntos.
Requisitos previos
Para completar los pasos de este artículo, se requieren los siguientes requisitos previos:
Kit de herramientas de agentes de Microsoft 365 para Visual Studio Code
Node.js, versiones compatibles: 18, 20, 22
Una licencia de Microsoft 365 Copilot o un inquilino de desarrollador de Microsoft 365 con la carga de aplicaciones personalizadas habilitada.
Nota
Para probar el conector en Microsoft 365 Copilot Chat, necesita una licencia de Microsoft 365 Copilot.
Debe tener la capacidad de consentimiento de administrador en el Centro de administración de Microsoft Entra. Debe ser o completar este paso como Administrador global. Consulte Otorgar el consentimiento del administrador de todo el espacio empresarial a una aplicación para los roles necesarios.
El usuario debe tener el rol de Administrador de búsqueda, Desarrollador de aplicaciones en la nube para ver el conector en el Centro de administración de Microsoft 365.
Crear su primer conector personalizado
Siga estos pasos para crear su primer conector.
En la barra lateral de Visual Studio Code, elija el kit de herramientas > de agentes de Microsoft 365 Crear un nuevo agente o aplicación.
Seleccione el conector de Copilot.
Escriba
Github Issuescomo nombre del conector.Cree un identificador único para todo el espacio empresarial del conector. Para obtener más información sobre los requisitos del identificador de conector, consulte la propiedad id del recurso externalConnection.
Seleccione la carpeta predeterminada para almacenar la carpeta raíz del proyecto en la ubicación predeterminada.
Configure el repositorio del que desea extraer los problemas mediante el
CONNECTOR_REPOScampo del.env.localarchivo.
Presione F5 para ejecutar el conector localmente. El kit de herramientas crea una aplicación de Microsoft Entra para el conector e inicia el proceso de aprovisionamiento.
Siga el vínculo del terminal hasta el Centro de administración de Microsoft Entra y seleccione Conceder consentimiento del administrador.
Nota
Para completar este paso, debe ser un Administración global de su organización.
La aplicación crea la conexión, registra el esquema y, a continuación, realiza un rastreo completo para ingerir elementos.
Nota
El registro del esquema puede tardar hasta 10 minutos.
Una vez completado el rastreo completo, en el Centro de administración de Microsoft 365:
En el panel izquierdo, vaya a Configuración>Búsqueda & Fuentesde datos de inteligencia>.
Busque el identificador de conexión.
Elija Incluir resultados del conector.
Nota
Para completar este paso, debe ser un Administrador de búsqueda. Este paso permite que los resultados del conector los use Microsoft 365 Copilot Chat. Si solo va a usar este conector como un origen de conocimiento para un agente declarativo, este paso no es necesario.
Recomendación
Si necesita buscar el identificador de conexión mediante programación en lugar de en el centro de administración, puede consultar los conectores existentes en el Explorador de Graph mediante el
ExternalConnection.Read.Allámbito.Para comprobar que los elementos están indexados, elija el nombre del conector correspondiente. Compruebe el campo indexado Elementos para ver cuántos problemas se indexaron.
Abra Microsoft 365 Copilot Chat y pruebe un mensaje de ejemplo como "¿Cuáles son los dos problemas más recientes de GitHub?". Observe las citas de elementos externos en la parte inferior de la página. Estas citas son los datos del conector de Copilot.
Esta prueba confirma que el conector funciona de forma independiente. No valida un paquete de complementos completo ni confirma que el conector funcione con otros componentes de complemento.
Personalización de la plantilla para el origen de datos
Para personalizar esta plantilla para sus datos personalizados, puede actualizar el contenido de las siguientes carpetas:
src/custom: contiene código personalizado para recopilar y transformar datos que se ingerirán en Microsoft Graph. Aunque el ejemplo usa la API de problemas de GitHub, puedes reemplazarla por cualquier otra API.src/references: incluye la definición de esquema del conector. Ajústela para que coincida con los datos y metadatos que desea ingerir.src/models: contiene la definición de modelo para una representación interna de los datos y la configuración. Ambos modelos se pueden personalizar para adaptarse a sus necesidades.
Además de estas carpetas, puede personalizar otras partes del código, según el contexto. Puede buscar comentarios en el código que empiecen por la [Customization point] cadena. Estos comentarios indican áreas de posible personalización.
Siguiente paso
Use las comprobaciones de integración del conector para comprobar la autenticación, el esquema, la indexación, la actualización y los permisos. Incluya pruebas de errores y límites para autenticación expirada, acceso denegado y conexiones o orígenes de datos no disponibles.
Registre el identificador de conexión, el esquema, el entorno, los permisos, las pruebas de prueba y el propietario del conector en el registro de implementación. Si tu complemento incluye otros componentes, compílalos antes de integrar y probar los componentes de tu complemento.
Contenido relacionado
- Conectores como funcionalidades de complemento
- Compilar o reutilizar conectores
- Integrar y probar los componentes del plugin
- Empaquetar un complemento
- API de conectores de Copilot
- Información general del kit de herramientas de agentes de Microsoft 365
- Ejemplos de conectores de Copilot
- Ejemplos de la comunidad
- Para buscar el identificador del conector, consulte los conectores en el Explorador de Graph (ExternalConnection.Read.All)