Configurarea serverului Dataverse MCP pentru un mediu

Acest articol oferă instrucțiuni detaliate despre cum să activați, să gestionați, să configurați și să dezactivați serverul Dataverse Model Context Protocol (MCP) pentru mediile din centrul de administrare Power Platform. Este destinat administratorilor Power Platform care gestionează medii gestionate și acoperă, de asemenea, cerințele prealabile pentru activarea serverului.

Cerințe preliminare

• Rol de administrator Power Platform pentru a accesa setările mediului de server Dataverse MCP, pentru a activa clienții MCP permisi, pentru a crea sau edita un grup de mediu și pentru a modifica politicile conectorului.
• Pașii descriși în acest articol necesită ca mediul să fie un mediu gestionat.
• În mod implicit, serverul Dataverse MCP este activat pentru toate mediile din Microsoft Copilot Studio. Trebuie să activați clienții suplimentari în centrul de administrare Power Platform înainte de a vă putea conecta la client.

Configurarea și gestionarea serverului Dataverse MCP

În mod implicit, serverul MCP Dataverse este activat pentru Copilot Studio. Pentru a activa clienții non-Microsoft MCP, cum ar fi Visual Studio GitHub, Copilot și Claude, urmați acești pași:

1. Accesați Power Platform centrul de administrare. Selectați Gestionare>Medii.

2. Selectați numele mediului în care doriți să activați serverul Dataverse MCP, apoi selectați Setări. Sub Setări, selectațiCaracteristici>. Derulați în jos pentru a găsi Dataverse Model Context Protocol și asigurați-vă că opțiunea Permiteți clienților MCP să interacționeze cu serverul Dataverse MCP este activată.

3. Selectați Setări complexe.

4. Este afișată lista clienților disponibili. Deschideți înregistrarea clientului dorită. În acest exemplu, clientul Microsoft GitHub Copilot este activat.

5. În înregistrarea client MCP, setați Este activat la Da.

6. Selectați Salvați & Închide.

7. Repetați pașii 4-7 pentru a activa alți clienți după cum este necesar.

Dezactivați serverul MCP pentru un mediu Dataverse

Implicit, Permite clienților MCP să interacționeze cu serverul MCP Dataverse este activat pentru Copilot Studio. Administratorii pot dezactiva MCP pentru Dataverse debifând setarea.

Avertisment

Dezactivarea serverului Dataverse MCP oprește toate instrumentele și agenții care se bazează pe acesta. Orice dezvoltare în curs de desfășurare sau testare de integrare AI folosind MCP este, de asemenea, întreruptă.

Scrie instrucțiuni eficiente pentru un agent de server Dataverse MCP

Când configurezi agentul în Copilot Studio sau Visual Studio Code să folosească un server MCP Dataverse, instrucțiuni clare și bine structurate sunt esențiale pentru a ghida modul în care agentul funcționează. Aceste instrucțiuni ajută agentul să înțeleagă rolul său, ce capabilități are prin instrumentele serverului MCP și cum să execute fluxurile de lucru în mod fiabil și consecvent.

Instrucțiunile agentului sunt directive în limbaj natural care îi spun agentului ce ar trebui să facă, cum ar trebui să se comporte și cum să folosească instrumentele MCP disponibile. Ele oferă un context important astfel încât agentul să poată:

• Selectează și apelează la instrumentele MCP potrivite.
• Completează corect inputurile uneltelor.
• Decide când să folosești unelte sau când să generezi răspunsuri direct.
• Urmează tonul dorit sau tiparele de comportament în timpul conversațiilor.

Principii pentru instrucțiuni eficiente

Când scrii instrucțiuni pentru un agent server MCP Dataverse, ia în considerare următoarele linii directoare:

1. Definește clar scopul agentului.

   Exprimați rolul agentului în termeni simpli. De exemplu: "Asistență cu interogările datelor clienților, actualizările și gestionarea evidențelor folosind instrumentele Dataverse MCP."

   Include tonuri sau restricții, dacă este cazul, cum ar fi "răspunde întotdeauna într-un ton profesional" sau "nu expune câmpuri sensibile în răspunsuri".

2. Descrie abilitățile și acțiunile uneltelor.

   Spune-i agentului ce sarcini de nivel înalt poate efectua cu instrumentele MCP. De exemplu:

   • Recuperează sau filtrează înregistrările folosind instrumentul read_query.
   • Creează sau actualizează înregistrări cu create_record și update_record.
   • Explorează schema tabelelor cu describe_table.

   Formulează-le ca instrucțiuni acționabile, cum ar fi "Folosește instrumentul read_query pentru a prelua înregistrări când utilizatorul solicită recuperarea datelor."

3. Adaugă ghidaj pentru fluxul de lucru.

   Pentru procese comune (cum ar fi căutarea unei înregistrări sau actualizarea unui câmp), adaugă ghidare pas cu pas. De exemplu: "Când actualizezi o înregistrare, identifică-o mai întâi folosind un apel read_query, apoi folosește update_record cu valorile corespunzătoare ale câmpului."

   Furnizarea acestui context ajută agentul să orchestreze secvența corectă a apelurilor la uneltele MCP.

Adaugă instrucțiuni în Visual Studio Code sau Copilot Studio

Poți folosi un bloc structurat de instrucțiuni cu markdown ca punct de plecare pentru instrucțiunile propriului tău agent.

Adaugă instrucțiuni în Visual Studio Code

1. Deschideți Visual Studio Code.
2. Deschide panoul de chat .
3. Selectează Setări>Instrucțiuni de chat.
4. Selectează fișier de instrucțiuni noi.
5. Copiază și lipește conținutul instrucțiunilor în fișierul nou, cum ar fi instrucțiunile exemplu.

Adaugă instrucțiuni în Copilot Studio

1. Open Copilot Studio.
2. Alege-ți agentul.
3. Mergi la Instrucțiuni de sistem și lipește instrucțiunile de agent, cum ar fi instrucțiunile de exemplu.

Instrucțiuni pentru agentul exemplu

# 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 list_tables tools to get that logical table name.
 - Whenever you have to use column/attribute name, call the describe_table 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

Articole asociate

Politici avansate de conectare - Power Platform

Conectați-vă la Dataverse cu protocolul de context al modelului

Întrebări frecvente despre conectarea la Dataverse cu protocolul de context al modelului