docs: document async tools, deserialization allowlist, and SkillToolset - #11877
Merged
Conversation
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
4 tasks
sjrl
reviewed
Jul 8, 2026
|
|
||
| `SkillToolset` lets an [`Agent`](../pipeline-components/agents-1/agent.mdx) use skills through *progressive disclosure*, similar to how coding assistants like Claude Code expose skills: the model first sees only each skill's name and description, loads the full instructions when a task calls for them, and fetches bundled files only when the instructions reference them. This keeps the context small even with many detailed skills. | ||
|
|
||
| The toolset exposes two tools: |
Contributor
There was a problem hiding this comment.
Might be worth adding a note how users can enable executing scripts bundled with tools. E.g. Include their own custom bash tool or script execution tool alongside the SkillsToolset.
Otherwise by default SkillsToolset only supports reading skill files and not executing anything.
Explain that load_skill/read_skill_file are read-only and that users must provide their own execution tool alongside the toolset to run scripts bundled with skills. Addresses review feedback. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…e mentions, deep-link SkillToolset API reference Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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
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.
Related Issues
SkillsToolsetto enable Haystack's Agent to read Skills #11459ImageContentandFileContentsupport toread_skill_fileinSkillsToolset#11681Proposed Changes:
Tooldocs: the dataclass listing now includesasync_function, and a new "Async Tools" section covers@toolonasync def, theinvoke/invoke_asyncinteraction , and cross-linked notes onComponentToolandPipelineTool. ThePipelineToolpage also drops its mention ofAsyncPipeline.allowed_moduleskwarg,allow_deserialization_module,HAYSTACK_DESERIALIZATION_ALLOWLISTenv var), pattern-matching rules (prefix match by default;fnmatchonly for wildcards other than a trailing.*, so"mypkg"and"mypkg.*"behave identically — matching_module_matchesand MIGRATION.md), theunsafe=Trueescape hatch, and the nestedinit_parametersvalidation with its "may surface pre-existing YAML bugs" caveat.SkillsToolsetto enable Haystack's Agent to read Skills #11459/feat: AddingImageContentandFileContentsupport toread_skill_fileinSkillsToolset#11681 — newSkillToolsetpage: discovery concept, two tools, theSKILL.mdformat with filesystem layout,FileSystemSkillStoreand theSkillStoreprotocol for custom backends, the one-toolset-per-Agent limitation, and multimodal skill assets. Added to the sidebar after SearchableToolset; the API reference cell deep-links to/reference/tools-api#skilltoolset.How did you test it?
v3: async@toolrouting andinvoke_asyncfallback,ToolInvocationErrorfrom syncinvokeon async-only tools,DeserializationErrorfor untrusted modules, theallowed_modules/unsafekwargs andallow_deserialization_moduleimport path, and a fullSkillToolsetround trip over a temporary skills directory.Notes for the reviewer
Checklist
fix:,feat:,build:,chore:,ci:,docs:,style:,refactor:,perf:,test:and added!in case the PR includes breaking changes.🤖 Generated with Claude Code