Настройка сервера Dataverse MCP для среды

В этой статье содержатся подробные инструкции по включению, управлению, настройке и отключению сервера контекста модели данных (MCP) для сред в Центре администрирования Power Platform. Он предназначен для администраторов Power Platform, управляющих управляемыми средами, а также охватывает предварительные требования для включения сервера.

Необходимые компоненты

• Роль администратора Power Platform для доступа к параметрам среды сервера Dataverse MCP, включение разрешенных клиентов MCP, создание или изменение группы среды и изменение политик соединителя.
• Действия, описанные в этой статье, требуют, чтобы среда была управляемой средой.
• По умолчанию клиент Microsoft Copilot Studio для Dataverse MCP включен для всех сред. Перед подключением к клиенту необходимо включить дополнительные клиенты в Центре администрирования Power Platform.

Настройка сервера Dataverse MCP и управление ими

По умолчанию сервер Dataverse MCP включен для Copilot Studio. Чтобы включить клиенты, отличные от Microsoft MCP, такие как Visual Studio GitHub Copilot и Claude, выполните следующие действия.

1. Перейдите к Центр администрирования Power Platform. Выберите "Управление средами>".

2. Выберите имя среды , в которой нужно включить сервер Dataverse MCP, а затем выберите "Параметры". В разделе "Параметры" выберите"Компоненты>". Прокрутите вниз, чтобы найти протокол контекста модели Dataverse и убедитесь, что разрешено взаимодействие клиентов MCP с сервером Dataverse MCP.

3. Выберите дополнительные параметры.

4. Отображается список доступных клиентов. Откройте нужную запись клиента. В этом примере включен клиент Microsoft GitHub Copilot.

5. В записи клиента MCP установите Включено в Да.

6. Выберите Сохранить и закрыть.

7. Повторите шаги 4-7, чтобы включить другие клиентские устройства, если это необходимо.

Отключение сервера Dataverse MCP для среды

По умолчанию параметр Разрешить клиентам MCP взаимодействовать с сервером Dataverse MCP включен для Copilot Studio. Администраторы могут отключить MCP для Dataverse, очистив параметр.

Написание эффективных инструкций для агента сервера Dataverse MCP

При настройке агента в Copilot Studio или Visual Studio Code для использования сервера Dataverse MCP, ключевую роль играют понятные и хорошо структурированные инструкции, которые направляют работу агента. Эти инструкции помогают агенту понять свою роль, какие возможности он имеет с помощью средств сервера MCP, а также как надежно и согласованно выполнять рабочие процессы.

Инструкции агента — это директивы естественного языка, которые сообщают агенту, что он должен делать, как он должен вести себя, и как использовать доступные для него средства MCP. Они дают важный контекст, чтобы агент может:

• Выберите и вызовите нужные инструменты MCP.
• Правильно заполните входные данные инструмента.
• Решите, когда использовать инструменты и когда генерировать ответы непосредственно.
• Следуйте требуемым тону или шаблонам поведения во время бесед.

Принципы для эффективных инструкций

При написании инструкций для агента сервера Dataverse MCP рассмотрите следующие рекомендации:

1. Четко определите назначение агента.

   Опишите роль агента простыми словами. Например: "Помощь с запросами данных клиентов, их обновлением и управлением записями с помощью средств MCP Dataverse".

   Включите тон или ограничения, если применимо, например, "всегда отвечать в профессиональном тоне" или "не предоставлять конфиденциальные поля в ответах".

2. Описание навыков и действий инструментов.

   Сообщите агенту, какие высокоуровневые задачи он может выполнять с помощью средств MCP. Рассмотрим пример.

   • Получение или фильтрация записей с помощью средства read_query.
   • Создание или обновление записей с помощью create_record и update_record.
   • Изучите схему таблицы с помощью describe_table.

   Сформулируйте это как действенные инструкции, например, "Используйте инструмент read_query для извлечения записей по запросу пользователя на получение данных".

3. Добавьте руководство по рабочему процессу.

   Для распространенных процессов (например, поиска записи или обновления поля) добавьте пошаговые инструкции. Например: "При обновлении записи сначала определите ее с помощью вызова read_query, а затем используйте update_record с соответствующими значениями полей".

   Предоставление этого контекста помогает агенту управлять правильной последовательностью вызовов инструментов MCP.

Добавление инструкций в Visual Studio Code или Copilot Studio

Можно использовать структурированный блок инструкций в формате markdown как отправную точку для инструкций вашего собственного агента.

Добавление инструкций в Visual Studio Code

1. Откройте Visual Studio Code.
2. Откройте панель чата .
3. Выберите Настройки>Инструкции чата.
4. Выберите новый файл инструкции.
5. Скопируйте и вставьте содержимое инструкции в новый файл, например примеры инструкций.

Добавление инструкций в Copilot Studio

1. Откройте Copilot Studio.
2. Выберите агент.
3. Перейдите в системные инструкции и вставьте инструкции агента, например примеры инструкций.

Примеры инструкций агента

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

Связанные статьи

Расширенные политики соединителей — Power Platform

Подключение к Dataverse с помощью протокола контекста модели

Часто задаваемые вопросы о подключении к Dataverse с помощью протокола контекста модели