Skip to content

Commit af5d224

Browse files
authored
Merge pull request #9334 from gladysaj/update-connector-description
docs: add connector description details
2 parents ef336a8 + ca2d0ac commit af5d224

File tree

1 file changed

+9
-4
lines changed

1 file changed

+9
-4
lines changed

concepts/connecting-external-content-experiences.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -42,12 +42,17 @@ To configure your connector for Context IQ:
4242
To make sure that Copilot for Microsoft 365 uses your content effectively:
4343

4444
- Apply [semantic labels](/graph/connecting-external-content-manage-schema). Semantic labels help Copilot for Microsoft 365 interpret the semantic meaning of your schema. Apply as many of them to your schema as applicable. The `iconUrl`, `title`, and `url` labels must be applied for content to surface in Copilot. Users can use semantic labels as part of their prompts in Copilot, but they won't get the expected response if the respective semantic label isn't applied.
45-
- Apply the `searchable` property label to schema properties with stored content that you would like your users' prompts to match against in Copilot. The `searchable` label is the most important with respect to Copilot because it defines which schema properties can be searched against.
46-
- Add a [urlToItemResolver](/graph/api/resources/externalconnectors-urltoitemresolverbase) in [activitySettings](/graph/api/resources/externalconnectors-activitysettings) when you [create your connection](/graph/connecting-external-content-manage-connections#create-a-connection). A `urlToItemResolver` enables the platform to detect when users share URLs from your external content with each other. Copilot for Microsoft 365 has a higher likelihood of displaying content that has been shared with that user.
45+
- Apply the **searchable** property label to schema properties with stored content that you would like your users' prompts to match against in Copilot. The `searchable` label is the most important with respect to Copilot because it defines which schema properties can be searched against.
46+
- Add a [urlToItemResolver](/graph/api/resources/externalconnectors-urltoitemresolverbase) in [activitySettings](/graph/api/resources/externalconnectors-activitysettings) when you [create your connection](/graph/connecting-external-content-manage-connections#create-a-connection). A **urlToItemResolver** enables the platform to detect when users share URLs from your external content with each other. Copilot for Microsoft 365 has a higher likelihood of displaying content that has been shared with that user.
4747
- Add [user activities](/graph/api/externalconnectors-externalitem-addactivities) on your items. For a list of supported activity types, see [externalActivity](/graph/api/resources/externalconnectors-externalactivity). Items that have more activities are boosted in importance.
48-
- Provide meaningful descriptions in the `description` property when [creating connections](/graph/api/externalconnectors-external-post-connections). Rich descriptions improve the likelihood of displaying content in Copilot.
48+
- Provide meaningful descriptions in the **description** property when [creating connections](/graph/api/externalconnectors-external-post-connections). Rich descriptions improve the likelihood of content displaying in Copilot. The connection description should briefly answer the following questions:
4949

50-
In addition, search administrators should ensure that your Microsoft Graph connector connections are enabled for [inline results](/microsoftsearch/connectors-in-all-vertical), by using the following steps:
50+
- What kind of content does this connection have?
51+
- How do users refer to this content source in their respective organizations?
52+
- During what part of the workflow do users refer to this content in their day-to-day work?
53+
- What are some characteristics of the content?
54+
55+
In addition, search administrators should ensure that your Microsoft Graph connector connections are enabled for [inline results](/microsoftsearch/connectors-in-all-vertical) by using the following steps:
5156

5257
- Open the Admin Center, go to **Search & intelligence** > **Customizations** > **Verticals** and select the **All** vertical.
5358
- Select **Manage connector result**. Ensure that **Show results inline** is selected and that the connections that you want to enable for Search and Copilot are checked.

0 commit comments

Comments
 (0)