diff --git a/docs/dotnet/README.md b/docs/dotnet/README.md index fd587ad2807d..45fe4e30fcd8 100644 --- a/docs/dotnet/README.md +++ b/docs/dotnet/README.md @@ -1,13 +1,16 @@ -## How to build and run the website +# How to build and run the website -### Prerequisites -- dotnet 7.0 or later +## Prerequisites + +- dotnet 8.0 or later + +## Build -### Build Firstly, go to autogen/dotnet folder and run the following command to build the website: + ```bash dotnet tool restore -dotnet tool run docfx website/docfx.json --serve +dotnet tool run docfx ../docs/dotnet/docfx.json --serve ``` -After the command is executed, you can open your browser and navigate to `http://localhost:8080` to view the website. \ No newline at end of file +After the command is executed, you can open your browser and navigate to `http://localhost:8080` to view the website. diff --git a/docs/dotnet/docfx.json b/docs/dotnet/docfx.json index 7eefe1a32b1a..f43779dd3e85 100644 --- a/docs/dotnet/docfx.json +++ b/docs/dotnet/docfx.json @@ -5,7 +5,11 @@ { "files": [ "src/Microsoft.AutoGen/Core/**/*.csproj", - "src/Microsoft.AutoGen/Contracts/**/*.csproj" + "src/Microsoft.AutoGen/Contracts/**/*.csproj", + "src/Microsoft.AutoGen/Core.Grpc/**/*.csproj", + "src/Microsoft.AutoGen/AgentHost/**/*.csproj", + "src/Microsoft.AutoGen/RuntimeGateway.Grpc/**/*.csproj", + "src/Microsoft.AutoGen/Extensions/**/*.csproj" ], "src": "../../dotnet/" } diff --git a/docs/dotnet/index.md b/docs/dotnet/index.md index e5c206c9a766..dc6dac9ece82 100644 --- a/docs/dotnet/index.md +++ b/docs/dotnet/index.md @@ -1,15 +1,6 @@ --- _disableAffix: true --- -

AutoGen .NET

@@ -23,7 +14,46 @@ _disableAffix: true
Core
+

+ +[![dotnet-ci](https://github.com/microsoft/autogen/actions/workflows/dotnet-build.yml/badge.svg)](https://github.com/microsoft/autogen/actions/workflows/dotnet-build.yml) +[![NuGet version](https://badge.fury.io/nu/Microsoft.AutoGen.Contracts.svg)](https://badge.fury.io/nu/Microsoft.AutoGen.Contracts) +[![NuGet version](https://badge.fury.io/nu/Microsoft.AutoGen.Core.svg)](https://badge.fury.io/nu/Microsoft.AutoGen.Core) +[![NuGet version](https://badge.fury.io/nu/Microsoft.AutoGen.Core.Grpc.svg)](https://badge.fury.io/nu/Microsoft.AutoGen.Core.Grpc) +[![NuGet version](https://badge.fury.io/nu/Microsoft.AutoGen.RuntimeGateway.Grpc.svg)](https://badge.fury.io/nu/Microsoft.AutoGen.RuntimeGateway.Grpc) +[![NuGet version](https://badge.fury.io/nu/Microsoft.AutoGen.AgentHost.svg)](https://badge.fury.io/nu/Microsoft.AutoGen.AgentHost) + +

An event-driven programming framework for building scalable multi-agent AI systems.

+ +- Deterministic and dynamic agentic workflows for business processes +- Research on multi-agent collaboration +- Distributed agents for multi-language applications +- integration with event-driven, cloud native applications + +*Start here if you are building workflows or distributed agent systems* + +

+

+
+
+```bash
+dotnet add package Microsoft.AutoGen.Contracts
+dotnet add package Microsoft.AutoGen.Core
+
+# optionally - for distributed agent systems:
+dotnet add package Microsoft.AutoGen.RuntimeGateway.Grpc
+dotnet add package Microsoft.AutoGen.AgentHost
+
+# other optional packages
+dotnet add package Microsoft.AutoGen.Agents
+dotnet add package Microsoft.AutoGen.Extensions.Aspire
+dotnet add package Microsoft.AutoGen.Extensions.MEAI
+dotnet add package Microsoft.AutoGen.Extensions.SemanticKernel
+```
+
+

+

Get started

diff --git a/docs/dotnet/template/public/main.css b/docs/dotnet/template/public/main.css index 6f4abd6639ec..cdc204c1fe3d 100644 --- a/docs/dotnet/template/public/main.css +++ b/docs/dotnet/template/public/main.css @@ -2,3 +2,114 @@ height: 50px; margin-right: 0.5rem; } +.bd-footer { + font-size: 0.8rem; + } + + html[data-theme="light"] { + --pst-color-primary: hsl(222.2 47.4% 11.2%); + --pst-color-secondary: #007bff; + --pst-color-secondary-bg: #007bff; + --pst-color-accent: #007bff; + --sd-color-secondary-highlight: #0062cc; + --pst-color-shadow: rgba(0, 0, 0, 0.0); + } + + html[data-theme="dark"] { + --pst-color-primary: hsl(213 31% 91%); + --pst-color-secondary: #007bff; + --pst-color-secondary-bg: #007bff; + --pst-color-accent: #007bff; + --sd-color-secondary-highlight: #0062cc; + --pst-color-shadow: rgba(0, 0, 0, 0.0); + } + + .bd-header-announcement { + color: white; + } + + .bd-header-announcement a { + color: white; + } + + .bd-header-announcement a:hover { + color: white; + text-shadow: 0.5px 0 0 currentColor; + } + + nav.bd-links .current>a { + box-shadow: inset 1px 0 0 var(--pst-color-primary); + } + + html[data-theme="light"] .bd-header { + border-bottom: 1px solid var(--pst-color-border); + } + + .admonition, div.admonition { + border: 1px solid var(--pst-color-border); + } + + .api-card { + text-align: center; + font-size: 1.2rem; + } + + .api-card svg { + font-size: 2rem; + } + + .search-button-field { + border-radius: var(--bs-btn-border-radius); + } + + .bd-content .sd-tab-set .sd-tab-content { + border: none; + border-top: 3px solid var(--pst-color-border); + + } + .bd-content .sd-tab-set>input:checked+label { + border: none; + transform: translateY(0); + font-weight: 600; + border-bottom: 2px solid var(--pst-color-secondary); + + } + .bd-content .sd-tab-set>label { + background-color: transparent; + border: none; + } + + .center { + text-align: center; +} + +.subheader { + font-size: 1.5em; +} +.hero-title { +font-size: 60px; +font-weight: bold; +margin: 2rem auto 0; +} + +.wip-card { +border: 1px solid var(--pst-color-success); +background-color: var(--pst-color-success-bg); +border-radius: .25rem; +padding: 0.3rem; +display: flex; +justify-content: center; +align-items: center; +margin-bottom: 1rem; +} +.card-title { +font-size: 1.2rem; +font-weight: bold; +} + +.card-title svg { +font-size: 2rem; +vertical-align: bottom; +margin-right: 5px; +} + \ No newline at end of file