Skip to content

docs: add a built-in tools section to the tools guide - #86

Merged
frostming merged 2 commits into
mainfrom
docs/builtin-tools
Oct 21, 2026
Merged

frostming merged 2 commits into
mainfrom
docs/builtin-tools

Conversation

@frostming

Copy link
Copy Markdown
Collaborator

Adds a "Use built-in tools" section to docs/guides/tools.md, between the function and native tool sections.

  • Example using WebSearch with allowed_domains and UserLocation, reading response.citations and response.builtin_tool_calls
  • Support table for WebSearch, WebFetch, CodeExecution, and ImageGeneration across the responses, messages, gemini, and chat API formats
  • Where results appear (builtin_tool_calls, citations, image_parts) and the matching stream events
  • Continuing a turn that ends with finish_reason == "pause"

The paragraph on provider-run tools at the end of the function tools section moves into the new section.

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No blocking findings. The support table matches what each format accepts or rejects, the example's request mapping is correct, and the pause loop correctly round-trips the server tool blocks. Two documentation accuracy issues are noted inline: the citations claim does not hold for Gemini web fetch, and the pause snippet depends on names that are not in scope.

Comment thread docs/guides/tools.md Outdated
Comment thread docs/guides/tools.md
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No blocking findings.

The new section's claims hold at the current head: the support table matches each format's mapping and rejections (chat accepts only WebSearch and rejects max_uses/domain settings, responses rejects max_uses/blocked_domains, messages accepts all four it lists except image generation, gemini rejects any setting), both examples run as written, and the pause loop submits the paused assistant turn back with server_tool_use/web_search_tool_result intact.

Both findings from the previous review are repaired in df54609: the citations sentence is scoped and points Gemini users to builtin_tool_calls (thread), and the continuation snippet now defines its prompt and states that model/search come from the example above (thread).

@frostming
frostming merged commit 0f2eaa6 into main Oct 21, 2026
10 checks passed
@frostming
frostming deleted the docs/builtin-tools branch October 21, 2026 03:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant