Creare il primo connettore Copilot sincronizzato con il toolkit Agenti di Microsoft 365

Suggerimento

Consigliato: Inizia con Work IQ Dev Tools per scenari di agenti dichiarativi e plug-in pro-code supportati. Vedere la guida introduttiva di WIQD. Le istruzioni basate su toolkit rimangono disponibili per i progetti e i flussi di lavoro esistenti che le richiedono. Controlla il supporto per le funzionalità e l'esperienza di destinazione prima di scegliere uno strumento: WIQD non si rivolge agli agenti del motore personalizzato.

Questa procedura dettagliata mantiene il modello di connettore sincronizzato di Toolkit. Crea un servizio di acquisizione, non la configurazione del connettore MCP remoto utilizzata da un plug-in WIQD.

I connettori di Microsoft 365 Copilot consentono di inserire i dati line-of-business in Microsoft Graph per renderli disponibili a Microsoft 365 Copilot. Quando i dati vengono acquisiti, Copilot può analizzarli e usarli per rispondere alle richieste degli utenti.

Questa procedura dettagliata crea un connettore Copilot sincronizzato in grado di fornire l'accesso ai dati esterni come componente di un plug-in di Microsoft 365 Copilot. Non crea o impacchetta un plug-in completo.

Il Toolkit per agenti di Microsoft 365 include un modello che è possibile usare per creare connettori Copilot. Il modello di connettore Copilot è progettato per semplificare la creazione rapida di connettori usando l'API connettore Copilot in Microsoft Graph. Il modello esegue lo scaffolding di un connettore che esegue il pull dei dati dall'API GitHub in Microsoft Graph. Dopo aver compilato il connettore, è possibile eseguirlo in locale tramite l'esperienza F5 o distribuirlo tramite Funzioni di Azure.

Questo articolo illustra i passaggi per creare il primo connettore Copilot usando il toolkit Microsoft 365 Agents in Visual Studio Code.

Prima di iniziare, verifica che il piano del componente identifichi un connettore sincronizzato come modello appropriato e che Microsoft 365 Agents Toolkit supporti l'esperienza di destinazione. Per indicazioni per la pianificazione, vedere Connettori come funzionalità del plug-in.

Nota

Questa procedura dettagliata crea un connettore sincronizzato. Non crea un connettore federato, un plug-in MCP, un server MCP o un connettore agente.

Cosa costruisci

In questa procedura dettagliata, Agents Toolkit esegue lo scaffolding di un'implementazione di connettore sincronizzato che recupera i problemi di GitHub. Quando si esegue il progetto, il toolkit esegue il provisioning di un'applicazione Microsoft Entra, crea una connessione esterna e uno schema in Microsoft Graph e inserisce elementi esterni dal repository GitHub configurato.

Il connettore è un componente della soluzione. Completa separatamente eventuali componenti aggiuntivi del plug-in, quindi integrali e testali insieme.

Prerequisiti

Per completare i passaggi descritti in questo articolo, sono necessari i prerequisiti seguenti:

Creare il primo connettore personalizzato

Usare la procedura seguente per creare il primo connettore.

  1. Nella barra laterale di Visual Studio Code, scegli il toolkit Microsoft 365 Agents Crea > un nuovo agente/app.

    Menu Toolkit agenti di Microsoft 365

  2. Selezionare il connettore Copilot.

    Selezione progetti

  3. Immetti Github Issues il nome del connettore.

  4. Creare un ID univoco a livello di tenant per il connettore. Per informazioni dettagliate sui requisiti per l'ID connettore, vedere la proprietà id della risorsa externalConnection.

  5. Selezionare Cartella predefinita per archiviare la cartella principale del progetto nella posizione predefinita.

  6. Configura il repository da cui vuoi estrarre i .env.local problemi utilizzando il CONNECTOR_REPOS campo nel file.

    env-local-file

  7. Premere F5 per eseguire il connettore in locale. Il toolkit crea un'app Microsoft Entra per il connettore e avvia il processo di provisioning.

  8. Segui il collegamento nel terminale per accedere all'Interfaccia di amministrazione di Microsoft Entra e seleziona Concedi consenso amministratore.

    Nota

    Per completare questo passaggio, è necessario essere un Amministratore globale dell'organizzazione.

    Pulsante Concedi consenso amministratore nell'interfaccia di amministrazione di Microsoft Entra

  9. L'app crea la connessione, registra lo schema e quindi esegue una ricerca per indicizzazione completa per inserire gli elementi.

    Nota

    La registrazione dello schema potrebbe richiedere fino a 10 minuti.

  10. Al termine della ricerca per indicizzazione completa, nell'interfaccia di amministrazione di Microsoft 365:

    • Nel riquadro sinistro passare a Impostazioni>,Cerca & Intelligence>Origini dati.

    • Individuare l'ID connessione.

    • Scegliere Includi risultati connettore.

      Pulsante Includi risultati connettore nell'interfaccia di amministrazione di Microsoft 365

      Nota

      Per completare questo passaggio, è necessario essere un amministratore di Amministrazione della ricerca. Questo passaggio consente l'uso dei risultati del connettore da parte di Microsoft 365 Copilot Chat. Se si intende usare questo connettore solo come origine delle informazioni per un agente dichiarativo, questo passaggio non è necessario.

    Suggerimento

    Se è necessario cercare l'ID connessione a livello di programmazione anziché nell'interfaccia di amministrazione, è possibile eseguire una query sui connettori esistenti in Graph Explorer usando l'ambito ExternalConnection.Read.All .

  11. Per verificare che gli elementi siano stati indicizzati, scegliere il nome del connettore pertinente. Controllare il campo Elementi indicizzati per vedere quanti problemi sono stati indicizzati.

    Github rilascia il connettore con 11 elementi indicizzati visualizzati

  12. Apri Microsoft 365 Copilot Chat e testa una richiesta di esempio come "Quali sono i due problemi di GitHub più recenti?". Nota le citazioni degli elementi esterni in fondo alla pagina. Queste citazioni sono i dati del connettore Copilot.

    Output di M365 Copilot con problemi relativi a Github

Questo test conferma che il connettore funziona in modo indipendente. Non convalida un pacchetto di plug-in completo né conferma che il connettore funzioni con altri componenti del plug-in.

Personalizzare il modello per l'origine dati

Per personalizzare questo modello per i dati personalizzati, è possibile aggiornare il contenuto delle cartelle seguenti:

  • src/custom: contiene codice personalizzato per raccogliere e trasformare i dati da inserire in Microsoft Graph. Anche se nell'esempio viene usata l'API GitHub Issues, è possibile sostituirla con qualsiasi altra API.

  • src/references: include la definizione dello schema del connettore. Modificalo in base ai dati e ai metadati che desideri acquisire.

  • src/models: contiene la definizione del modello per una rappresentazione interna dei dati e della configurazione. Entrambi i modelli possono essere personalizzati in base alle tue esigenze.

Oltre a queste cartelle, puoi personalizzare altre parti del codice, a seconda dello scenario. È possibile cercare commenti nel codice che iniziano con la [Customization point] stringa. Questi commenti indicano aree di potenziale personalizzazione.

Passaggio successivo

Usare i controlli di integrazione del connettore per verificare l'autenticazione, lo schema, l'indicizzazione, l'aggiornamento e le autorizzazioni. Include test di fallimento e limite per autenticazione scaduta, accesso negato e connessioni o origini dati non disponibili.

Registrare l'ID connessione, lo schema, l'ambiente, le autorizzazioni, le prove di test e il proprietario del connettore nel record di implementazione. Se il plug-in include altri componenti, compilali prima di integrare e testare i componenti del plug-in.