Files
agent-framework/python/samples
T
Victor Dibia c341ee7ed2 Python: DevUI - Internal Refactor, Conversations API support, and per… (#1235)
* Python: DevUI - Internal Refactor, Conversations API support, and performance improvements

Comprehensive refactor of DevUI package including samples relocation,
frontend reorganization, OpenAI Conversations API support, and critical
performance and code quality improvements.

Key Changes:

Architecture & Organization
- Moved DevUI samples to python/samples/getting_started/devui/
- Consolidated with other framework samples for better discoverability
- Added .env.example files and comprehensive README
- Restructured frontend components into feature-based folders (agent, workflow, gallery, layout)
- Created new OpenAI-compliant message renderers (devui should render oai responses types primarily)

New Features
- Added _conversations.py (467 lines) - Full conversation storage abstraction, replaces the /threads endpoint to better match oai conversations api
- Implements OpenAI Conversations API for thread management, Supports in-memory and extensible storage backends

API Simplification
- Use 'model' field as entity_id (agent/workflow name) instead of extra_body
- Use standard OpenAI 'conversation' field for conversation context.

Performance & Quality Improvements
- Improved context management in MessageMapper with bounded memory (~500KB max)
- Implemented hybrid LRU + cleanup approach to prevent unbounded memory growth
- General QOL improvement - Eliminated ~150 lines of dead/duplicate code, Consolidated helper functions into _utils.py, Extracted magic numbers to module-level constants, Optimized conversation item lookups with index-based approach

Testing
- Added test_conversations.py (13 tests)
- Added test_performance_fixes.py (9 tests)
- Updated existing tests for code consolidation
- 53 tests passing

Impact: 76 files changed: +4,106 insertions, -2,373 deletions
All linting and formatting checks passing. No breaking changes - backward compatible.

Migration: Samples moved to python/samples/getting_started/devui/

* readme lint fixes

* initial support for function approval and minor ui fixes
c341ee7ed2 · 2025-10-08 19:34:30 +00:00
History
..
2025-07-28 07:33:42 +00:00

Python Samples

This directory contains samples demonstrating the capabilities of Microsoft Agent Framework for Python.

Getting Started

For step-by-step tutorials and examples, see the getting_started directory:

  • Agents - Learn how to create and use agents with various providers (Azure OpenAI, OpenAI, Azure AI, etc.)
  • Workflows - Explore workflow patterns for orchestrating multiple agents
  • DevUI - Web interface samples for testing agents and workflows interactively
  • Chat Client - Examples of using chat clients directly
  • Threads - Manage conversation threads and chat message stores
  • Context Providers - Integrate with context providers like Mem0 and Redis
  • Middleware - Add middleware for logging, telemetry, and custom processing
  • Multimodal Input - Handle images and other multimodal inputs
  • Observability - Add tracing and monitoring to your agents
  • Tools - Examples of tool usage including AI function approval and error handling

Sample Guidelines

For information on creating new samples, see SAMPLE_GUIDELINES.md.

More Information