Understand requirements and recommendations for integrating Microsoft Graph connectors with Microsoft 365 Copilot
Using Microsoft Graph connectors, you can centralize information in your organization on Microsoft 365. Importing external content to Microsoft 365 allows Microsoft 365 Copilot to reason over all information in your organization and give you relevant and accurate answers.
Follow the requirements and recommendations in this unit to improve the likelihood of displaying external content in Copilot.
Use meaningful name and description for your connection
When you create an external connection for a Graph connector, you specify the connection's name and description. Only Microsoft 365 tenant administrators can see this information. However, Microsoft 365 Copilot selects data sources relevant to your prompt based on their name and description! How you name and describe the connection so that it properly represents the type of data it imports is therefore crucial.
The following examples show a good and a bad external connection name and description:
| Name | Description | Rationale | |
|---|---|---|---|
| GOOD | products | Information about products sold by Contoso | The name clearly specifies the type of information in the connection. The description clarifies it further. |
| BAD | contosoconnection | Imports content from Contoso | Name and description don't convey what kind of information is imported in this connection |
Add semantic labels
When you define the schema for your external connection, at minimum you need to apply the iconUrl, title and url semantic labels to the relevant properties in your schema. Copilot requires you to define these labels to display external content from your connection in its responses.
We recommend that you use all semantic labels that are relevant for your imported content. It improves Copilot's ability to find relevant information for the user's prompts. For more information about the available semantic labels, see the documentation.
Configure properties as searchable
When defining the schema for your external connection, configure properties that hold the data that Copilot should search in as searchable. Without this configuration, Copilot won't be able to search in the contents of these properties and find the information relevant to the user's prompt.
Include external item content
When importing external items, include the item's content in the content property.
Enable connection for inline results
To allow Copilot to include the external content that you ingest using a custom Graph connector in its results, you need to enable the connection for inline results. Microsoft 365 tenant administrators can configure this setting in the Microsoft 365 Admin Center.