Skip to content

Commit

Permalink
Updates policies sample
Browse files Browse the repository at this point in the history
  • Loading branch information
waldekmastykarz committed Sep 23, 2024
1 parent bb8f281 commit 1126c42
Show file tree
Hide file tree
Showing 5 changed files with 19 additions and 31 deletions.
26 changes: 10 additions & 16 deletions samples/nodejs-typescript-policies/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ This sample project uses Teams Toolkit for Visual Studio Code to simplify the pr
> [!NOTE]
> Sample data was generated using Artificial Intelligence. Any resemblance to real data is purely coincidental.
![Data from custom API displayed in Copilot for Microsoft 365](./assets/connector-copilot-results.png)
![External content in Microsoft 365 search results](./assets/search-results.png)

## Features

Expand All @@ -18,9 +18,7 @@ The sample illustrates the following concepts:
- simplify debugging and provisioning of resources with Teams Toolkit for Visual Studio code
- create external connection schema
- support full ingestion of data
- visualize the external content in the Policy Management declarative copilot
- visualize the external content in Copilot for Microsoft 365
- visualize the external content in search results using a custom Adaptive Card
- visualize the external content in Microsoft 365 search results

## Contributors

Expand All @@ -33,6 +31,7 @@ The sample illustrates the following concepts:

Version|Date|Comments
-------|----|--------
1.1|September 23, 2024|Updated instructions
1.0|August 27, 2024|Initial release

## Prerequisites
Expand All @@ -44,27 +43,22 @@ Version|Date|Comments

## Minimal path to awesome - Debug against a real Microsoft 365 tenant

### 1. Project setup

- Clone repo
- Open repo in VSCode
- Press <kbd>F5</kbd>, follow the sign in prompts
- When prompted, click on the link in the console to perform the tenant-wide admin consent
- Wait for all tasks to complete

### 2. Include data in results (Optional)

> This step is only required if you need to include the data in the search results in Microsoft 365 and in the general Copilot for Microsoft 365 experience. If you only want to use the connector data from a declarative copilot, you can skip this step.
- In the web browser navigate to the [Microsoft 365 admin center](https://admin.microsoft.com/)
- From the side navigation, open [Settings > Search & Intelligence](https://admin.microsoft.com/?source=applauncher#/MicrosoftSearch)
- On the page, navigate to the [Data Sources](https://admin.microsoft.com/?source=applauncher#/MicrosoftSearch/connectors) tab
- A table will display available connections. In the **Required actions** column, select the link to **Include Connector Results** and confirm the prompt
- Navigate to [Microsoft365.com/chat](https://www.microsoft365.com/chat)
- Use the following prompt: `What is the acceptable use policy?`
- A response from Copilot for Microsoft 365 will showcase the data ingested by the Graph connector.
- A table will display available connections. Locate the **Policy Management** connection. In the **Required actions** column, select the link to **Include Connector Results** and confirm the prompt
- Navigate to [Microsoft365.com](https://www.microsoft365.com)
- Using the search box on top, search for: `acceptable use policy`. You should see the following result:

![External content in Microsoft 365 search results](./assets/search-results.png)

![Empty connector copilot](./assets/connector-copilot-results.png)
> [!NOTE]
> It can take a moment for the search results to appear. If you don't see the results immediately, wait a few moments and try again.
## Help

Expand Down
Binary file not shown.
Binary file not shown.
24 changes: 9 additions & 15 deletions samples/nodejs-typescript-policies/assets/sample.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
"This sample contains a Microsoft Graph connector that shows how to ingest local policies into Microsoft 365. For each file, it extracts the metadata from front matter, maps them to the external connection's schema and ingests the content retaining the content and metadata. The ingested content is set to be visible to everyone in the organization."
],
"creationDateTime": "2024-08-27",
"updateDateTime": "2024-08-27",
"updateDateTime": "2024-09-23",
"products": [
"Microsoft Graph connectors",
"Microsoft Graph",
Expand All @@ -27,7 +27,7 @@
},
{
"key": "SEARCH-RESULTS-CARD",
"value": "Yes"
"value": "No"
},
{
"key": "TEAMS-PACKAGE",
Expand All @@ -38,14 +38,8 @@
{
"type": "image",
"order": 100,
"url": "https://github.com/pnp/graph-connectors-samples/raw/main/samples/nodejs-typescript-policies/assets/connector-copilot.png",
"alt": "Empty connector copilot"
},
{
"type": "image",
"order": 200,
"url": "https://github.com/pnp/graph-connectors-samples/raw/main/samples/nodejs-typescript-policies/assets/connector-copilot-results.png",
"alt": "Data from custom API displayed in Copilot for Microsoft 365"
"url": "https://github.com/pnp/graph-connectors-samples/raw/main/samples/nodejs-typescript-policies/assets/search-results.png",
"alt": "External content in Microsoft 365 search results"
}
],
"authors": [
Expand All @@ -61,15 +55,15 @@
}
],
"references": [
{
"name": "Integrate external content with Copilot for Microsoft 365 using Microsoft Graph connectors built with TypeScript",
"description": "Build Microsoft Graph connectors using TypeScript to import external content to Microsoft 365.",
"url": "https://learn.microsoft.com/training/modules/copilot-graph-connectors-typescript/"
},
{
"name": "Microsoft Graph connectors overview",
"description": "Learn more what Microsoft Graph connectors are and when you'd use them.",
"url": "https://learn.microsoft.com/graph/connecting-external-content-connectors-overview"
},
{
"name": "Build your first custom Microsoft Graph connector",
"description": "Learn how to build your first custom Microsoft Graph connector using .NET.",
"url": "https://learn.microsoft.com/graph/connecting-external-content-build-quickstart"
}
]
}
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 1126c42

Please sign in to comment.