Dijeli putem

Konfiguriranje poslužitelja Dataverse MCP za okruženje

Ovaj članak sadrži detaljne upute o tome kako omogućiti, upravljati, konfigurirati i onemogućiti poslužitelj Dataverse Model Context Protocol (MCP) za okruženja unutar centra za administratore platforme Power Platform. Namijenjen je administratorima Power Platforme koji upravljaju upravljanim okruženjima i također pokriva preduvjete za omogućavanje servera.

Preduvjeti

  • Administratorska uloga Power Platform za pristup postavkama okruženja poslužitelja Dataverse MCP, omogućavanje dopuštenih MCP klijenata, stvaranje ili uređivanje grupe okruženja i promjenu pravila poveznika.
  • Koraci opisani u ovom članku zahtijevaju da je okruženje upravljano okruženje.
  • Prema zadanim postavkama, Dataverse MCP poslužitelj je omogućen za sva okruženja u Microsoft Copilot Studio. Morate omogućiti dodatne klijente u centru za administratore platforme Power Platform prije nego što se možete povezati s klijentom.

Konfigurirajte i upravljajte Dataverse MCP poslužiteljem

Prema zadanim postavkama, Dataverse MCP poslužitelj je omogućen za Copilot Studio. Za omogućavanje ne-Microsoft MCP klijenata, poput Visual Studio GitHub Copilot i Claude, slijedite ove korake:

  1. Idite u centar za administratore platforme Power Platform. Odaberite Upravljanje>okruženjima.

  2. Odaberite naziv okruženja u kojem želite uključiti Dataverse MCP poslužitelj, a zatim odaberite Postavke. U odjeljku Postavke odaberiteZnačajke>. Pomaknite se prema dolje da biste pronašli Dataverse Model Context Protocol i provjerite je li uključena opcija Dopusti MCP klijentima interakciju s Dataverse MCP poslužiteljem .

  3. Odaberite Napredne postavke. Omogućivanje MCP klijenata koji nisu Microsoftovi za platformu Dataverse

  4. Prikazan je popis dostupnih klijenata. Otvorite željeni zapis klijenta. U ovom primjeru, klijent Microsoft GitHub Copilot je omogućen. Enable GitHub Copilot client.

  5. Na zapisu MCP klijenta postavite Je omogućeno na Da. GitHub Copilot klijent omogućen.

  6. Odaberite Spremi i zatvori.

  7. Ponovite korake 4-7 da biste omogućili druge klijente po potrebi.

Onemogućite Dataverse MCP poslužitelj za okruženje

Po zadanim postavkama uključen je Allow MCP klijenti da komuniciraju s Dataverse MCP serverom za Copilot Studio. Administratori mogu onemogućiti MCP za Dataverse brisanjem postavke.

Upozorenje

Onemogućavanjem platforme Dataverse MCP Server zaustavljaju se svi alati i agenti koji se oslanjaju na njega. Svaki tekući razvoj ili testiranje integracije umjetne inteligencije pomoću MCP-a također se prekida.

Napišite učinkovite upute za Dataverse MCP server agenta

Kada konfigurirate svog agenta u Copilot Studiju ili Visual Studio Code-u da koristi Dataverse MCP poslužitelj, jasne i dobro strukturirane upute ključne su za vođenje rada agenta. Te upute pomažu agentu razumjeti njegovu ulogu, koje mogućnosti ima putem MCP poslužiteljskih alata i kako pouzdano i dosljedno provoditi radne tokove.

Upute za agenta su upute na prirodnom jeziku koje govore vašem agentu što treba raditi, kako se treba ponašati i kako koristiti dostupne MCP alate. Daju važan kontekst kako bi agent mogao:

  • Odaberi i nazovi prave MCP alate.
  • Ispravno unesite unose alata.
  • Odlučite kada koristiti alate, a kada izravno generirati odgovore.
  • Slijedite željeni ton ili obrasce ponašanja tijekom razgovora.

Načela za učinkovite upute

Prilikom pisanja uputa za Dataverse MCP server agenta, uzmite u obzir sljedeće smjernice:

  1. Jasno definirajte svrhu agenta.

    Objasnite ulogu agenta jednostavnim riječima. Na primjer: "Pomoć pri upitima o korisničkim podacima, ažuriranjima i upravljanju zapisima koristeći Dataverse MCP alate."

    Uključite ton ili ograničenja ako je primjenjivo, poput "uvijek odgovarajte profesionalnim tonom" ili "ne izlažite osjetljiva polja u odgovorima."

  2. Nacrtajte vještine i radnje s alatima.

    Recite agentu koje visokorazinske zadatke može obavljati s MCP alatima. Na primjer:

    • Dohvatite ili filtrirajte zapise pomoću alata read_query.
    • Kreirajte ili ažurirajte zapise s create_record i update_record.
    • Istražite shemu tablica pomoću describe_table.

    Formulirajte ih kao konkretne upute, poput "Koristite alat read_query za dohvaćanje zapisa kada korisnik zatraži dohvat podataka."

  3. Dodajte smjernice za tijek rada.

    Za uobičajene procese (poput traženja zapisa ili ažuriranja polja), dodajte upute korak po korak. Na primjer: "Prilikom ažuriranja zapisa, prvo ga identificirajte pomoću read_query poziva, zatim koristite update_record s odgovarajućim vrijednostima polja."

    Pružanje ovog konteksta pomaže agentu da orkestrira pravi slijed poziva MCP alata.

Dodajte upute u Visual Studio Code ili Copilot Studio

Možete koristiti strukturirani blok uputa u markdownu kao polazište za upute svog agenta.

Dodaj upute u Visual Studio Code

  1. Otvorite Visual Studio Code.
  2. Otvori panel za razgovor.
  3. Odaberi Postavke>Upute za chat.
  4. Odaberi novu datoteku instrukcija.
  5. Kopirajte i zalijepite sadržaj uputa u novu datoteku, poput uzoraka uputa.

Dodajte upute u Copilot Studio

  1. Otvoreni Copilot Studio.
  2. Odaberite svog agenta.
  3. Idite na upute za sustav i zalijepite upute za agenta, poput uzoraka uputa.

Upute za uzorak agensa

## 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.

Napredna pravila poveznika - Power Platform

Povezivanje s uslugom Dataverse pomoću kontekstnog protokola modela

Povezivanje s uslugom Dataverse pomoću najčešća pitanja o kontekstnom protokolu modela

  • Last updated on