Update Transform MCP tool names and cover the extraction tools - #9
Open
simoncoombes wants to merge 2 commits into
Open
Update Transform MCP tool names and cover the extraction tools#9simoncoombes 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 tools and added structured data extraction, so this example named tools that no longer exist and taught only half of what the server does.
Renames, verified against the live server (Unstructured Transform 0.7.2) via
get_instructionsand consistent with Unstructured-IO/docs#1004:transform_filesis nowstart_transform_jobcheck_transform_statusis nowcheck_job_statusget_transform_resultsis nowget_job_resultsrequest_file_upload_urlis unchanged.The Vercel example's system prompt now also teaches extraction: parse first, keep the
output_ref, draft a schema withsuggest_extraction_schema_for_fileif the user has not supplied one, thenstart_extraction_joband poll with the same status and results tools. Two things that trip agents up are called out explicitly - extraction results come back inline rather than behind a download URL, and they carry provenance that should be kept rather than reporting bareextracted_data. I raised the step budget because a parse-then-extract chain runs two polling loops, and noted that the 60smaxDurationcan be tight for it.The Cline docs here had the same gap:
llms-install.mdasked the agent to verify only the four parse tools, and the README described a parse only. Both now cover extraction, and the root README's tool list gainsget_instructions.I ran the full flow against production before writing it up (parse an image with
strategy=vlm, suggest a schema from the resultingoutput_ref, extract, read back provenance-wrapped JSON) so the prompt matches real behaviour.The install page carrying the same example code is updated in Unstructured-IO/docs#1028.