🔄 使用 GitHub 模型 (.NET) 的基本代理工作流程

📋 工作流程编排教程

本笔记本演示了如何使用 Microsoft Agent Framework for .NET 和 GitHub 模型构建复杂的代理工作流程。您将学习创建多步骤业务流程，其中 AI 代理通过结构化编排模式协作完成复杂的任务。

🎯 学习目标

🏗️ 工作流程架构基础知识

  • 工作流程构建器：设计和编排复杂的多步骤人工智能流程
  • 代理协调：协调工作流程中的多个专业代理
  • GitHub 模型集成：在工作流程中利用 GitHub 的 AI 模型推理服务
  • 可视化工作流程设计：创建和可视化工作流程结构以更好地理解

🔄 流程编排模式

  • 顺序处理：按逻辑顺序链接多个代理任务
  • 状态管理：维护跨工作流程阶段的上下文和数据流
  • 错误处理：实施强大的错误恢复和工作流程弹性
  • 性能优化：为企业规模运营设计高效的工作流程

🏢 企业工作流程应用程序

  • 业务流程自动化：自动化复杂的组织工作流程
  • 内容制作管道：具有审核和批准阶段的编辑工作流程
  • 客户服务自动化：多步骤解决客户询问
  • 数据处理工作流程：具有 AI 支持的转换的 ETL 工作流程

⚙️ 先决条件和设置

📦 所需的 NuGet 包

此工作流程演示使用了几个关键的 .NET 包：

1
2
3
4
5
6
7
8
9
<!-- Core AI Framework -->
<PackageReference Include="Microsoft.Extensions.AI" Version="9.9.0" />

<!-- Agent Framework (Local Development) -->
<!-- Microsoft.Agents.AI.dll - Core agent abstractions -->
<!-- Microsoft.Agents.AI.OpenAI.dll - OpenAI/GitHub Models integration -->

<!-- Configuration and Environment -->
<PackageReference Include="DotNetEnv" Version="3.1.1" />

🔑 GitHub 模型配置

环境设置（.env 文件）：

1
2
3
GITHUB_TOKEN=your_github_personal_access_token
GITHUB_ENDPOINT=https://models.inference.ai.azure.com
GITHUB_MODEL_ID=gpt-4o-mini

GitHub 模型访问：

  1. 注册 GitHub Models（目前处于预览版）
  2. 生成具有模型访问权限的个人访问令牌
    3.如上图配置环境变量

🏗️ 工作流程架构概述

1
2
3
4
5
6
7
8
9
graph TD
    A[Workflow Builder] --> B[Agent Registry]
    B --> C[Workflow Execution Engine]
    C --> D[Agent 1: Content Generator]
    C --> E[Agent 2: Content Reviewer] 
    D --> F[Workflow Results]
    E --> F
    G[GitHub Models API] --> D
    G --> E

关键组件：

  • WorkflowBuilder：用于设计工作流程的主要编排引擎
  • AIAgent：具有特定能力的个人专业代理
  • GitHub Models Client：AI模型推理服务集成
  • 执行上下文：管理工作流程阶段之间的状态和数据流

🎨 企业工作流程设计模式

📝 内容制作工作流程

1
User Request → Content Generation → Quality Review → Final Output

🔍 文档处理管道

1
Document Input → Analysis → Extraction → Validation → Structured Output

💼 商业智能工作流程

1
Data Collection → Processing → Analysis → Report Generation → Distribution

🤝 客户服务自动化

1
Customer Inquiry → Classification → Processing → Response Generation → Follow-up

🏢 企业福利

🎯 可靠性和可扩展性

  • 确定性执行：一致、可重复的工作流程结果
  • 错误恢复：在任何工作流程阶段妥善处理故障
  • 性能监控：跟踪执行指标和优化机会
  • 资源管理：AI模型资源的高效分配和利用

🔒 安全与合规性

  • 安全身份验证：用于 API 访问的基于 GitHub 令牌的身份验证
  • 审计跟踪：完整记录工作流程执行和决策点
  • 访问控制：工作流程执行和监控的精细权限
  • 数据隐私：在整个工作流程中安全处理敏感信息

📊 可观察性和管理

  • 可视化工作流程设计：清晰地表示流程和依赖关系
  • 执行监控：实时跟踪工作流程进度和绩效
  • 错误报告：详细的错误分析和调试功能
  • 性能分析：优化和容量规划的指标

让我们构建您的第一个企业级人工智能工作流程！ 🚀

💻 运行代码

完整的实现可在 01.dotnet-agent-framework-workflow-ghmodel-basic.cs 中找到。该文件演示了：

  1. 环境配置 - 从 .env 文件加载 GitHub Models 凭证
  2. OpenAI 客户端设置 - 配置客户端以使用 GitHub Models 端点
  3. 代理创建 - 定义专业代理（前台和礼宾部）
  4. 工作流生成器 - 创建具有顺序处理的多代理工作流
  5. 工作流程执行 - 使用流结果运行工作流程

🚀 运行示例

1
2
3
4
5
# Make the script executable (Unix/Linux/macOS)
chmod +x 01.dotnet-agent-framework-workflow-ghmodel-basic.cs

# Run the workflow
./01.dotnet-agent-framework-workflow-ghmodel-basic.cs

或者在 Windows 上：

1
dotnet run 01.dotnet-agent-framework-workflow-ghmodel-basic.cs

📝 预期输出

工作流程将：

  1. 接受您的旅行目的地请求（“我想去巴黎”）
  2. 前台代理提供初步建议
  3. 礼宾人员审核并完善推荐
  4. 最终输出显示完整的对话流

🔧 定制

您可以通过以下方式自定义工作流程：

  • 修改代理指令以改变他们的行为
  • 添加更多代理以创建复杂的多步骤工作流程
  • 更改用户消息以测试不同场景
  • 调整工作流程边缘以创建不同的执行模式