Konfigurowanie serwera MCP usługi Dataverse dla środowiska

Ten artykuł zawiera szczegółowe instrukcje dotyczące włączania, konfigurowania i wyłączania serwera protokołu MCP (Dataverse Model Context Protocol) dla środowisk w centrum administracyjnym platformy Power Platform. Jest ona przeznaczona dla administratorów platformy Power Platform obsługujących środowiska zarządzane, a także obejmuje wymagania wstępne dotyczące włączania serwera.

Wymagania wstępne

• Rola administratora platformy Power Platform w celu uzyskania dostępu do ustawień środowiska serwera MCP usługi Dataverse, włączenia dozwolonych klientów MCP, utworzenia lub edytowania grupy środowiska oraz zmiany zasad łącznika.
• Kroki opisane w tym artykule wymagają, aby środowisko było środowiskiem zarządzanym.
• Domyślnie serwer MCP Dataverse jest włączony dla wszystkich środowisk w programie Microsoft Copilot Studio. Przed nawiązaniem połączenia z klientem należy włączyć dodatkowych klientów w centrum administracyjnym platformy Power Platform.

Konfigurowanie serwera MCP usługi Dataverse i zarządzanie nim

Domyślnie serwer MCP Dataverse jest włączony dla usługi Copilot Studio. Aby włączyć klientów innych niż Microsoft MCP, takich jak Visual Studio GitHub Copilot i Claude, wykonaj następujące kroki:

1. Przejdź do centrum administracyjnego platformy Power Platform. Wybierz pozycję Zarządzaj>środowiskami.

2. Wybierz nazwę środowiska , w którym chcesz włączyć serwer MCP usługi Dataverse, a następnie wybierz pozycję Ustawienia. W obszarze Ustawienia wybierz pozycjęFunkcje>. Przewiń w dół, aby znaleźć protokół kontekstowy modelu Dataverse i upewnij się, że jest włączona opcja Zezwalaj klientom MCP na interakcję z serwerem Dataverse MCP.

3. Wybierz pozycję Ustawienia zaawansowane.

4. Zostanie wyświetlona lista dostępnych klientów. Otwórz żądany rekord klienta. W tym przykładzie jest włączony klient Microsoft GitHub Copilot .

5. W rekordzie klienta MCP ustaw wartość Jest włączona na wartość Tak.

6. Zaznacz Zapisz i zamknij.

7. Powtórz kroki od 4 do 7, aby włączyć innych klientów zgodnie z potrzebami.

Wyłączanie serwera Dataverse MCP dla środowiska

Domyślnie dla programu Copilot Studio jest włączona opcja Zezwalaj klientom MCP na interakcję z serwerem Dataverse MCP. Administratorzy mogą wyłączyć mcp dla usługi Dataverse, usuwając to ustawienie.

Ostrzeżenie

Wyłączenie serwera Dataverse MCP zatrzymuje wszystkie narzędzia i agentów, którzy na nim polegają. Wszelkie trwające działania w zakresie developmentu lub testowania integracji AI przy użyciu MCP również są przerywane.

Tworzenie skutecznych instrukcji dla agenta serwera MCP usługi Dataverse

Podczas konfigurowania agenta w programie Copilot Studio lub Visual Studio Code do korzystania z serwera MCP Dataverse, jasne i dobrze ustrukturyzowane instrukcje są kluczem do prowadzenia działania agenta. Te instrukcje pomagają agentowi zrozumieć swoją rolę, jakie możliwości ma za pośrednictwem narzędzi serwera MCP oraz jak niezawodnie i spójnie wykonywać przepływy pracy.

Instrukcje agenta to dyrektywy języka naturalnego, które informują agenta, jak powinien zachowywać się i jak korzystać z dostępnych narzędzi MCP. Zapewniają one ważny kontekst, dzięki czemu agent może:

• Wybierz i wywołaj odpowiednie narzędzia MCP.
• Wprowadź poprawnie dane wejściowe narzędzia.
• Zdecyduj, kiedy używać narzędzi, a nie bezpośrednio generować odpowiedzi.
• Postępuj zgodnie z żądanymi wzorcami tonu lub zachowania podczas konwersacji.

Zasady skutecznych instrukcji

Podczas pisania instrukcji dotyczących agenta serwera MCP usługi Dataverse należy wziąć pod uwagę następujące wskazówki:

1. Jasno zdefiniuj cel agenta.

   Określ rolę agenta w prosty sposób. Na przykład: "Pomoc w zakresie zapytań dotyczących danych klientów, aktualizacji i zarządzania rekordami przy użyciu narzędzi usługi Dataverse MCP".

   Uwzględnij ton lub ograniczenia, jeśli ma to zastosowanie, takie jak "zawsze odpowiadaj w profesjonalnym tonu" lub "nie ujawniaj poufnych pól w odpowiedziach".

2. Zarys umiejętności i działania narzędzi.

   Poinformuj agenta, które zadania wysokiego poziomu może wykonywać za pomocą narzędzi MCP. Przykład:

   • Pobieranie lub filtrowanie rekordów przy użyciu narzędzia read_query.
   • Utwórz lub zaktualizuj rekordy za pomocą create_record oraz update_record.
   • Zapoznaj się ze schematem tabeli za pomocą polecenia describe_table.

   Sformułuj te frazy jako instrukcje działań, takie jak "Użyj narzędzia read_query do pobierania rekordów, kiedy użytkownik prosi o pobranie danych".

3. Dodaj wskazówki dotyczące przepływu pracy.

   W przypadku typowych procesów (takich jak wyszukiwanie rekordu lub aktualizowanie pola) dodaj wskazówki krok po kroku. Na przykład: "Podczas aktualizowania rekordu najpierw zidentyfikuj go przy użyciu wywołania read_query, a następnie użyj update_record z odpowiednimi wartościami pól.

   Zapewnienie tego kontekstu pomaga agentowi zorganizować właściwą sekwencję wywołań narzędzi MCP.

Dodawanie instrukcji w programie Visual Studio Code lub Copilot Studio

Możesz użyć ustrukturyzowanego bloku instrukcji w formacie markdown jako punktu wyjścia do instrukcji dla własnego agenta.

Dodawanie instrukcji w programie Visual Studio Code

1. Otwórz program Visual Studio Code.
2. Otwórz okienko Czat .
3. Wybierz pozycję Ustawienia>Instrukcje czatu.
4. Wybierz pozycję Nowy plik instrukcji.
5. Skopiuj i wklej zawartość instrukcji do nowego pliku, na przykład przykładowe instrukcje.

Dodawanie instrukcji w programie Copilot Studio

1. Otwórz Copilot Studio.
2. Wybierz swój agent.
3. Przejdź do obszaru Instrukcje systemowe i wklej instrukcje agenta, takie jak przykładowe instrukcje.

Przykładowe instrukcje dotyczące agenta

# Role
Act as an autonomous agent responsible for interacting with the Micorosft 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

Powiązane artykuły

Zaawansowane zasady łącznika — Power Platform

Nawiązywanie połączenia z usługą Dataverse przy użyciu protokołu kontekstu modelu

Nawiązywanie połączenia z usługą Dataverse przy użyciu protokołu kontekstowego modelu — często zadawane pytania