הפניה להרשאה לכלי Customer Service Copilot

Customer Service Copilot משתמשת בהרשאות Microsoft Dataverse כדי לשלוט באילו כלים המשתמש יכול לגלות ולהפעיל. מאמר זה מפרט את ההרשאות שכל כלי דורש כדי שמנהלי המערכת יוכלו להגדיר גישה מבוססת תפקידים. הכלים מסופקים על ידי תרחישי Dynamics 365 Customer Service MCP Server ו-Power Service Agent ב-Microsoft 365 Copilot.

איך גישה לכלים פועלת

כדי לגלות כלי, המשתמש חייב להחזיק בכל ההרשאות המפורטות עבורו.
כלים שלא נמצאים במפת הפריבילגיות אינם מוגבלים לגילוי, כך שהם תמיד ניתנים לגילוי ללא קשר להרשאות.
אם חיפוש הרשאות נכשל, גילוי הוא fail-open, ולכן כלים עשויים עדיין להופיע. עם זאת, Dataverse עדיין יכול להחזיר שגיאת HTTP 403 (אסורה) בזמן הריצה.

הפניה מכלי להרשאה

בטבלה הבאה, מספר הרשאות מופרדות בפסיקים, ומשתמש צריך את כולן כדי שהכלי יהיה ניתן לגילוי. כלים שהושמטו בכוונה מבדיקת ההרשאות מופיעים בכלים ללא הרשאות בכוונה.

כלי	ההרשאות הנדרשות
`adjust_email_tone`	`prvCreateActivity`, `prvReadActivity`
`answer_knowledge_question`	`prvReadKnowledgeArticle`, `prvIntelligenceUsage`
`answer_service_question`	`prvReadIncident`
`apply_email_template`	`prvReadEmailTemplate`
`browse_agent_config_options`	`prvmsdyn_ServiceAgentMakerCustomize`
`check_harvest_status`	`prvReadKnowledgeArticle`
`check_knowledge_gap`	`prvReadKnowledgeArticle`
`close_case`	`prvReadIncident`, , `prvWriteIncidentprvCreateActivity`
`create_activity`	`prvCreateActivity`
`create_case_from_email`	`prvCreateIncident`, `prvReadActivity`
`create_email_template`	`prvCreateEmailTemplate`
`create_note`	`prvCreateNote`
`delete_agent_config`	`prvmsdyn_ServiceAgentMakerCustomize`
`delete_copilot_studio_registration`	`prvmsdyn_ServiceAgentMakerCustomize`
`delete_mcp_registration`	`prvmsdyn_ServiceAgentMakerCustomize`
`delete_profile_config`	`prvmsdyn_ServiceAgentMakerCustomize`
`delete_tool_selection`	`prvmsdyn_ServiceAgentMakerCustomize`
`delete_user_prefs`	`prvmsdyn_ServiceAgentUserCustomize`
`discard_knowledge_draft`	`prvDeleteKnowledgeArticle`
`draft_email`	`prvCreateActivity`, `prvReadActivity`
`draft_knowledge_article`	`prvCreateKnowledgeArticle`
`edit_email_draft`	`prvReadActivity`, `prvWriteActivity`
`edit_email_template`	`prvReadEmailTemplate`, `prvWriteEmailTemplate`
`enrich_case`	`prvWriteIncident`, `prvReadActivity`
`format_case_note`	`prvReadIncident`
`generate_email_content`	`prvReadActivity`
`get_account`	`prvReadAccount`
`get_activity_quick_create_form`	`prvCreateActivity`
`get_activity_timeline`	`prvReadActivity`, `prvReadNote`
`get_agent_config_capabilities`	`prvmsdyn_ServiceAgentMakerCustomize`
`get_case`	`prvReadIncident`
`get_case_highlights`	`prvReadIncident`, , `prvReadActivityprvReadNote`
`get_case_next_suggestion`	`prvReadIncident`, `prvReadActivity`
`get_case_sla_status`	`prvReadIncident`, `prvReadSLAKPIInstance`
`get_contact`	`prvReadContact`
`get_evaluation_insights`	`prvReadmsdyn_Evaluation`
`get_knowledge_article`	`prvReadKnowledgeArticle`
`harvest_knowledge_article`	`prvCreateKnowledgeArticle`
`link_email_to_case`	`prvReadIncident`, `prvWriteActivity`
`list_accounts`	`prvReadAccount`
`list_agent_configs`	`prvmsdyn_ServiceAgentMakerCustomize`
`list_case_inbox_workitems`	`prvReadIncident`
`list_case_suggested_actions`	`prvReadIncident`, `prvReadmsdyn_nextaction`
`list_cases`	`prvReadIncident`
`list_cma_drafts`	`prvReadIncident`, , `prvReadActivityprvReadmsdyn_copilotevent`
`list_cma_escalated_cases`	`prvReadIncident`, `prvReadmsdyn_aiagentstatus`
`list_contacts`	`prvReadContact`
`list_copilot_studio_registration_bots`	`prvmsdyn_ServiceAgentMakerCustomize`
`list_emails`	`prvReadActivity`
`list_evaluations`	`prvReadmsdyn_Evaluation`
`list_profile_configs`	`prvmsdyn_ServiceAgentMakerCustomize`
`list_tool_selection`	`prvmsdyn_ServiceAgentMakerCustomize`
`list_user_prefs`	`prvmsdyn_ServiceAgentUserCustomize`
`manage_copilot_studio_registration`	`prvmsdyn_ServiceAgentMakerCustomize`
`manage_mcp_registration`	`prvmsdyn_ServiceAgentMakerCustomize`
`match_cases`	`prvReadIncident`
`pick_case_from_queue`	`prvReadIncident`, `prvWriteIncident`
`publish_knowledge_article`	`prvWriteKnowledgeArticle`
`query_cases_by_sla_status`	`prvReadIncident`, , `prvReadSLAKPIInstance`, `prvReadQueueprvReadQueueItem`
`reassign_case`	`prvWriteIncident`, `prvCreateNote`
`recommend_email_templates`	`prvReadEmailTemplate`
`resolve_case_and_pick_next`	`prvReadIncident`, , `prvWriteIncidentprvCreateActivity`
`rewrite_structured_content`	`prvReadmsdyn_rtestructuredtemplate`, `prvReadmsdyn_rtestructuredtemplateconfig`, `prvReadmsdyn_rtetemplatemapping`, , `prvCopilotRestructureContentprvCreateNote`
`save_agent_config`	`prvmsdyn_ServiceAgentMakerCustomize`
`save_copilot_studio_registration`	`prvmsdyn_ServiceAgentMakerCustomize`
`save_email_template`	`prvWriteEmailTemplate`
`save_knowledge_draft`	`prvWriteKnowledgeArticle`
`save_mcp_registration`	`prvmsdyn_ServiceAgentMakerCustomize`
`save_profile_config`	`prvmsdyn_ServiceAgentMakerCustomize`
`save_tool_selection`	`prvmsdyn_ServiceAgentMakerCustomize`
`save_user_prefs`	`prvmsdyn_ServiceAgentUserCustomize`
`search_knowledge_articles`	`prvReadKnowledgeArticle`
`search_lookup_records`	`prvReadAccount`, `prvReadContact`
`send_email`	`prvCreateActivity`, `prvReadActivity`
`show_email_template`	`prvReadEmailTemplate`
`submit_feedback`	`prvIntelligenceUsage`
`suggest_next_action_for_case`	`prvReadIncident`, , `prvReadActivity`, `prvReadNoteprvIntelligenceUsage`
`summarize_account`	`prvReadAccount`
`summarize_case`	`prvReadIncident`
`summarize_case_actions`	`prvReadIncident`, `prvReadActivity`
`summarize_case_text`	`prvReadIncident`
`summarize_contact`	`prvReadContact`
`summarize_conversation`	`prvReadActivity`
`summarize_entity_timeline`	`prvReadActivity`, `prvReadNote`
`test_copilot_studio_registration_connection`	`prvmsdyn_ServiceAgentMakerCustomize`
`test_mcp_registration_connection`	`prvmsdyn_ServiceAgentMakerCustomize`
`translate_email`	`prvCreateActivity`, `prvReadActivity`
`update_case`	`prvWriteIncident`
`update_knowledge_filters`	`prvReadmsdyn_copilotagentpreference`, , `prvWritemsdyn_copilotagentpreferenceprvCreatemsdyn_copilotagentpreference`
`update_note`	`prvWriteNote`
`view_email`	`prvReadActivity`
`view_knowledge_filter_editor`	`prvReadmsdyn_copilotagentpreference`

