Skip to content

Python: docs: add self-hosting sample snippets #7104

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
eavanvalkenburg wants to merge 3 commits into
base: main
Choose a base branch
from
+4 −1
Open

Python: docs: add self-hosting sample snippets #7104

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
34d5c12
docs: add self-hosting sample snippets
eavanvalkenburg Jul 14, 2026
0917a6e
docs: use stable hosting sample ranges
eavanvalkenburg Jul 14, 2026
c103ae7
docs: address hosting sample review feedback
eavanvalkenburg Jul 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions python/samples/04-hosting/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,15 @@ This directory contains Python samples that demonstrate different ways to host A
| Azure Functions | HTTP or serverless hosting on Azure Functions. | [`azure_functions/README.md`](./azure_functions/README.md) |
| Durable Task | Durable execution, long-running flows, or orchestration patterns. | [`durabletask/README.md`](./durabletask/README.md) |
| Foundry Hosted Agents | Microsoft Foundry hosted agent deployment. | [`foundry-hosted-agents/README.md`](./foundry-hosted-agents/README.md) |
| Self-Hosted Protocol Helpers | Application-owned OpenAI Responses endpoints or Telegram bots. | [`af-hosting/README.md`](./af-hosting/README.md) |

## How to Choose

- Start with **A2A** if you want one agent to call or expose another agent over the A2A protocol.
- Start with **Azure Functions** if you want an HTTP-hosted or serverless entry point using Azure Functions.
- Start with **Durable Task** if you need persistent state, durable workflows, or orchestration across multiple steps.
- Start with **Foundry Hosted Agents** if you want to package and deploy an agent as a hosted agent in Microsoft Foundry.
- Start with **Self-Hosted Protocol Helpers** if you want to own the web framework or native SDK, routing, authorization, and state storage while using OpenAI Responses or Telegram helpers.

## Common Prerequisites

Expand Down
3 changes: 2 additions & 1 deletion python/samples/AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,8 @@ python/samples/
│ └── visualization/ # Workflow visualization
├── 04-hosting/ # Deployment & hosting
│ ├── a2a/ # Agent-to-Agent protocol
│ ├── azure-functions/ # Azure Functions samples
│ ├── af-hosting/ # Native Responses and Telegram hosting
│ ├── azure_functions/ # Azure Functions samples
│ └── durabletask/ # Durable task framework
├── 05-end-to-end/ # Complete applications
│ ├── chatkit-integration/
Expand Down
Loading