[All Hosts] (copilot) various technical changes (#5277)

Rick-Kirkham · ElizabethSamuel-MSFT · web-flow · commit 6c9dfabdfaea · 2025-07-14T12:25:55.000-07:00
* various technical changes

* Update docs/quickstarts/agent-and-add-in-quickstart.md

Co-authored-by: Elizabeth Samuel &lt;elizs@microsoft.com&gt;

---------

Co-authored-by: Elizabeth Samuel &lt;elizs@microsoft.com&gt;
diff --git a/docs/design/agent-and-add-in-overview.md b/docs/design/agent-and-add-in-overview.md
@@ -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: 06/10/2025
+ms.date: 07/15/2025
 ms.topic: overview
 ms.localizationpriority: medium
 ---
@@ -141,18 +141,18 @@ The agent configuration file includes instructions for the agent and specifies o
 }
 ```
 
-The reference documentation for declarative agents is at [Declarative agent schema 1.3 for Microsoft 365 Copilot](/microsoft-365-copilot/extensibility/declarative-agent-manifest-1.3).
+The reference documentation for declarative agents is at [Declarative agent schema 1.4 for Microsoft 365 Copilot](/microsoft-365-copilot/extensibility/declarative-agent-manifest-1.4).
 
 ### Copilot API plug-in configuration
 
 The API plug-in configuration file specifies the "functions" of the plug-in in the sense of agent actions, not JavaScript functions, including the instructions for the action. It also configures the JavaScript runtime for Copilot. The following is an example. About this JSON, note the following:
 
 - The `"functions.name"` must match the `"extensions.runtimes.actions.id"` property in the add-in manifest.
 - The `"reasoning.description"` and `"reasoning.instructions"` refer to a JavaScript function, not a REST API.
-- 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 `"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 is new and isn't yet in the main reference documentation for the API plugins schema. See below for more about it. In this case, it 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 is new and isn't yet in the main reference documentation for the API plugins schema. See below for more about it. In this case, it specifies that the agent should only be visible in Excel.
+- 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.
 
 ```json
 {
@@ -168,18 +168,18 @@ The API plug-in configuration file specifies the "functions" of the plug-in in t
             "parameters": {
                 "type": "object",
                 "properties": {
-                    "Cell": {
+                    "cell": {
                         "type": "string",
                         "description": "A cell location in the format of A1, B2, etc.",
                         "default" : "B2"
                     },
-                    "Color": {
+                    "color": {
                         "type": "string",
                         "description": "A color in hex format, e.g., #30d5c8",
                         "default" : "#30d5c8"
                     }
                 },
-                "required": ["Cell", "Color"]
+                "required": ["cell", "color"]
             },
             "returns": {
                 "type": "string",
@@ -210,12 +210,7 @@ The API plug-in configuration file specifies the "functions" of the plug-in in t
 }
 ```
 
