Privilegiereference for Customer Service Copilot-værktøjer

Customer Service Copilot bruger Microsoft Dataverse-privilegier til at kontrollere, hvilke værktøjer en bruger kan opdage og køre. Denne artikel oplister de privilegier, som hvert værktøj kræver, så administratorer kan konfigurere rollebaseret adgang. Værktøjerne leveres af Dynamics 365 Customer Service MCP Server og Power Service Agent-scenarier i Microsoft 365 Copilot.

Sådan fungerer værktøjsadgang

  • For at opdage et værktøj skal en bruger have alle de privilegier, der er angivet for det pågældende værktøj.
  • Værktøjer, der ikke er på privilegiekortet, er utilgængelige ved opdagelse, så de er altid opdagbare uanset privilegier.
  • Hvis et privilege-opslag fejler, er discovery fail-open, så værktøjer kan stadig dukke op. Dataverse kan dog stadig returnere en HTTP 403 (forbudt) fejl ved eksekveringstidspunktet.

Værktøj-til-privilegie-reference

I den følgende tabel er flere privilegier komma-adskilte, og en bruger har brug for dem alle for, at værktøjet kan findes. Værktøjer, der bevidst udelades fra privilegietjekket, er listet i Bevidst uoprettede værktøjer.

Værktøj Påkrævede rettigheder
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, prvWriteIncident, prvCreateActivity
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, prvReadActivity, prvReadNote
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, prvReadActivity, prvReadmsdyn_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, , prvReadSLAKPIInstanceprvReadQueue,prvReadQueueItem
reassign_case prvWriteIncident, prvCreateNote
recommend_email_templates prvReadEmailTemplate
resolve_case_and_pick_next prvReadIncident, prvWriteIncident, prvCreateActivity
rewrite_structured_content prvReadmsdyn_rtestructuredtemplate, , prvReadmsdyn_rtestructuredtemplateconfigprvReadmsdyn_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, , prvReadActivityprvReadNote,prvIntelligenceUsage
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_copilotagentpreference, prvCreatemsdyn_copilotagentpreference
update_note prvWriteNote
view_email prvReadActivity
view_knowledge_filter_editor prvReadmsdyn_copilotagentpreference

Bevidst ubehandlede redskaber

Følgende værktøjer er bevidst ikke opført i privilegiekortet, så de ikke er låst ved opdagelsestidspunktet.

Værktøj Privilegeret adfærd
check_summary_enabled Ubehandlet ved opdagelse. Målindstillingsenheden har ingen læseprivilegie-gate.
get_entity_record Ubehandlet ved opdagelse. Entiteten kendes kun ved opkaldstidspunktet.
list_entity_records Ubehandlet ved opdagelse. Entiteten kendes kun ved opkaldstidspunktet.
update_entity_record Ubehandlet ved opdagelse. Entiteten kendes kun ved opkaldstidspunktet.
delete_entity_record Ubehandlet ved opdagelse. Yderligere server-side begrænsninger kan gælde.
get_environment Ubehandlet ved opdagelse. Miljøstyring.
list_environments Ubehandlet ved opdagelse. Miljøstyring.
select_environment Ubehandlet ved opdagelse. Miljøstyring.
disconnect_environment Ubehandlet ved opdagelse. Miljøstyring.
ext_{prefix}_{name} Syntetiserede eksterne MCP-værktøjer. Ikke statisk kortlagt i TOOL_PRIVILEGE_MAP.
mcs_{name} Syntetiserede Copilot Studio-værktøjer. Ikke statisk kortlagt i TOOL_PRIVILEGE_MAP.

Administratoranbefalinger

  1. Tildel rettigheder gennem rollebaserede pakker, såsom Agent, Knowledge Author, Maker Admin og User Preferences.
  2. Valider både værktøjssynlighed og runtime-udførelse i et testmiljø.
  3. Hvis en bruger kan se et værktøj, men modtager en 403-fejl, skal du tjekke Dataverse-runtime-privilegiehåndhævelsen for den underliggende enhed eller handling.
  4. Efter du har opdateret rollerne, skal du lade cache-time-to-live (TTL) udløbe, før du validerer synligheden igen.