Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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:
Node.js, versioni supportate: 18, 20, 22
Una licenza di Microsoft 365 Copilot o un tenant Microsoft 365 Developer con caricamento app personalizzate abilitato.
Nota
Per testare il connettore in Microsoft 365 Copilot Chat, è necessaria una licenza di Microsoft 365 Copilot.
È necessario avere la possibilità di fornire il consenso dell'amministratore in Interfaccia di amministrazione di Microsoft Entra. È necessario essere o completare questo passaggio come amministratore globale. Vedere Concedere il consenso dell'amministratore a livello di tenant a un'applicazione per i ruoli richiesti.
L'utente deve avere il ruolo Amministratore ricerca, Sviluppatore di applicazioni cloud per vedere il connettore nell'interfaccia di amministrazione di Microsoft 365.
Creare il primo connettore personalizzato
Usare la procedura seguente per creare il primo connettore.
Nella barra laterale di Visual Studio Code, scegli il toolkit Microsoft 365 Agents Crea > un nuovo agente/app.
Selezionare il connettore Copilot.
Immetti
Github Issuesil nome del connettore.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.
Selezionare Cartella predefinita per archiviare la cartella principale del progetto nella posizione predefinita.
Configura il repository da cui vuoi estrarre i
.env.localproblemi utilizzando ilCONNECTOR_REPOScampo nel file.
Premere F5 per eseguire il connettore in locale. Il toolkit crea un'app Microsoft Entra per il connettore e avvia il processo di provisioning.
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.
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.
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.
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.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.
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.
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.
Contenuti correlati
- Connettori come funzionalità del plug-in
- Creare o riutilizzare connettori
- Integra e testa i componenti del plug-in
- Creare un pacchetto di un plug-in
- API connettori Copilot
- Panoramica di Microsoft 365 Agents Toolkit
- Esempi di connettori Copilot
- Esempi della community
- Trovare l'ID del connettore eseguendo una query sui connettori in Graph Explorer (ExternalConnection.Read.All)