tool use without auto execution #162
Open
+148
−10
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Added detailed explanations for tool use modes, including examples for open loop and closed loop execution.
Updated README to clarify tool-call and tool-result usage.
Added new types and enums for tool calls and responses.
Author
tomayac
reviewed
Nov 26, 2025
Contributor
tomayac
left a comment
tomayac
left a comment
There was a problem hiding this comment.
Tried to make the code samples more readable and correct. Maybe consider running them all through a tool like prettier, which catches typos like missing commas or parentheses.
As general feedback, could the explainer outline why developers would choose closed vs. open?
Comment on lines
+180
to
+185
| await session.append([ | ||
| {role: "user", content: "What is the weather in Seattle?"}, | ||
| {role: "tool-call", content: {type: "tool-call", value: {callID:" get_weather_1", name: "get_weather", arguments: {location:"Seattle"}}}, | ||
| {role: "tool-result", content: {type: "tool-response", value: {callID: "get_weather_1", name: "get_weather", result: [{type:"object", value: {temperature: "55F", humidity: "67%"}}]}}, | ||
| {role: "assistant", content: "The temperature in Seattle is 55F and humidity is 67%"}, | ||
| ]); |
Contributor
There was a problem hiding this comment.
Suggested change
| await session.append([ | |
| {role: "user", content: "What is the weather in Seattle?"}, | |
| {role: "tool-call", content: {type: "tool-call", value: {callID:" get_weather_1", name: "get_weather", arguments: {location:"Seattle"}}}, | |
| {role: "tool-result", content: {type: "tool-response", value: {callID: "get_weather_1", name: "get_weather", result: [{type:"object", value: {temperature: "55F", humidity: "67%"}}]}}, | |
| {role: "assistant", content: "The temperature in Seattle is 55F and humidity is 67%"}, | |
| ]); | |
| await session.append([ | |
| { role: "user", content: "What is the weather in Seattle?" }, | |
| { | |
| role: "tool-call", | |
| content: { | |
| type: "tool-call", | |
| value: { | |
| callID: " get_weather_1", | |
| name: "get_weather", | |
| arguments: { location: "Seattle" }, | |
| }, | |
| }, | |
| }, | |
| { | |
| role: "tool-result", | |
| content: { | |
| type: "tool-response", | |
| value: { | |
| callID: "get_weather_1", | |
| name: "get_weather", | |
| result: [ | |
| { type: "object", value: { temperature: "55F", humidity: "67%" } }, | |
| ], | |
| }, | |
| }, | |
| }, | |
| { | |
| role: "assistant", | |
| content: "The temperature in Seattle is 55F and humidity is 67%", | |
| }, | |
| ]); |
| ]); | ||
| ``` | ||
| Note that "role" and "type" now supports "tool-call" and "tool-result". |
Contributor
There was a problem hiding this comment.
Suggested change
| Note that "role" and "type" now supports "tool-call" and "tool-result". | |
| Note that `"role"` and `"type"` now support `"tool-call"` and `"tool-result"`. |
Comment on lines
+200
to
+212
| sessionOptions = structuredClone(options); | ||
| sessionOptions.expectedOutputs.push(["tool-call"]); | ||
| session = await LanguageModel.create(sessionOptions); | ||
|
|
||
| var result = await session.prompt("What is the weather in Seattle?"); | ||
| if (result.type=="tool-call") { | ||
| if (result.name == "get_weather") { | ||
| const tool_result = getWeather(result.arguments.location); | ||
| result = session.prompt([{role:"tool-result", content: {type: "tool-result", value: {callId: result.callID, name: result.name, result: [{type:"object", value: tool_result}]}}}]) | ||
| } | ||
| } else{ | ||
| console.log(result) | ||
| } |
Contributor
There was a problem hiding this comment.
Suggested change
| sessionOptions = structuredClone(options); | |
| sessionOptions.expectedOutputs.push(["tool-call"]); | |
| session = await LanguageModel.create(sessionOptions); | |
| var result = await session.prompt("What is the weather in Seattle?"); | |
| if (result.type=="tool-call") { | |
| if (result.name == "get_weather") { | |
| const tool_result = getWeather(result.arguments.location); | |
| result = session.prompt([{role:"tool-result", content: {type: "tool-result", value: {callId: result.callID, name: result.name, result: [{type:"object", value: tool_result}]}}}]) | |
| } | |
| } else{ | |
| console.log(result) | |
| } | |
| sessionOptions = structuredClone(options); | |
| sessionOptions.expectedOutputs.push(["tool-call"]); | |
| session = await LanguageModel.create(sessionOptions); | |
| var result = await session.prompt("What is the weather in Seattle?"); | |
| if (result.type == "tool-call") { | |
| if (result.name == "get_weather") { | |
| const tool_result = getWeather(result.arguments.location); | |
| result = session.prompt([ | |
| { | |
| role: "tool-result", | |
| content: { | |
| type: "tool-result", | |
| value: { | |
| callId: result.callID, | |
| name: result.name, | |
| result: [{ type: "object", value: tool_result }], | |
| }, | |
| }, | |
| }, | |
| ]); | |
| } | |
| } else { | |
| console.log(result); | |
| } |
| #### Closed Loop: | ||
| To enable automatic execution, add a `execute` function for each tool's implementation, and add a `toolUseConfig` to indicate that execution is enabled and pose a max number of tool calls invoked in a single session generation: |
Contributor
There was a problem hiding this comment.
Suggested change
| To enable automatic execution, add a `execute` function for each tool's implementation, and add a `toolUseConfig` to indicate that execution is enabled and pose a max number of tool calls invoked in a single session generation: | |
| To enable automatic execution, add an `execute` function for each tool's implementation, and add a `toolUseConfig` to indicate that execution is enabled and pose a max number of tool calls invoked in a single session generation: |
| sessionOptions.expectedOutputs.push(["tool-call"]); | ||
| session = await LanguageModel.create(sessionOptions); | ||
|
|
||
| var result = await session.prompt("What is the weather in Seattle?"); |
Contributor
There was a problem hiding this comment.
Suggested change
| var result = await session.prompt("What is the weather in Seattle?"); | |
| let result = await session.prompt("What is the weather in Seattle?"); |
| Example: | ||
| ```js | ||
| sessionOptions = structuredClone(options); |
Contributor
There was a problem hiding this comment.
Suggested change
| sessionOptions = structuredClone(options); | |
| const sessionOptions = structuredClone(options); |
| ```js | ||
| sessionOptions = structuredClone(options); | ||
| sessionOptions.expectedOutputs.push(["tool-call"]); | ||
| session = await LanguageModel.create(sessionOptions); |
Contributor
There was a problem hiding this comment.
Suggested change
| session = await LanguageModel.create(sessionOptions); | |
| const session = await LanguageModel.create(sessionOptions); |
Co-authored-by: Thomas Steiner <tomac@google.com>
Co-authored-by: Thomas Steiner <tomac@google.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Update explainer and spec to support tool use functionalities without automatic execution.
Explainer: added an example and explained how to make tool calls
Spec: reflect IDL changes in https://chromium-review.googlesource.com/c/chromium/src/+/7092943
Preview | Diff