Vai al contenuto principale

Usare BrickDb da Microsoft Copilot

Quando hai finito

Un agente che crei in Microsoft Copilot Studio e usi in Microsoft 365 Copilot o Teams può lavorare con BrickDb, con l'accesso dell'account BrickDb di ciascuna persona.

Circa 15 minuti

Inizia

I passaggi

  1. Aggiungere BrickDb come strumento in Copilot Studio
  2. Inviaci l'URL di reindirizzamento
  3. Creare la connessione e pubblicare l'agente
  4. Microsoft 365 Copilot: un agente dichiarativo
  5. Scollegare BrickDb

Ti serve un account BrickDb gratuito. Il collegamento funziona solo per i membri registrati che accedono; senza accesso non è disponibile nulla, nemmeno la ricerca nel catalogo. Se non hai ancora un account, apri la tua pagina account e creane uno nella pagina di accesso che si apre. Se ti colleghi senza accedere, l'agente mostra BrickDb come non collegato o ti chiede di accedere, e nessuno degli strumenti di BrickDb si può usare.

L'agente lavora con il tuo account BrickDb e i tuoi permessi, e niente di più: è raggiungibile solo ciò che vedi in BrickDb, e si può modificare solo ciò che puoi modificare tu. Quello che chiedi di cercare in BrickDb entra nella tua conversazione e viene inviato a Microsoft, che lo tratta secondo le proprie condizioni. BrickDb non invia nulla di sua iniziativa a Microsoft.

Cosa si può fare oggi:

  • cercare nel catalogo e aprire un set;
  • mostrare a quanto si vende un set, e su quante vendite si basa la cifra;
  • leggere la tua collezione, aggiungere un esemplare, cambiarne lo stato o le note e rimuovere un esemplare (la rimozione chiede il numero del set come conferma);
  • elencare i pezzi che possiedi e calcolare quanto vale la tua collezione;
  • dire che cos'è un codice scansionato di una bustina di minifigure, e registrare cosa hai trovato in una bustina;
  • leggere i tuoi MOC e la galleria pubblica dei MOC.

Un account amministratore raggiunge inoltre gli strumenti dell'area di amministrazione, perché l'account ha quel ruolo. Altre parti di BrickDb, come la lista dei desideri, le minifigure e le foto, arriveranno passo dopo passo.

I nomi di menu e pulsanti sono riportati come appaiono in inglese; nella tua lingua possono essere diversi.

Questa guida riguarda Microsoft Copilot Studio, dove le organizzazioni creano i propri agenti e li pubblicano in Microsoft 365 Copilot e Teams. Serve Copilot Studio nella tua organizzazione. Non conosciamo un modo per aggiungere un server proprio all'app gratuita Microsoft Copilot. Chi chatta con l'agente accede con il proprio account BrickDb, e l'agente agisce con i permessi di quella persona.

Copilot Studio dà a ogni connessione un proprio indirizzo di ritorno, che l'accesso di BrickDb deve consentire prima che qualcuno possa accedere. Per questo il secondo passo è un messaggio a noi.

Aggiungere BrickDb come strumento in Copilot Studio

  1. Apri il tuo agente in Copilot Studio, o creane uno sotto Create → New agent.
  2. Apri Tools, scegli Add a tool, poi New tool e Model Context Protocol.
  3. Inserisci il nome del server BrickDb, una descrizione del suo scopo e l'URL del server https://mcp.brickdb.net/mcp.
  4. Sotto Authentication, scegli OAuth 2.0 e il tipo Manual, e inserisci: ID client Pin3wgdbREmDTblSI02tEiX40vAOD5hL; client secret vuoto; authorization URL https://auth.brickdb.net/authorize; token URL template e refresh URL entrambi https://auth.brickdb.net/oauth/token; scope openid profile email offline_access.
  5. Scegli Create. Copilot Studio mostra un redirect URL: copialo, poi scegli Next.

Inviaci l'URL di reindirizzamento

Invia l'URL di reindirizzamento tramite il modulo di assistenza e indica che è per Copilot Studio. Lo aggiungiamo all'accesso di BrickDb e ti avvisiamo. Fino ad allora l'accesso finisce su una pagina di errore, e nulla è collegato a metà.

Creare la connessione e pubblicare l'agente

  1. Nella finestra Add tool, scegli Create new connection, poi Create, e accedi nella pagina di accesso di BrickDb con il tuo account BrickDb.
  2. Scegli Add and configure.
  3. Per usare l'agente in Microsoft 365 Copilot o Teams, pubblicalo e aggiungi il canale Teams and Microsoft 365 Copilot sotto Channels.

La pagina di Microsoft: Connect your agent to an existing Model Context Protocol server.

Microsoft 365 Copilot: un agente dichiarativo

Se la tua organizzazione crea un agente dichiarativo per Microsoft 365 Copilot con un plugin MCP (ad esempio con il Microsoft 365 Agents Toolkit), registra OAuth in modo statico: ID client Pin3wgdbREmDTblSI02tEiX40vAOD5hL, nessun client secret, PKCE attivo, authorization URL https://auth.brickdb.net/authorize, URL di token e di refresh https://auth.brickdb.net/oauth/token, scope openid profile email offline_access. Il suo indirizzo di ritorno è fisso e l'accesso di BrickDb lo consente già, quindi non devi inviarci nulla: chi usa l'agente accede con il proprio account BrickDb.

Scollegare BrickDb

Rimuovi lo strumento BrickDb dall'agente sotto Tools ed elimina la sua connessione in Copilot Studio. L'agente non può più raggiungere BrickDb con l'account di nessuno.

Se l'accesso finisce su una pagina di errore, o qualcos'altro non funziona, scrivici tramite il modulo di assistenza.

Inizia Torna alle guide

Si è verificato un errore non gestito. Ricarica 🗙

Riconnessione al server in corso...

Riconnessione non riuscita. Nuovo tentativo tra secondi.

Impossibile riconnettersi. Riprova o ricarica la pagina.

La sessione è stata messa in pausa dal server.

Impossibile riprendere la sessione. Ricarica la pagina.