-The reference documentation for API plug-ins is at [API plugin manifest schema 2.3 for Microsoft 365 Copilot](/microsoft-365-copilot/extensibility/api-plugin-manifest-2.3). The following is the documentation for two new properties of the `"runtimes.spec"` property.
-
-| Property | Type | Description |
-| -------- | ---- | ----------- |
-| `local_endpoint` | String | Optional. The ID of a set of available JavaScript functions. This property is roughly analogous to the [`"runtimes.spec.url"`](/microsoft-365-copilot/extensibility/api-plugin-manifest-2.3#openapi-specification-object) property, but for local functions on the client, not REST APIs. Currently, the only allowed value is "Microsoft.Office.Addin".|
-| `allowed_host` | String | Optional. Specifies which Office application Copilots can host the agent. Possible values are "document", "mail", "presentation", and "workbook".|
+The reference documentation for API plug-ins is at [API plugin manifest schema 2.3 for Microsoft 365 Copilot](/microsoft-365-copilot/extensibility/api-plugin-manifest-2.3).
 
 ## Create the JavaScript functions
 
diff --git a/docs/develop/agent-and-add-in.md b/docs/develop/agent-and-add-in.md
@@ -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: 06/10/2025
+ms.date: 07/15/2025
 ms.topic: how-to
 ms.service: microsoft-365
 ms.localizationpriority: medium
@@ -86,7 +86,7 @@ Office.onReady(function() {
 });
 
 async function fillColorFromUserData(message) {
-    const {Cell: cell, Color: color} = JSON.parse(message);
+    const {cell, color} = JSON.parse(message);
     await Excel.run(async (context) => {
       context.workbook.worksheets
         .getActiveWorksheet()
@@ -213,18 +213,18 @@ The runtime object should look similar to the following. There may be other prop
                 "parameters": {
                     "type": "object",
                     "properties": {
-                        "Cell": {
+                        "cell": {
                             "type": "string",
                             "description": "A cell location in the format of A1, B2, etc.",
                             "default" : "B2"
                         },
-                        "Color": {
+                        "color": {
                             "type": "string",
                             "description": "A color in hex format, e.g., #30d5c8",
                             "default" : "#30d5c8"
                         }
                     },
-                    "required": ["Cell", "Color"]
+                    "required": ["cell", "color"]
                 },
                 "returns": {
                     "type": "string",
@@ -267,7 +267,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 is new and isn't yet in the main reference documentation for the API plugins schema. See below for more about it. It tells the Copilot agent to look for functions in an Office Add-in instead of at a REST service URL.
+   - 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.
 
 ### Create the app package
 
@@ -324,7 +324,7 @@ In a command prompt or Visual Studio Code **TERMINAL** in the root of the projec
    - With Copilot open to the list of agents, click the cursor on the Copilot window and press <kbd>Ctrl</kbd>+<kbd>R</kbd>.
 
    :::image type="content" source="../images/copilot-agent-list.png" alt-text="A screenshot of the agent list in the Copilot pane in an Office application":::
-   
+
 1. When the agent is listed, select it and the pane for the agent opens. The conversation starters you configured in the `"conversation_starters"` property of declarative agent configuration file will be displayed.
 1. Select a conversation starter, and then press the **Send** control in the conversation box at the bottom of the pane. Select **Confirm** in response to the confirmation prompt. The agent action occurs.
 1. Try entering prompts the conversation box that are different from the conversation starters, but that your agent should be able to do.
diff --git a/docs/quickstarts/agent-and-add-in-quickstart.md b/docs/quickstarts/agent-and-add-in-quickstart.md
@@ -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: 06/10/2025
+ms.date: 07/15/2025
 ms.topic: how-to
 ms.service: microsoft-365
 ms.localizationpriority: high
@@ -20,11 +20,11 @@ In this article, you'll walk through the process of building a simple Excel Copi
 ## Software prerequisites
 
 - All the prerequisites listed at [Create declarative agents using Microsoft 365 Agent Toolkit](/microsoft-365-copilot/extensibility/build-declarative-agents).
-- The [Microsoft 365 Agent Toolkit](../develop/teams-toolkit-overview.md). 
+- The [Microsoft 365 Agent Toolkit](../develop/teams-toolkit-overview.md).
 
 ## Start with an Office Add-in
 
-Create a basic Excel add-in with the following steps. 
+Create a basic Excel add-in with the following steps.
 
 1. Create an Office Add-in in Microsoft 365 Agent Toolkit by following the instructions in [Create Office Add-in projects with Microsoft 365 Agent Toolkit](../develop/teams-toolkit-overview.md#create-an-office-add-in-project). *Stop after the project is created. Don't carry out the steps in the sideloading section.*
 
@@ -124,18 +124,18 @@ Add the agent with the following steps.
                 "parameters": {
                     "type": "object",
                     "properties": {
-                        "Cell": {
+                        "cell": {
                             "type": "string",
                             "description": "A cell location in the format of A1, B2, etc.",
                             "default" : "B2"
                         },
-                        "Color": {
+                        "color": {
                             "type": "string",
                             "description": "A color in hex format, e.g., #30d5c8",
                             "default" : "#30d5c8"
                         }
                     },
-                    "required": ["Cell", "Color"]
+                    "required": ["cell", "color"]
                 },
                 "returns": {
                     "type": "string",
@@ -180,7 +180,7 @@ Add the agent with the following steps.
 
    Office.onReady((info) => {
         Office.actions.associate("fillcolor", async (message) => {
-            const {Cell: cell, Color: color} = JSON.parse(message);
+            const {cell, color} = JSON.parse(message);
             await fillcolor(cell, color);
             return "Cell color changed.";
         });
@@ -290,7 +290,7 @@ Add the agent with the following steps.
 1. In a command prompt or Visual Studio Code **TERMINAL** in the root of the project, run `npm run dev-server` to start the server on localhost. Wait until you see a line in the server window that the app compiled successfully. This means the server is running and serving the files.
     
     > [!NOTE]
-    > If this is the first time inover a month you have run a local server for an Office Add-in on your computer, you may be prompted to delete an old certificate and/or to install a new one. Agree to both prompts.
+    > If this is the first time in over a month you have run a local server for an Office Add-in on your computer, you may be prompted to delete an old certificate and to install a new one. Agree to both prompts.
 
 1. The first step in testing depends on the platform.
 
@@ -302,7 +302,6 @@ Add the agent with the following steps.
    - Wait a few minutes and reload Copilot.
    - With Copilot open to the list of agents, click the cursor on the Copilot window and press <kbd>Ctrl</kbd>+<kbd>R</kbd>.
 
-
 1. When the agent is listed, select it. The **Excel Add-in + Agent** pane opens.
 1. Select the **Change cell color** conversation starter, and then press the **Send** control in the conversation box at the bottom of the pane. Select **Confirm** in response to the confirmation prompt. The cell's color should change.
 
