Python: Add sample for hosted agent with files - #5596
Merged
Tao Chen (TaoChenOSU) merged 8 commits intoMay 1, 2026
Conversation
github-actions
Bot
changed the title
Evan Mattson (moonbox3)
added
the
documentation
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new Python hosted-agent sample demonstrating how to work with session-scoped files when hosting an Agent Framework agent on Foundry via the Responses protocol.
Changes:
- Introduces a new
responses/06_filessample (agent manifest, host code, docker assets, README, and example resources). - Updates sample documentation to reference required environment variables and adds a “Running the Agent Host” section in the basic sample.
- Changes the
responses/02_toolssample to allow shell tool execution without approvals.
Reviewed changes
Copilot reviewed 13 out of 16 changed files in this pull request and generated 8 comments.
Show a summary per file
| File | Description |
|---|---|
| python/samples/04-hosting/foundry-hosted-agents/README.md | Adds the new “Files” sample to the sample index table. |
| python/samples/04-hosting/foundry-hosted-agents/responses/01_basic/README.md | Adds a “Running the Agent Host” section linking to parent instructions. |
| python/samples/04-hosting/foundry-hosted-agents/responses/02_tools/main.py | Changes the shell tool to approval_mode="never_require". |
| python/samples/04-hosting/foundry-hosted-agents/responses/04_foundry_toolbox/README.md | Updates toolbox sample docs (including new env var guidance). |
| python/samples/04-hosting/foundry-hosted-agents/responses/06_files/README.md | Documents the new “files in hosted session” workflow and example invocations. |
| python/samples/04-hosting/foundry-hosted-agents/responses/06_files/main.py | Implements the hosted agent + toolbox filtering + local shell tool. |
| python/samples/04-hosting/foundry-hosted-agents/responses/06_files/requirements.txt | Declares runtime dependencies for the sample. |
| python/samples/04-hosting/foundry-hosted-agents/responses/06_files/agent.yaml | Adds hosted agent configuration for the sample. |
| python/samples/04-hosting/foundry-hosted-agents/responses/06_files/agent.manifest.yaml | Adds Foundry deployment manifest including toolbox + model resources. |
| python/samples/04-hosting/foundry-hosted-agents/responses/06_files/Dockerfile | Containerizes the new sample agent host. |
| python/samples/04-hosting/foundry-hosted-agents/responses/06_files/.dockerignore | Excludes local-only files from the sample’s container build. |
| python/samples/04-hosting/foundry-hosted-agents/responses/06_files/.env.example | Documents required env vars for running the sample. |
| python/samples/04-hosting/foundry-hosted-agents/responses/06_files/resources/contoso_q1_2026_report.txt | Provides a fictional report used as upload/demo content. |
| python/samples/04-hosting/foundry-hosted-agents/responses/06_files/resources/start-a-session.png | Screenshot used in sample docs. |
| python/samples/04-hosting/foundry-hosted-agents/responses/06_files/resources/session-started.png | Screenshot used in sample docs. |
| python/samples/04-hosting/foundry-hosted-agents/responses/06_files/resources/file-upload-portal.png | Screenshot used in sample docs. |
…iles/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…iles/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…iles/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…oundry_toolbox/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…iles/README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Tao Chen (TaoChenOSU)
marked this pull request as ready for review
April 30, 2026 21:38
Ben Thomas (alliscode)
approved these changes
Apr 30, 2026
Tao Chen (TaoChenOSU)
enabled auto-merge
April 30, 2026 23:22
Ben Thomas (alliscode)
approved these changes
Apr 30, 2026
chetantoshniwal
approved these changes
May 1, 2026
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.
Motivation and Context
Add a sample to show how to work with session files in hosted agent.
Contribution Checklist