Eduard van Valkenburg
d08200d00e
* Bump Python package versions for 1.12.0 release Bump packages represented in the 1.12.0 changelog, promote Foundry Hosting, Azure Content Understanding, Gemini, Mistral, Monty, and Tools to beta, and apply the requested beta cohort date stamp. Root and core move to 1.12.0, released and RC packages use their selected increments, alpha packages including Hosting MCP use the 260721 stamp, and core floors are raised only for proven consumers. Copilot-Session: 2dd9980a-b869-4c16-8642-75b7a6d6ebdf * fix version in readme * Add Responses conversation ID changes to release notes Include the breaking Hosting Responses conversation ID helper changes from #7234 in the Python 1.12.0 changelog. Copilot-Session: 2dd9980a-b869-4c16-8642-75b7a6d6ebdf
41 lines
1.6 KiB
Markdown
41 lines
1.6 KiB
Markdown
# Get Started with Agent Framework for Python
|
|
|
|
This folder contains a progressive set of samples that introduce the core
|
|
concepts of **Agent Framework** one step at a time.
|
|
|
|
## Prerequisites
|
|
|
|
```bash
|
|
pip install agent-framework-foundry
|
|
```
|
|
|
|
Sample 08 additionally requires `agent-framework-azurefunctions --pre`.
|
|
|
|
Set the required environment variables:
|
|
|
|
```bash
|
|
export FOUNDRY_PROJECT_ENDPOINT="https://your-project-endpoint"
|
|
export FOUNDRY_MODEL="gpt-4o" # optional, defaults to gpt-4o
|
|
```
|
|
|
|
## Samples
|
|
|
|
| # | File | What you'll learn |
|
|
|---|------|-------------------|
|
|
| 1 | [01_hello_agent.py](01_hello_agent.py) | Create your first agent and run it (streaming and non-streaming). |
|
|
| 2 | [02_add_tools.py](02_add_tools.py) | Define a function tool with `@tool` and attach it to an agent. |
|
|
| 3 | [03_multi_turn.py](03_multi_turn.py) | Keep conversation history across turns with `AgentSession`. |
|
|
| 4 | [04_memory.py](04_memory.py) | Add dynamic context with a custom `ContextProvider`. |
|
|
| 5 | [05_functional_workflow_with_agents.py](05_functional_workflow_with_agents.py) | Call agents inside a functional workflow. |
|
|
| 6 | [06_functional_workflow_basics.py](06_functional_workflow_basics.py) | Write a workflow as a plain async function. |
|
|
| 7 | [07_first_graph_workflow.py](07_first_graph_workflow.py) | Chain executors into a graph workflow with edges. |
|
|
| 8 | [08_host_your_agent.py](08_host_your_agent.py) | Host a single agent with Azure Functions. |
|
|
|
|
Run any sample with:
|
|
|
|
```bash
|
|
python 01_hello_agent.py
|
|
```
|
|
|
|
These samples use Azure Foundry models with the Responses API. To switch providers, just replace the client, see [all providers](../02-agents/providers/README.md)
|