Zdieľať cez

Konfigurácia servera Dataverse MCP pre prostredie

Tento článok obsahuje podrobné pokyny o tom, ako povoliť, spravovať, konfigurovať a zakázať server Dataverse Model Context Protocol (MCP) pre prostredia v centre spravovania Power Platform. Je určený pre administrátorov Power Platform, ktorí spravujú spravované prostredia, a pokrýva aj predpoklady na povolenie servera.

Požiadavky

  • Rola správcu Power Platform na prístup k nastaveniam prostredia servera Dataverse MCP, povolenie povolených klientov MCP, vytvorenie alebo úprava skupiny prostredia a zmena politík konektora.
  • Kroky popísané v tomto článku vyžadujú, aby prostredie bolo spravované prostredie.
  • V predvolenom nastavení je server Dataverse MCP povolený pre všetky prostredia v Microsoft Copilot Studio. Pred pripojením ku klientovi musíte povoliť ďalších klientov v centre spravovania Power Platform.

Konfigurácia a správa servera Dataverse MCP

Štandardne je pre Copilot Studio povolený Dataverse MCP server. Ak chcete povoliť klientov MCP iných spoločností ako Microsoft, ako sú napríklad Visual Studio GitHub Copilot a Claude, postupujte takto:

  1. Prejdite do Power Platform centra spravovania. Vyberte možnosť Spravovať prostredia. >

  2. Vyberte názov prostredia , v ktorom chcete zapnúť server Dataverse MCP, a potom vyberte Nastavenia. V časti Nastavenia vybertepoložku Funkcie>. Posuňte sa nadol, vyhľadajte kontextový protokol Dataverse Model Context Protocol a uistite sa, že je zapnutá možnosť Povoliť klientom MCP interakciu so serverom Dataverse MCP .

  3. Vyberte položku Rozšírené nastavenia. Povolenie klientov MCP od iných spoločností ako Microsoft pre Dataverse

  4. Zobrazí sa zoznam dostupných klientov. Otvorte požadovaný záznam klienta. V tomto príklade je povolený klient Microsoft GitHub Copilot . Povoľte klienta GitHub Copilot.

  5. V zázname klienta MCP nastavte možnosť Je povolené na možnosť Áno. Povolený klient GitHub Copilot.

  6. Vyberte Uložiť & Zavrieť.

  7. Opakujte kroky 4 až 7, aby ste podľa potreby povolili ďalších klientov.

Zakážte server Dataverse MCP pre prostredie

V predvolenom nastavení je v Copilot Studio zapnutá možnosť interakcie MCP klientov s Dataverse MCP serverom . Správcovia môžu zakázať MCP pre Dataverse vymazaním nastavenia.

Upozornenie

Vypnutím servera Dataverse MCP sa zastavia všetky nástroje a agenti, ktorí sa naň spoliehajú. Prerušuje sa aj akýkoľvek prebiehajúci vývoj alebo testovanie integrácie AI pomocou MCP.

Napíšte efektívne inštrukcie pre serverového agenta Dataverse MCP

Keď nakonfigurujete svojho agenta v Copilot Studio alebo Visual Studio Code na používanie Dataverse MCP servera, jasné a dobre štruktúrované inštrukcie sú kľúčové pre riadenie fungovania agenta. Tieto inštrukcie pomáhajú agentovi pochopiť jeho úlohu, aké schopnosti má prostredníctvom MCP serverových nástrojov a ako spoľahlivo a konzistentne vykonávať pracovné postupy.

Inštrukcie agenta sú pokyny v prirodzenom jazyku, ktoré hovoria vášmu agentovi, čo má robiť, ako sa má správať a ako používať dostupné nástroje MCP. Poskytujú dôležitý kontext, aby agent mohol:

  • Vyberte a zavolajte správne nástroje MCP.
  • Správne doplňte vstupy nástrojov.
  • Rozhodnite sa, kedy použiť nástroje a kedy priamo generovať odpovede.
  • Dodržiavajte požadovaný tón alebo vzorce správania počas rozhovorov.

Princípy efektívnych inštrukcií

Pri písaní inštrukcií pre serverového agenta Dataverse MCP zvážte nasledujúce pokyny:

  1. Jasne definujte účel agenta.

    Uveďte úlohu agenta jednoducho. Napríklad: "Pomoc s dotazmi na zákaznícke údaje, aktualizáciami a správou záznamov pomocou nástrojov Dataverse MCP."

    Ak je to vhodné, zahrňte tón alebo obmedzenia, napríklad "vždy odpovedajte profesionálnym tónom" alebo "nevystavujte citlivé polia v odpovediach."

  2. Načrtnite zručnosti a akcie s nástrojmi.

    Povedzte agentovi, aké úlohy na vysokej úrovni môže vykonávať pomocou nástrojov MCP. Napríklad:

    • Načítajte alebo filtrujte záznamy pomocou nástroja read_query.
    • Vytvorte alebo aktualizujte záznamy pomocou create_record a update_record.
    • Preskúmajte schému tabuliek pomocou describe_table.

    Formulujte ich ako akčné inštrukcie, napríklad "Použite nástroj read_query na načítanie záznamov, keď používateľ požiada o získanie dát."

  3. Pridajte usmernenie pracovného postupu.

    Pri bežných procesoch (napríklad vyhľadávanie záznamu alebo aktualizácia poľa) pridajte krok za krokom návod. Napríklad: "Pri aktualizácii záznamu ho najprv identifikujte pomocou read_query volania, potom použite update_record s príslušnými hodnotami polí."

    Poskytnutie tohto kontextu pomáha agentovi koordinovať správnu sekvenciu volaní nástrojov MCP.

Pridajte inštrukcie vo Visual Studio Code alebo Copilot Studio

Ako východiskový bod pre inštrukcie svojho agenta môžete použiť štruktúrovaný blok inštrukcií v markdowne.

Pridajte inštrukcie vo Visual Studio Code

  1. Otvorte Visual Studio Code.
  2. Otvorte panel Chat .
  3. Vyberte Nastavenia>Pokyny na chat.
  4. Vyberte Nový súbor inštrukcií.
  5. Skopírovať a vložiť obsah inštrukcií do nového súboru, napríklad ukážkové inštrukcie.

Pridajte inštrukcie v Copilot Studio

  1. Otvorené štúdio Copilot.
  2. Vyberte si svojho agenta.
  3. Choďte do Systémových inštrukcií a vložte inštrukcie agenta, napríklad ukážkové inštrukcie.

Vzorkové inštrukcie pre látku

# 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

Rozšírené politiky konektorov - Power Platform

Pripojenie k Dataverse pomocou kontextového protokolu modelu

Najčastejšie otázky o pripojení k Dataverse pomocou kontextového protokolu modelu

  • Last updated on