mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
e-straight
7189caabc7
* Update README with enhanced highlights and streamlined getting started - Added banner image for professional branding - Updated highlights section to focus on key features: multi-agent orchestration, workflows, AF Labs, DevUI, Python/C# support, observability, multiple providers, and middleware - Streamlined getting started section with direct links to comprehensive guides - Fixed file paths in samples section and removed outdated Azure integration reference - Improved overall structure and readability * Update NuGet package documentation and add framework icon - Added comprehensive high-level summary for Microsoft Agent Framework - Included key features highlighting multi-agent orchestration, workflows, observability, and cross-platform support - Added agent-framework-icon.png for NuGet package branding * Update README.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update dotnet/nuget/NUGET.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Mark Wallace <127216156+markwallace-microsoft@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
59 lines
4.1 KiB
Markdown
59 lines
4.1 KiB
Markdown
|
|
|
|
# Welcome to Microsoft Agent Framework!
|
|
[](https://discord.gg/b5zjErwbQM)
|
|
|
|
|
|
Welcome to Microsoft's comprehensive multi-language framework for building, orchestrating, and deploying AI agents with support for both .NET and Python implementations. This framework provides everything from simple chat agents to complex multi-agent workflows with graph-based orchestration.
|
|
|
|
### 📋 Getting Started
|
|
|
|
**Quick Installation:**
|
|
- **Python**: `pip install agent-framework`
|
|
- **.NET**: `dotnet add package Microsoft.Agents.AI`
|
|
|
|
**Complete Getting Started Guides:**
|
|
- **[.NET Getting Started Guide](./user-documentation-dotnet/getting-started/README.md)** - Complete setup and usage instructions
|
|
- **[Python Getting Started Guide](./user-documentation-python/getting-started/package_installation.md)** - Installation and first steps
|
|
|
|
### ✨ **Highlights**
|
|
- **Multi-Agent Orchestration**: Coordinate multiple agents with sequential, concurrent, group chat, and handoff patterns
|
|
- [Python samples](./python/samples/getting_started/workflow/orchestration/) | [.NET samples](./dotnet/samples/GettingStarted/AgentOrchestration/)
|
|
- **Graph-based Workflows**: Connect agents and deterministic functions using data flows with streaming, checkpointing, human-in-the-loop, and time-travel capabilities
|
|
- [Python workflows](./python/samples/getting_started/workflow/) | [.NET workflows](./dotnet/samples/GettingStarted/Workflows/)
|
|
- **AF Labs**: Experimental packages for cutting-edge features including benchmarking, reinforcement learning, and research initiatives
|
|
- [Labs directory](./python/packages/lab/)
|
|
- **DevUI**: Interactive developer UI for agent development, testing, and debugging workflows
|
|
- [DevUI package](./python/packages/devui/)
|
|
- **Python and C#/.NET Support**: Full framework support for both Python and C#/.NET implementations with consistent APIs
|
|
- [Python packages](./python/packages/) | [.NET source](./dotnet/src/)
|
|
- **Observability**: Built-in OpenTelemetry integration for distributed tracing, monitoring, and debugging
|
|
- [Python observability](./python/samples/getting_started/workflow/observability/) | [.NET telemetry](./dotnet/samples/GettingStarted/AgentOpenTelemetry/)
|
|
- **Multiple Agent Provider Support**: Support for various LLM providers with more being added continuously
|
|
- [Python examples](./python/samples/getting_started/agents/) | [.NET examples](./dotnet/samples/GettingStarted/AgentProviders/)
|
|
- **Middleware**: Flexible middleware system for request/response processing, exception handling, and custom pipelines
|
|
- [Python middleware](./python/samples/getting_started/middleware/) | [.NET middleware](./dotnet/samples/GettingStarted/Agents/Agent_Step14_Middleware/)
|
|
|
|
### 💬 **We want your feedback!**
|
|
- For bugs, please file a [GitHub issue](https://github.com/microsoft/agent-framework/issues).
|
|
|
|
## More Examples & Samples
|
|
|
|
### Python
|
|
- [Getting Started with Agents](./python/samples/getting_started/agents): basic agent creation and tool usage
|
|
- [Chat Client Examples](./python/samples/getting_started/chat_client): direct chat client usage patterns
|
|
- [Getting Started with Workflows](./python/samples/getting_started/workflow): basic workflow creation and integration with agents
|
|
|
|
### .NET
|
|
- [Getting Started with Agents](./dotnet/samples/GettingStarted/Agents): basic agent creation and tool usage
|
|
- [Agent Provider Samples](./dotnet/samples/GettingStarted/AgentProviders): samples showing different agent providers
|
|
- [Workflow Samples](./dotnet/samples/GettingStarted/Workflows): advanced multi-agent patterns and workflow orchestration
|
|
|
|
## Agent Framework Documentation
|
|
|
|
- [Python documentation](./user-documentation-python/README.md)
|
|
- [DotNet documentation](./user-documentation-dotnet/README.md)
|
|
- [Agent Framework Repository](https://github.com/microsoft/agent-framework)
|
|
- [Design Documents](./docs/design)
|
|
- [Architectural Decision Records](./docs/decisions)
|
|
- [MSFT Learn Docs](https://learn.microsoft.com/agent-framework/overview/agent-framework-overview) |