Update Transform MCP tool names and document the extraction tools - #3
Open
simoncoombes wants to merge 2 commits into
Open
Update Transform MCP tool names and document the extraction tools#3simoncoombes wants to merge 2 commits into
simoncoombes wants to merge 2 commits into
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
The server renamed three of its tools, so the guidance we ship as extension context named tools that no longer exist. An agent following it called
transform_filesand got an unknown-tool error.transform_filesis nowstart_transform_jobcheck_transform_statusis nowcheck_job_statusget_transform_resultsis nowget_job_resultsrequest_file_upload_urlis unchanged. Names confirmed against the live server (Unstructured Transform 0.7.2) via itsget_instructionstool, and they match the rename that already landed in the docs (Unstructured-IO/docs#1004).The same release added structured data extraction, so a second commit documents that too rather than leaving the guidance describing only half of what the server does. The new section covers the order that matters: extraction reads the element JSON a parse produces, so parse first and carry the
output_refintosuggest_extraction_schema_for_file(when the user has no schema) and thenstart_extraction_job. It also spells out the two things agents get wrong otherwise, that results come back inline rather than behind a download URL, and that they carry provenance which should be kept rather than unwrapped to bareextracted_data.I ran the flow against production before writing it up (parse an image with
strategy=vlm, draft a schema from the resultingoutput_ref, extract, read back provenance-wrapped JSON), so the documented sequence matches real behaviour.scripts/validate.shpasses. This touches a different part of AGENTS.md than #2, so the two do not conflict.