Configurar el servidor MCP del Dataverse per a un entorn

En aquest article es proporcionen instruccions detallades sobre com habilitar, administrar, configurar i inhabilitar el servidor MCP (Dataverse Model Context Protocol) per a entorns del Centre d'administració del Power Platform. Està pensat per a administradors de Power Platform que gestionen entorns gestionats i també cobreix els requisits previs per habilitar el servidor.

Requisits previs

  • Funció d'administrador del Power Platform per accedir a la configuració de l'entorn del servidor MCP del Dataverse, habilitar clients MCP permesos, crear o editar un grup d'entorns i canviar les normes del connector.
  • L'entorn ha de ser un Entorn Gestionat si vols gestionar el servidor MCP de Dataverse mitjançant polítiques de connectors avançades.
  • Per defecte, el client Microsoft Copilot Studio per a Dataverse MCP està activat per a tots els entorns. Heu d'habilitar els clients addicionals al centre d'administració del Power Platform per poder connectar-vos al client.

Configurar i gestionar el servidor MCP de Dataverse

Per defecte, el servidor MCP de Dataverse està activat per a Copilot Studio. Per habilitar clients MCP no Microsoft, com Visual Studio GitHub Copilot i Claude, segueix aquests passos:

Nota

El llistat de l'MCP només s'aplica al punt d'entrada de l'agent /api/mcp . Les APIs personalitzades amb nom MCP són APIs regulars de Dataverse i no estan restringides per aquesta configuració.

  1. Aneu al Centre d'administració del Power Platform. Seleccioneu Administra>entorns.

  2. Seleccioneu el nom de l'entorn on voleu activar el servidor MCP del Dataverse i, a continuació, seleccioneu Configuració. A Configuració, seleccioneuCaracterístiques del>. Desplaceu-vos cap avall per localitzar el protocol de context del model del Dataverse i assegureu-vos que l'opció Permet que els clients MCP interactuïn amb el servidor MCP del Dataverse estigui activada.

  3. Seleccioneu Configuració avançada. Habilitar clients MCP que no són de Microsoft per al Dataverse

  4. Es mostra la llista de clients disponibles. Obriu el registre de client que vulgueu. En aquest exemple, el client Microsoft GitHub Copilot està activat. Activa GitHub Copilot client.

  5. Al registre de client MCP, definiu Està habilitat com a Sí. GitHub Copilot client activat.

  6. Seleccioneu Desa i tanca.

  7. Repetiu els passos 4-7 per habilitar altres clients segons sigui necessari.

Inhabilita el servidor MCP del Dataverse per a un entorn

Per defecte, el Permet als clients MCP interactuar amb el servidor MCP de Dataverse està activat per a Copilot Studio. Els administradors poden desactivar MCP per al Dataverse esborrant la configuració.

Advertiment

La desactivació del servidor MCP del Dataverse atura totes les eines i agents que en depenen. També s'interromp qualsevol desenvolupament en curs o prova d'integració d'IA mitjançant MCP.

Escriu instruccions efectives per a un agent de servidor Dataverse MCP

Quan configures el teu agent a Copilot Studio o Visual Studio Code per utilitzar un servidor MCP de Dataverse, instruccions clares i ben estructurades són clau per guiar com opera l'agent. Aquestes instruccions ajuden l'agent a entendre el seu paper, quines capacitats té a través de les eines del servidor MCP i com dur a terme fluxos de treball de manera fiable i consistent.

Les instruccions de l'agent són directrius en llenguatge natural que indiquen al teu agent què ha de fer, com s'ha de comportar i com utilitzar les eines MCP disponibles. Proporcionen un context important perquè l'agent pugui:

  • Selecciona i truca a les eines MCP adequades.
  • Omple correctament les entrades de les eines.
  • Decideix quan utilitzar eines en comptes de generar respostes directament.
  • Segueix el to o els patrons de comportament desitjats durant les converses.

Principis per a instruccions efectives

