Files
agent-framework/python/samples/getting_started/durabletask/01_single_agent
T
Laveesh Rohra e3eff65a6b Python: Complete durableagent package (#3058)
* Add worker and clients

* Clean code and refactor common code

* Implement sample

* Add sample

* Update readmes

* Fix tests

* Fix tests

* Update requirements

* Fix typo

* Address comments

* use response.text
e3eff65a6b ยท 2026-01-07 13:53:21 -08:00
History
..

Single Agent Sample

This sample demonstrates how to use the durable agents extension to create a worker-client setup that hosts a single AI agent and provides interactive conversation via the Durable Task Scheduler.

Key Concepts Demonstrated

  • Using the Microsoft Agent Framework to define a simple AI agent with a name and instructions.
  • Registering durable agents with the worker and interacting with them via a client.
  • Conversation management (via threads) for isolated interactions.
  • Worker-client architecture for distributed agent execution.

Environment Setup

See the README.md file in the parent directory for more information on how to configure the environment, including how to install and run common sample dependencies.

Running the Sample

With the environment setup, you can run the sample using separate worker and client processes:

Start the worker:

cd samples/getting_started/durabletask/01_single_agent
python worker.py

The worker will register the Joker agent and listen for requests.

In a new terminal, run the client:

python client.py

The client will interact with the Joker agent:

Starting Durable Task Agent Client...
Using taskhub: default
Using endpoint: http://localhost:8080

Getting reference to Joker agent...
Created conversation thread: a1b2c3d4-e5f6-7890-abcd-ef1234567890

User: Tell me a short joke about cloud computing.

Joker: Why did the cloud break up with the server?
Because it found someone more "uplifting"!

User: Now tell me one about Python programming.

Joker: Why do Python programmers prefer dark mode?
Because light attracts bugs!

Viewing Agent State

You can view the state of the agent in the Durable Task Scheduler dashboard:

  1. Open your browser and navigate to http://localhost:8082
  2. In the dashboard, you can view the state of the Joker agent, including its conversation history and current state

The agent maintains conversation state across multiple interactions, and you can inspect this state in the dashboard to understand how the durable agents extension manages conversation context.