Bagikan melalui

Mengonfigurasi server Dataverse MCP untuk lingkungan

Artikel ini memberikan instruksi terperinci tentang cara mengaktifkan, mengelola, mengonfigurasi, dan menonaktifkan server Dataverse Model Context Protocol (MCP) untuk lingkungan dalam pusat admin Power Platform. Ini ditujukan untuk administrator Power Platform yang menangani lingkungan terkelola dan juga mencakup prasyarat untuk mengaktifkan server.

Prasyarat

  • Peran administrator Power Platform untuk mengakses pengaturan lingkungan server Dataverse MCP, mengaktifkan klien MCP yang diizinkan, membuat atau mengedit grup lingkungan, dan mengubah kebijakan konektor.
  • Langkah-langkah yang dijelaskan dalam artikel ini mengharuskan lingkungan adalah Lingkungan Terkelola.
  • Secara default, server Dataverse MCP diaktifkan untuk semua lingkungan di Microsoft Copilot Studio. Anda harus mengaktifkan klien tambahan di pusat admin Power Platform sebelum Dapat tersambung ke klien.

Mengonfigurasi dan mengelola server Dataverse MCP

Secara default, server Dataverse MCP diaktifkan untuk Copilot Studio. Untuk mengaktifkan klien MCP non-Microsoft, seperti Visual Studio GitHub Copilot dan Claude, ikuti langkah-langkah berikut:

  1. Buka Pusat Admin Power Platform. Pilih Kelola>Lingkungan.

  2. Pilih Nama Lingkungan tempat Anda ingin mengaktifkan server MCP Dataverse, lalu pilih Pengaturan. Di bawah Pengaturan, pilihFitur>. Gulir ke bawah untuk menemukan Protokol Konteks Model Dataverse dan pastikan Izinkan klien MCP berinteraksi dengan server Dataverse MCP diaktifkan.

  3. Pilih Pengaturan Tingkat Lanjut. Mengaktifkan klien MCP non-Microsoft untuk Dataverse

  4. Daftar klien yang tersedia ditampilkan. Buka catatan klien yang Anda inginkan. Dalam contoh ini, klien Microsoft GitHub Copilot diaktifkan. Aktifkan klien GitHub Copilot.

  5. Pada catatan klien MCP, atur Diaktifkan ke Ya. Klien GitHub Copilot diaktifkan.

  6. Pilih Simpan & Tutup.

  7. Ulangi langkah 4-7 untuk mengaktifkan klien lain sesuai kebutuhan.

Menonaktifkan server MCP Dataverse untuk lingkungan

Secara bawaan, fitur izinkan klien MCP berinteraksi dengan server Dataverse MCP diaktifkan untuk Copilot Studio. Admin dapat menonaktifkan MCP untuk Dataverse dengan menghapus pengaturan.

Peringatan

Menonaktifkan Server MCP Dataverse menghentikan semua alat dan agen yang mengandalkannya. Setiap pengembangan yang sedang berlangsung atau pengujian integrasi AI menggunakan MCP juga terganggu.

Menulis instruksi efektif untuk agen server Dataverse MCP

Saat Anda mengonfigurasi agen di Copilot Studio atau Visual Studio Code untuk menggunakan server MCP Dataverse, instruksi yang jelas dan terstruktur adalah kunci untuk membimbing cara agen beroperasi. Instruksi ini membantu agen memahami perannya, kemampuan apa yang dimilikinya melalui alat server MCP, dan cara menjalankan alur kerja dengan andal dan konsisten.

Instruksi agen adalah arahan bahasa alami yang memberi tahu agen Anda apa yang harus dilakukannya, bagaimana seharusnya, dan cara menggunakan alat MCP yang tersedia untuk itu. Mereka memberikan konteks penting sehingga agen dapat:

  • Pilih dan panggil alat MCP yang tepat.
  • Isi input perangkat dengan benar.
  • Memutuskan kapan menggunakan alat versus menghasilkan jawaban secara langsung.
  • Ikuti pola nada atau perilaku yang diinginkan selama percakapan.

Prinsip untuk instruksi yang efektif

Saat menulis instruksi untuk agen server Dataverse MCP, pertimbangkan panduan berikut:

  1. Tentukan tujuan agen dengan jelas.

    Menyatakan peran agen dalam istilah sederhana. Misalnya: "Membantu kueri data pelanggan, pembaruan, dan manajemen rekaman menggunakan alat Dataverse MCP."

    Sertakan nada atau batasan jika berlaku seperti, "selalu respons dalam nada profesional" atau "jangan mengekspos bidang sensitif dalam respons."

  2. Menguraikan keterampilan dan fungsi alat.

    Beri tahu agen tugas tingkat tinggi mana yang dapat dilakukannya dengan alat MCP. Contohnya:

    • Mengambil atau memfilter rekaman menggunakan alat read_query.
    • Buat atau perbarui rekaman dengan create_record dan update_record.
    • Jelajahi skema tabel dengan describe_table.

    Frasa ini sebagai instruksi yang dapat ditindaklanjuti, seperti "Gunakan alat read_query untuk mengambil rekaman saat pengguna meminta pengambilan data."

  3. Tambahkan panduan alur kerja.

    Untuk proses umum (seperti mencari rekaman atau memperbarui bidang), tambahkan panduan langkah demi langkah. Misalnya: "Saat memperbarui rekaman, pertama-tama identifikasi rekaman menggunakan panggilan read_query, lalu gunakan update_record dengan nilai bidang yang sesuai."

    Menyediakan konteks ini membantu agen mengatur urutan panggilan alat MCP yang tepat.

Menambahkan instruksi di Visual Studio Code atau Copilot Studio

Anda dapat menggunakan blok instruksi terstruktur markdown sebagai titik awal untuk instruksi agen Anda sendiri.

Menambahkan instruksi di Visual Studio Code

  1. Buka Visual Studio Code.
  2. Buka panel Obrolan .
  3. Pilih Pengaturan>Instruksi Obrolan.
  4. Pilih File instruksi baru.
  5. Salin dan tempel konten instruksi ke dalam file baru, seperti instruksi sampel.

Menambahkan instruksi di Copilot Studio

  1. Buka Copilot Studio.
  2. Pilih agen Anda.
  3. Buka Instruksi sistem dan tempelkan instruksi agen Anda, seperti instruksi sampel.

Contoh instruksi agen

# 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

Kebijakan konektor tingkat lanjut - Power Platform

Menyambungkan ke Dataverse dengan protokol konteks model

Menyambungkan ke Dataverse dengan protokol konteks model: FAQ

  • Last updated on