Une fois terminé
Un agent que tu crées dans Microsoft Copilot Studio et utilises dans Microsoft 365 Copilot ou Teams peut travailler avec BrickDb, connecté avec le compte BrickDb de chaque personne.
Les étapes
- Ajouter BrickDb comme outil dans Copilot Studio
- Envoie-nous l'URL de redirection
- Créer la connexion et publier l'agent
- Microsoft 365 Copilot : un agent déclaratif
- Déconnecter BrickDb
Il te faut un compte BrickDb gratuit. La connexion ne fonctionne que pour les membres inscrits qui se connectent ; sans connexion, rien n'est disponible, pas même la recherche dans le catalogue. Si tu n'as pas encore de compte, ouvre ta page de compte et crée-en un sur la page de connexion qui s'ouvre. Si tu te connectes sans t'identifier, l'agent affiche BrickDb comme non connecté ou te demande de te connecter, et aucun des outils de BrickDb n'est utilisable.
L'agent travaille avec ton compte BrickDb et tes droits, rien de plus : seul ce que tu vois dans BrickDb est accessible, et seul ce que tu peux modifier peut l'être. Ce que tu demandes de consulter dans BrickDb fait partie de ta conversation et est envoyé à Microsoft, qui le traite selon ses propres conditions. BrickDb n'envoie rien de lui-même à Microsoft.
Ce qui est possible aujourd'hui :
- chercher dans le catalogue et ouvrir un set ;
- montrer à quel prix un set se vend, et sur combien de ventes repose ce chiffre ;
- lire ta collection, ajouter un exemplaire, modifier son état ou ses notes, et retirer un exemplaire (le retrait demande le numéro du set en confirmation) ;
- lister les pièces que tu possèdes et calculer la valeur de ta collection ;
- dire ce qu'est un code de sachet de minifigurine scanné, et enregistrer ce que tu as trouvé dans un sachet ;
- lire tes propres MOC et la galerie publique de MOC.
Un compte administrateur accède en plus aux outils de l'espace d'administration, parce que le compte a ce rôle. D'autres parties de BrickDb, comme la liste de souhaits, les minifigurines et les photos, suivront peu à peu.
Les noms des menus et des boutons sont donnés ici tels qu'ils apparaissent en anglais ; dans ta langue, ils peuvent être différents.
Ce guide concerne Microsoft Copilot Studio, où les organisations créent leurs propres agents et les publient dans Microsoft 365 Copilot et Teams. Il faut Copilot Studio dans ton organisation. Nous ne connaissons aucun moyen d'ajouter un serveur personnel à l'application gratuite Microsoft Copilot. Chaque personne qui discute avec l'agent se connecte avec son propre compte BrickDb, et l'agent agit alors avec les droits de cette personne.
Copilot Studio donne à chaque connexion sa propre adresse de retour, que la connexion de BrickDb doit autoriser avant que quiconque puisse se connecter. C'est pourquoi la deuxième étape est un message pour nous.
Ajouter BrickDb comme outil dans Copilot Studio
- Ouvre ton agent dans Copilot Studio, ou crée-en un sous Create → New agent.
- Ouvre Tools, choisis Add a tool, puis New tool et Model Context Protocol.
- Saisis le nom de serveur
BrickDb, une description de son usage et l'URL du serveurhttps://mcp.brickdb.net/mcp. - Sous Authentication, choisis OAuth 2.0 et le type Manual, puis saisis : identifiant client
Pin3wgdbREmDTblSI02tEiX40vAOD5hL; secret client vide ; URL d'autorisationhttps://auth.brickdb.net/authorize; modèle d'URL de jeton et URL d'actualisation, toutes deuxhttps://auth.brickdb.net/oauth/token; étenduesopenid profile email offline_access. - Choisis Create. Copilot Studio affiche une URL de redirection : copie-la, puis choisis Next.
Envoie-nous l'URL de redirection
Envoie l'URL de redirection via le formulaire d'aide en précisant qu'elle est pour Copilot Studio. Nous l'ajoutons à la connexion de BrickDb et te prévenons. D'ici là, la connexion se termine sur une page d'erreur, et rien n'est à moitié connecté.
Créer la connexion et publier l'agent
- Dans la boîte de dialogue Add tool, choisis Create new connection, puis Create, et connecte-toi sur la page de connexion de BrickDb avec ton compte BrickDb.
- Choisis Add and configure.
- Pour utiliser l'agent dans Microsoft 365 Copilot ou Teams, publie-le et ajoute le canal Teams and Microsoft 365 Copilot sous Channels.
La page de Microsoft : Connect your agent to an existing Model Context Protocol server.
Microsoft 365 Copilot : un agent déclaratif
Si ton organisation crée un agent déclaratif pour Microsoft 365 Copilot avec un plugin MCP (par exemple avec le Microsoft 365 Agents Toolkit), enregistre OAuth pour lui de façon statique : identifiant client Pin3wgdbREmDTblSI02tEiX40vAOD5hL, pas de secret client, PKCE activé, URL d'autorisation https://auth.brickdb.net/authorize, URL de jeton et d'actualisation https://auth.brickdb.net/oauth/token, étendues openid profile email offline_access. Son adresse de retour est fixe et la connexion de BrickDb l'autorise déjà, tu n'as donc rien à nous envoyer : chaque personne qui utilise l'agent se connecte avec son propre compte BrickDb.
Déconnecter BrickDb
Retire l'outil BrickDb de l'agent sous Tools et supprime sa connexion dans Copilot Studio. L'agent ne peut alors plus atteindre BrickDb avec le compte de personne.
Si la connexion se termine sur une page d'erreur, ou si autre chose ne fonctionne pas, écris-nous via le formulaire d'aide.