Dataverse MCP-serveri konfigureerimine keskkonna jaoks

See artikkel annab üksikasjalikud juhised selle kohta, kuidas lubada, hallata, konfigureerida ja keelata Dataverse Model Context Protocol (MCP) serverit keskkondade jaoks Power Platformi halduskeskuses. See on mõeldud Power Platformi administraatoritele, kes haldavad hallatud keskkondi, ning katab ka serveri lubamise eeltingimusi.

Eeltingimused

  • Power Platformi administraatori roll, et pääseda juurde Dataverse MCP serveri keskkonna sätetele, lubada lubatud MCP-kliente, luua või redigeerida keskkonnarühma ja muuta konnektori poliitikaid.
  • Keskkond peab olema hallatud keskkond, kui soovid hallata Dataverse'i MCP serverit Advanced connector poliitikate kaudu.
  • Vaikimisi on Microsoft Copilot Studio klient Dataverse MCP jaoks lubatud kõigis keskkondades. Enne kliendiga ühenduse loomist peate lubama täiendavad kliendid Power Platformi halduskeskuses.

Seadista ja halda Dataverse MCP serverit

Vaikimisi on Dataverse MCP server lubatud Copilot Studio jaoks. Mitte-Microsofti MCP klientide, nagu Visual Studio GitHub Copilot ja Claude, võimaldamiseks järgige järgmisi samme:

Märkus.

MCP loa loetelu kehtib ainult agendi /api/mcp sisenemispunktile. MCP-nimega kohandatud API-d on tavalised Dataverse'i API-d ega ole selle seadistusega piiratud.

  1. Minge Power Platformi halduskeskusesse. Valige Halda>keskkondi.

  2. Valige keskkonna nimi , kus soovite Dataverse MCP-serveri sisse lülitada, ja seejärel valige Sätted. Valige jaotises Sätted valik Toote>funktsioonid. Kerige alla, et leida Dataverse Model Context Protocol ja veenduge, et Luba MCP klientidel Dataverse MCP-serveriga suhelda on sisse lülitatud.

  3. Valige Täpsemad sätted. Mitte-Microsofti MCP-klientide lubamine Dataverse'i jaoks

  4. Kuvatakse saadaolevate klientide loend. Avage soovitud kliendikirje. Selles näites on Microsoft GitHub Copilot klient lubatud. Luba GitHub Copiloti klient.

  5. Määrake MCP kliendikirjes väärtuseks On lubatudJah. GitHub Copilot klient lubatud.

  6. Valige Salvesta ja sule.

  7. Korrake samme 4–7, et lubada vajadusel teisi kliente.

MCP-serveri keelamine Dataverse keskkonnas

Vaikimisi on Copilot Studio jaoks sisse lülitatud Luba MCP klientidel suhelda Dataverse MCP serveriga. Administraatorid saavad MCP for Dataverse'i keelata, tühjendades sätte.

Hoiatus

Dataverse MCP-serveri keelamine peatab kõik tööriistad ja agendid, mis sellele tuginevad. Samuti katkestatakse igasugune käimasolev arendus või tehisintellekti integreerimise testimine MCP abil.

Kirjuta tõhusad juhised Dataverse'i MCP serveri agendi jaoks

Kui seadistad oma agendi Copilot Studios või Visual Studio Code'is kasutama Dataverse MCP serverit, on selged ja hästi struktureeritud juhised võtmetähtsusega, kuidas agent toimib. Need juhised aitavad agendil mõista oma rolli, millised võimalused tal MCP serveritööriistade kaudu on, ning kuidas töövooge usaldusväärselt ja järjepidevalt läbi viia.

Agendi juhised on loomuliku keele juhised, mis ütlevad teie agendile, mida ta peaks tegema, kuidas käituma ja kuidas kasutada MCP tööriistu, mis tal on. Need annavad olulise konteksti, et agent saaks:

  • Vali ja kutsu õiged MCP tööriistad.
  • Täida tööriista sisendid korrektselt.
  • Otsusta, millal kasutada tööriistu ja millal vastuseid otse genereerida.
  • Järgi vestluste ajal soovitud tooni või käitumismustreid.

Tõhusate juhiste põhimõtted

Dataverse MCP serveri agendi juhiseid kirjutades tuleb arvestada järgmiste juhistega:

  1. Määratlege agendi eesmärk selgelt.

    Esita agendi roll lihtsate sõnadega. Näiteks: "Abi kliendiandmete päringute, uuenduste ja andmehalduse korraldamisel kasutades Dataverse MCP tööriistu."

    Lisage vajadusel toon või piirangud, näiteks "vastake alati professionaalses toonis" või "ärge paljastage tundlikke valdkondi vastustes."

  2. Kirjelda oskusi ja tööriistade tegevusi.

    Ütle agendile, milliseid kõrgetasemelisi ülesandeid ta saab MCP tööriistadega täita. Näide:

    • Hangi või filtreeri kirjeid read_query tööriistaga.
    • Loo või uuenda kirjeid ja create_recordupdate_record.
    • Uuri lauaskeemi .describe

    Sõnastage need kui rakendatavad juhised, näiteks "Kasuta read_query tööriista kirjete hankimiseks, kui kasutaja soovib andmete taastamist."

  3. Lisa töövoo juhised.

    Tavaliste protsesside puhul (näiteks kirje otsimine või välja uuendamine) lisa samm-sammult juhised. Näiteks: "Kirje uuendamisel tuvasta see esmalt read_query kutsega, seejärel kasuta update_record sobivate väljaväärtustega."

    Selle konteksti pakkumine aitab agendil orkestreerida õiget MCP tööriistakutsete järjestust.

Lisa juhised Visual Studio Code'is või Copilot Studios

Sa võid kasutada oma agendi juhiste lähtepunktina allahindlust struktureeritud käsuplokki.

Lisa käsud Visual Studio Code'is

  1. Ava Visual Studio Code.
  2. Ava vestluspaneel .
  3. Vali seaded>Vestlusjuhised.
  4. Vali Uus käsufail.
  5. Kopeeri ja kleebi käsu sisu uude faili, näiteks näidisjuhised.

Lisa juhised Copilot Studios

  1. Avatud Copilot Studio.
  2. Vali oma agent.
  3. Mine Süsteemi juhiste juurde ja kleebi oma agendi juhised, näiteks näidisjuhised.

Näidisagentide juhised

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

Täpsemad konnektoripoliitikad – Power Platform

Dataverse'iga ühenduse loomine mudeli kontekstiprotokolli abil

Dataverse'iga ühenduse loomine mudeli kontekstiprotokolli KKK

  • Last updated on