SuperAPI AI 工具集

agent-framework-workflows-py

智能体与模型

查看项目

更新于 10-16 00:31

技能介绍

用途:在 Microsoft Agent Framework Python SDK(agent-framework)上构建确定性、可持久化、可观测的多步骤/多智能体流水线。工作流是由 Executor 节点与类型化边组成的图,Agent 可作为一等执行器,运行时可流式输出事件,状态可检查点保存与重放。

主要能力:两种等价编写风格——声明式图(Executor、@executor、@handler、WorkflowBuilder)适合分支、循环、扇出/扇入、编排模式、子工作流与检查点;函数式(@workflow、@step、ctx.request_info)适合线性或简单分支的异步 Python 管道。提供顺序、并发、交接、群聊、Magentic 等编排构建器,均支持 .build() 与 .as_agent()。支持流式事件(executor_invoked、output、intermediate、request_info、status、superstep_completed)、输出选择(output_from / intermediate_output_from)、人工介入(ctx.request_info 与 @response_handler)、检查点恢复(checkpoint_id、responses)。

使用方式:安装 pip install agent-framework --pre;可视化可选 pip install "agent-framework[viz]" --pre 并安装 GraphViz;编排构建器从 agent_framework.orchestrations 导入。嵌入 Agent 的示例使用 FoundryChatClient,需设置 FOUNDRY_PROJECT_ENDPOINT 与 FOUNDRY_MODEL,并通过 AzureCliCredential 认证(先 az login),也可替换为其他聊天客户端。

适用场景:需要确定性编排、可观测事件流、人工审批与断点续跑的多智能体应用。

限制:HandoffBuilder 要求每个参与者设置 require_per_service_call_history_persistence=True,否则 .build() 抛 ValueError;output_from 与 intermediate_output_from 存在非法组合(如 all_other 与 all 混用、重复或未知执行器、两列表均为空);状态隔离需每次运行重新构建工作流。具体收费、价格与平台支持范围暂未提供。