feat: let agents produce output files as job attachments - #1061
Open
radu-mocanu wants to merge 2 commits into
Open
feat: let agents produce output files as job attachments#1061radu-mocanu wants to merge 2 commits into
radu-mocanu wants to merge 2 commits into
Conversation
There was a problem hiding this comment.
🟡 Changes recommended
Once you've addressed the issues Copilot identified, you can request another Copilot review.
Pull request overview
Adds first-class support for agent-produced output files by introducing an internal create_output_file tool (returning a job-attachment ticket) and adding pre-termination verification that required file outputs are present and linked to the current job. This extends the agent orchestration layer to safely support output schemas that include job-attachment fields, including advanced-agent and conversational-advanced flows.
Changes:
- Introduce
create_output_fileinternal tool and sharedJOB_ATTACHMENT_DEFINITIONschema for job-attachment fields. - Add output-file field discovery + verification (including retry gating) and wire a new
VERIFY_OUTPUT_FILESnode into the ReAct and advanced-agent graphs. - Refactor conversational structured-output extraction into a reusable extractor and enable conversational advanced agents to declare additional output fields.
File summaries
| File | Description |
|---|---|
| uv.lock | Updates lock metadata and bumps package version to 0.16.14. |
| pyproject.toml | Bumps project version to 0.16.14. |
| src/uipath_langchain/agent/tools/internal_tools/schema_utils.py | Extracts reusable JOB_ATTACHMENT_DEFINITION for job-attachment schemas. |
| src/uipath_langchain/agent/tools/internal_tools/output_file_tool.py | Adds the create_output_file internal tool to publish job attachments. |
| src/uipath_langchain/agent/attachments/output_files.py | Adds output-file field discovery, prompt builder, and attachment-link verification helpers. |
| src/uipath_langchain/agent/react/types.py | Adds output-file verification state fields and a new graph node enum value. |
| src/uipath_langchain/agent/react/router.py | Routes end_execution through output-file verification when enabled. |
| src/uipath_langchain/agent/react/output_files_node.py | Adds a verification gate node that can bounce control back to the agent with corrective feedback. |
| src/uipath_langchain/agent/react/conversational_output_node.py | Refactors conversational extraction into create_conversational_output_extractor() and rewraps it as a node. |
| src/uipath_langchain/agent/react/agent.py | Wires the verification node into the standard ReAct graph when file outputs are expected. |
| src/uipath_langchain/agent/advanced/agent.py | Adds output-file verification to advanced agents and output-field extraction for conversational advanced agents. |
| tests/agent/tools/internal_tools/test_output_file_tool.py | Adds unit tests for tool schema, MIME guessing, and attachment creation behavior. |
| tests/agent/attachments/test_output_files.py | Adds tests for output-file field discovery, prompt text, and verification logic. |
| tests/agent/react/test_output_files_node.py | Adds tests for verification node behavior and graph wiring. |
| tests/agent/advanced/test_create_advanced_agent_graph.py | Adds tests asserting verification node/state wiring in advanced agent graphs. |
| tests/agent/advanced/test_conversational_advanced_agent_graph.py | Adds tests for conversational output extraction node insertion and output merging. |
Review details
- Files reviewed: 15/16 changed files
- Comments generated: 2
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
radu-mocanu
force-pushed
the
feat/agent-output-files
branch
4 times, most recently
from
September 2, 2026 11:48
cbfc104 to
d25434d
Compare
An output schema could declare a file field, but nothing could fill it: the agent had no way to create an attachment, and the termination path only validated whatever the model claimed. Add a create_output_file tool that publishes agent-authored content as a job attachment and returns the attachment ticket, plus a verification gate that runs just before termination. The gate sends the agent back with a corrective message when a required file field is empty or references an attachment that is not linked to this job, and faults only after the retries are spent. An optional file field is offered but never demanded: the prompt states the obligation per declared kind, and only a required field left empty counts as missing. A field the agent does fill is verified either way. The tool takes inline content everywhere, and a workspace path as well when the backend can resolve one, so an advanced agent does not re-emit a file body through the model. Verification is gated on the tool being present, so an agent with no way to create a file is never faulted for lacking one.
A conversational agent's loop produces messages, so nothing in it fills the fields its output schema declares. The standard path already solves this with a focused extraction call after the loop, forced onto the set_conversational_output tool. The advanced path had no equivalent and returned messages only. Split that extraction out of the react node into create_conversational_output_extractor, which is graph agnostic, and build a node over it in the conversational advanced wrapper graph. The react node keeps its behavior and now delegates. The extraction receives the whole transcript, as the standard path passes: a declared field's answer often lives in the user's message or an earlier exchange, not in what the agent just produced.
radu-mocanu
force-pushed
the
feat/agent-output-files
branch
from
September 3, 2026 14:37
d25434d to
675be9a
Compare
|
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.
Summary
create_output_filetool that publishes its content as a job attachment and returns the reference to put in that fieldWhy
files were input-only. the output schema could declare a file, and the product even nudged you toward it, but nothing could produce one: the agent had no way to create an attachment and the termination path only validated whatever the model claimed, so the field was unfillable.
Advanced agent with file output
Standard agent with file output