Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 7 additions & 5 deletions docs/design/agent-and-add-in-overview.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Combine Copilot Agents with Office Add-ins (preview)
description: Get an overview of why and how to combine a Copilot agent with an Office Add-in.
ms.date: 10/17/2025
ms.date: 11/11/2025
ms.topic: overview
ms.localizationpriority: medium
---
Expand Down Expand Up @@ -141,8 +141,6 @@ The agent configuration file includes instructions for the agent and specifies o
}
```

[!INCLUDE [Validation warning about missing 'auth' property](../includes/auth-property-warning-note.md)]

The reference documentation for declarative agents is at [Declarative agent schema 1.5 for Microsoft 365 Copilot](/microsoft-365-copilot/extensibility/declarative-agent-manifest-1.5).

### Copilot API plug-in configuration
Expand All @@ -154,7 +152,8 @@ The API plug-in configuration file specifies the "functions" of the plug-in in t
- The `"responding.instructions"` property only provides *guidance* to Copilot about how to respond. It doesn't put any limits or structural requirements on the response.
- The `"runtimes.run_for_functions"` array must include either the same string as `"functions.name"` or a wildcard string that matches it.
- The `"runtimes.spec.local_endpoint"` property specifies that the JavaScript function that is associated with the "fillcolor" string is available in an Office Add-in, rather than in some REST endpoint.
-The `"runtimes.spec.allowed_host"` property specifies that the agent should only be visible in Excel.
- The `"runtimes.spec.allowed_host"` property specifies that the agent should only be visible in Excel.
- The `"runtimes.auth.type"` property is always "None" for Office Add-in agents.

```json
{
Expand Down Expand Up @@ -206,7 +205,10 @@ The API plug-in configuration file specifies the "functions" of the plug-in in t
"local_endpoint": "Microsoft.Office.Addin",
"allowed_host": ["workbook"]
},
"run_for_functions": ["fillcolor"]
"run_for_functions": ["fillcolor"],
"auth": {
"type": "None"
}
}
]
}
Expand Down
10 changes: 6 additions & 4 deletions docs/develop/agent-and-add-in.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Add a Copilot agent to an add-in
description: Learn how to add a Copilot agent to an add-in.
ms.date: 10/17/2025
ms.date: 11/11/2025
ms.topic: how-to
ms.service: microsoft-365
ms.localizationpriority: medium
Expand Down Expand Up @@ -191,8 +191,6 @@ The runtime object should look similar to the following. There may be other prop
}
```

[!INCLUDE [Validation warning about missing 'auth' property](../includes/auth-property-warning-note.md)]

1. *Replace the property values with new values that are appropriate for your add-in.* For more information about these properties, see [Declarative agent manifest object](/microsoft-365-copilot/extensibility/declarative-agent-manifest-1.2#declarative-agent-manifest-object).

> [!NOTE]
Expand Down Expand Up @@ -251,7 +249,10 @@ The runtime object should look similar to the following. There may be other prop
"local_endpoint": "Microsoft.Office.Addin",
"allowed_host": ["workbook"]
},
"run_for_functions": ["FillColor"]
"run_for_functions": ["FillColor"],
"auth": {
"type": "None"
}
}
]
}
Expand All @@ -270,6 +271,7 @@ The runtime object should look similar to the following. There may be other prop
- The `"runtimes.run_for_functions"` array must include either the same string as `"functions.name"` or a wildcard string that matches it.
- The `"reasoning.description"` and `"reasoning.instructions"` refer to a JavaScript function, not a REST API.
- The `"runtimes.spec.local_endpoint"` property tells the Copilot agent to look for functions in an Office Add-in instead of at a REST service URL.
- The `"runtimes.auth.type"` property is always "None" for Office Add-in agents.

### Create the app package

Expand Down
2 changes: 0 additions & 2 deletions docs/includes/auth-property-warning-note.md

This file was deleted.

9 changes: 5 additions & 4 deletions docs/quickstarts/agent-and-add-in-quickstart.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Build your first add-in as a Copilot skill
description: Learn how to build a simple Copilot agent that has an Excel add-in as a skill.
ms.date: 10/23/2025
ms.date: 11/11/2025
ms.topic: how-to
ms.service: microsoft-365
ms.localizationpriority: high
Expand Down Expand Up @@ -160,14 +160,15 @@ Add the agent with the following steps.
"local_endpoint": "Microsoft.Office.Addin",
"allowed_host": ["workbook"]
},
"run_for_functions": ["fillcolor"]
"run_for_functions": ["fillcolor"],
"auth": {
"type": "None"
}
}
]
}
```

[!INCLUDE [Validation warning about missing 'auth' property](../includes/auth-property-warning-note.md)]

1. Open the **\src\commands\commands.ts** file and add the following code the end of it.

```javascript
Expand Down