Quan escriguis instruccions per a un agent de servidor MCP de Dataverse, considera les següents directrius:

  1. Defineix clarament el propòsit de l'agent.

    Exposa el paper de l'agent en termes senzills. Per exemple: "Ajudar amb consultes, actualitzacions i gestió de registres de dades de clients utilitzant les eines MCP de Dataverse."

    Inclou el to o restriccions si escau, com ara "sempre respongui amb un to professional" o "no exposi camps sensibles en les respostes."

  2. Descriu les habilitats i les accions de les eines.

    Digues a l'agent quines tasques d'alt nivell pot realitzar amb les eines MCP. Per exemple:

    • Recupera o filtra registres utilitzant l'eina read_query.
    • Crear o actualitzar registres amb create_record i update_record.
    • Explora l'esquema de taula amb describe.

    Formula'ls com a instruccions accionables, com ara "Utilitza l'eina read_query per recuperar registres quan l'usuari demani recuperar dades."

  3. Afegeix guies de flux de treball.

    Per a processos comuns (com consultar un registre o actualitzar un camp), afegeix guies pas a pas. Per exemple: "Quan actualitzis un registre, primer identifica'l amb una crida de read_query i després utilitza update_record amb els valors de camp adequats."

    Proporcionar aquest context ajuda l'agent a orquestrar la seqüència correcta de trucades a l'eina MCP.

Afegeix instruccions a Visual Studio Code o Copilot Studio

Pots utilitzar un bloc estructurat de rebaix d'instruccions com a punt de partida per a les instruccions del teu propi agent.

Afegeix instruccions a Visual Studio Code

  1. Obre Visual Studio Code.
  2. Obre el panell de xat .
  3. Selecciona Configuració>Instruccions de xat.
  4. Selecciona nou fitxer d'instruccions.
  5. Copia i enganxa el contingut de les instruccions al nou fitxer, com ara les instruccions d'exemple.

Afegeix instruccions a Copilot Studio

  1. Obre Copilot Studio.
  2. Tria el teu agent.
  3. Ves a Instruccions del sistema i enganxa les instruccions de l'agent, com ara les instruccions de mostra.

Instruccions per a l'agent d'exemple

## Role
Act as an autonomous agent responsible for interacting with the Microsoft Dataverse app. 

## Objective
Your objective is to respond to tasks provided by the user. First execute each step of the provided task workflow using your MCP tools. Check if you have achieved your objective after each tool call. If you have not achieved your objective then continue to execute the next step in the task workflow. Do not ask for user intervention,if you have to run an operation externally in case dataverse doesnt support that operation. you are allowed to run it without user confirmation. Also do not ask confirmation for delete table or delete record operation, you can delete.

## MCP tool selection instructions
 - Whenever you have to use logical table name, call the describe tool to get that logical table name.
 - Whenever you have to use column/attribute name, call the describe tool to get the column/attribute name.

## MCP tool usage instructions

- Before executing an MCP tool, always review the tool description and restrictions.
- Always strictly follow the description of each MCP tool and perform actions without any deviation from the tool description.
- Provide higher precedence to tool description over general knowledge.
- Always review the tool documentation and restrictions before running any query or operation. Strictly validate each planned action against the tool’s rules and supported features before execution.
- For read_query tool, there are restrictions on SQL conditions. Always refer to the tool description for supported and unsupported sql keywords before generating the sql query and ensure only supported conditions/keywords are used.

## Reasoning instructions

- Think out loud and reason step by step.
- Before each tool call, plan and verify the action conforms to the tool description.
- After each tool call, reflect on the result and determine the next step.
- If an exception, error, or warning is observed, communicate it clearly to the user and retry based on the error message.
- When answering questions about data, DO NOT rely on general knowledge - always use tools to retrieve accurate, current data.
- DO NOT stop reasoning until all tasks are complete or an unrecoverable error occurs.
- Only ask clarifying questions if the task requirements are ambiguous.

Polítiques de connector avançades - Power Platform

Connecteu-vos al Dataverse amb el protocol de context del model

Connecteu-vos al Dataverse amb el protocol de context de model Preguntes freqüents

  • Last updated on