Skip to content

Commit 771ce6f

Browse files
authored
Merge pull request #13 from webmachinelearning/explainer-update
fix typos and update authors
2 parents 7617586 + 719715e commit 771ce6f

File tree

1 file changed

+6
-7
lines changed

1 file changed

+6
-7
lines changed

docs/explainer.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ _Enabling web apps to provide JavaScript-based tools that can be accessed by AI
55
> August 13, 2025
66
>
77
> Brandon Walderman <code>&lt;brwalder@microsoft.com&gt;</code><br>
8+
> Leo Lee <code>&lt;leo.lee@microsoft.com&gt;</code><br>
89
> Andrew Nolan <code>&lt;annolan@microsoft.com&gt;</code><br>
910
> David Bokan <code>&lt;bokan@google.com&gt;</code><br>
1011
> Khushal Sagar <code>&lt;khushalsagar@google.com&gt;</code><br>
@@ -64,7 +65,7 @@ There are several advantages to using the web to connect agents to services:
6465
Users often start with a vague goal which is refined over time. Consider a user browsing for a high-value purchase.
6566
The user may prefer to start their journey on a specific page, ask their agent to perform some of the more tedious
6667
actions ("find me some options for a dress that's appropriate for a summer wedding, preferably red or orange, short
67-
or no sleeves and no embelishments"), and then take back over to browse among the agent-selected options.
68+
or no sleeves and no embellishments"), and then take back over to browse among the agent-selected options.
6869

6970
* **Allows authors to serve humans and agents from one source**
7071

@@ -78,8 +79,6 @@ WebMCP is a proposal for a web API that enables web pages to provide agent-speci
7879
In contrast, in a backend integration, the agent-service interaction takes place directly, without an associated UI. If
7980
a UI is required it must be provided by the agent itself or somehow connected to an existing UI manually:
8081

81-
The expected flow using browser agents and WebMCP:
82-
8382
![A diagram showing an agent communicating with a third-party service directl via MCP](../content/explainer_mcp.svg)
8483

8584
## Goals
@@ -124,7 +123,7 @@ _The current document has registered a WebMCP tool that the agent notices may be
124123
filterTemplates(description)
125124
```
126125

127-
_The agent invokes the tool: `filterTemplate("sprint themed, date and time displayed prominently, white background")`.
126+
_The agent invokes the tool: `filterTemplate("spring themed, date and time displayed prominently, white background")`.
128127
The UI updates to show a filtered list matching this description._
129128

130129
**Agent**: Ok, the remaining templates should now match your description.
@@ -188,7 +187,7 @@ _The agent takes this action using a sequence of tool calls which might look som
188187
* `AddPage("DUPLICATE")`
189188
* `EditDesign("Change the call-to-action text to 'Come for the bargains, stay for the cookies'")`
190189

191-
_Jen now has 3 versions of the same yard sale flyer. Easely implements these WebMCP tools using AI-based techinques on
190+
_Jen now has 3 versions of the same yard sale flyer. Easely implements these WebMCP tools using AI-based techniques on
192191
their backend to allow a natural language interface. Additionally, the UI presents these changes to Jen as an easily
193192
reversible batch of "uncommitted" changes, allowing her to easily review the agent's actions and make changes or undo as
194193
necessary. While the site could also implement a chat interface to expose this functionality with their own agent, the
@@ -207,7 +206,7 @@ an `orderPrints` tool:
207206
*
208207
* copies - A number between 0 and 1000 indicating how many copies of the design to print. Required.
209208
* page_size - The paper type to use. Available options are [Legal, Letter, A4, A5]. Default is "Letter".
210-
* page_finish - What kind of paper finish to use. Available options are [Regular, Glosys Photo, Matte Photo].
209+
* page_finish - What kind of paper finish to use. Available options are [Regular, Glossy Photo, Matte Photo].
211210
* Default is "Regular"
212211
*/
213212
orderPrints(copies, page_size, page_finish);
@@ -354,7 +353,7 @@ getTryRunStatuses();
354353
*
355354
* bot_name - The name of the bot, as returned from getTryRunStatuses, to get failure snippet from
356355
*/
357-
getTryRunFaliureSnippet(bot_name)
356+
getTryRunFailureSnippet(bot_name)
358357
```
359358

360359
_The agent calls `getTryRunStatuses()` to find the names of the failing bots. It returns:_

0 commit comments

Comments
 (0)