כלים שמכוונים לפתוח

הכלים הבאים בכוונה לא מופיעים במפת ההרשאות, ולכן הם לא מוגנים בזמן הגילוי.

כלי	התנהגות פריבילגיה
`check_summary_enabled`	לא מאוחסן לגילוי. הישות שמציבה יעד אינה כוללת שער הרשאות קריאה.
`get_entity_record`	לא מאוחסן לגילוי. הישות מוכרת רק בזמן הקריאה.
`list_entity_records`	לא מאוחסן לגילוי. הישות מוכרת רק בזמן הקריאה.
`update_entity_record`	לא מאוחסן לגילוי. הישות מוכרת רק בזמן הקריאה.
`delete_entity_record`	לא מאוחסן לגילוי. ייתכן שיחולו מגבלות נוספות בצד השרת.
`get_environment`	לא מאוחסן לגילוי. ניהול סביבה.
`list_environments`	לא מאוחסן לגילוי. ניהול סביבה.
`select_environment`	לא מאוחסן לגילוי. ניהול סביבה.
`disconnect_environment`	לא מאוחסן לגילוי. ניהול סביבה.
`ext_{prefix}_{name}`	סינתז כלים חיצוניים של MCP. לא ממופה סטטית ב- `TOOL_PRIVILEGE_MAP`.
`mcs_{name}`	כלי Copilot Studio מסונתזים. לא ממופה סטטית ב- `TOOL_PRIVILEGE_MAP`.

המלצות מנהלים

הקצה הרשאות דרך חבילות מבוססות תפקידים, כגון סוכן, מחבר ידע, מנהל יוצר והעדפות משתמש.
אמת גם את נראות הכלי וגם את ביצוע זמן הריצה בסביבת בדיקה.
אם משתמש יכול לצפות בכלי אך מקבל שגיאת 403, בדוק את אכיפת הרשאות הריצה של Dataverse עבור הישות או הפעולה הבסיסית.
לאחר עדכון התפקידים, תן ל-cache-time-to-live (TTL) לעבור לפני שתאמת מחדש את הנראות.

משוב

האם עמוד זה היה מועיל?

‏‏עודכן לאחרונה בתאריך 2026-07-29