国潮造物局 · 实操文章
Microsoft AutoGen完整入门：运行一个只有单次任务的代理示例
从官方入口、安装与首次配置开始，跟做“运行一个只有单次任务的代理示例”，附样例、流程图、验收与故障排查。
本页目录 · 14个部分
01 先知道要做成什么02 官方入口、下载与安装03 账户、费用与准备04 核对版本05 配置模型客户端06 先跑一个AssistantAgent07 关闭连接并复核08 跟做材料／可复制示例09 保存、导出与交付10 做完怎么验收11 常见卡点与排查12 使用真实资料前工具与原始资料动手验证国潮造物局编辑部 · 资料整理日期 2026-10-21 · 企业应用 · 12分钟
资料核对：2026-10-21。官方stable入门与迁移索引已核对；未运行模型任务。 图为本站原创操作示意，不是软件界面截图。
01 先知道要做成什么
运行一个只有单次任务的代理示例。本篇只教一个能检查结果的首个任务，再扩展到真实工作；不把生成一次等同于专业交付。
02 官方入口、下载与安装
这是Python框架。创建独立虚拟环境，按官方Installation安装 autogen-agentchat 与所需模型扩展；例如使用OpenAI兼容官方支持路线时：python -m pip install -U autogen-agentchat "autogen-ext[openai]"。提供方支持以扩展文档为准。
03 账户、费用与准备
Python环境、模型提供方账户与环境变量密钥；先读stable文档，不混用v0.2的ConversableAgent旧教程。 安装工具、下载模型、调用云服务可能分别计费。先查看官方要求与许可，密钥只存凭证设置或环境变量，不放提示词。
04 核对版本
记录pip安装版本，打开stable的AgentChat Quickstart。将示例保存到空项目，不在生产仓库直接复制执行。
05 配置模型客户端
使用官方Quickstart对应客户端与模型，密钥通过环境变量读取，不直接写进源文件。第三方兼容接口参数另按其官方文档核对。
06 先跑一个AssistantAgent
只给一个代理、一次短任务，不启用命令执行。任务为整理三条事实，避免先上群聊和无限自动回复。
07 关闭连接并复核
按Quickstart的异步入口运行并在结束时关闭模型客户端，保存结果；之后再研究团队、终止条件和人工接管。
08 跟做材料／可复制示例
将以下保存为main.py；在终端安全设置OPENAI_API_KEY与OPENAI_MODEL（选择官方客户端识别且账户可用的模型），不要把密钥写入文件。运行 python main.py，会产生模型API费用。
import asyncio
import os
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient
async def main():
client = OpenAIChatCompletionClient(
model=os.environ["OPENAI_MODEL"],
api_key=os.environ["OPENAI_API_KEY"],
)
try:
agent = AssistantAgent(
"fact_checker", model_client=client,
system_message="只提取输入事实，不补未知内容。",
)
result = await agent.run(task="A杯39元，350ml，不保温。列三条事实。")
print(result.messages[-1].content)
finally:
await client.close()
asyncio.run(main())09 保存、导出与交付
保存脚本、包版本、输出和成本记录，代码示例以官方Quickstart为准。
10 做完怎么验收
单次任务能结束；没有执行系统命令；输出三条事实且无新增内容。 建议记录：输入、实际输出、是否通过、需修改的地方。先用一条正例和一条反例，确认后再扩大批量。
11 常见卡点与排查
旧版导入报错先查迁移指南；轮次失控先停任务并添加终止条件，不能靠增大token上限掩盖循环。
12 使用真实资料前
先用本篇虚构样例练习，再替换成经授权并脱敏的材料。涉及账号、客户、商业和个人信息时先确认平台数据处理规则。对外发布前核对事实、权利和访问权限；官网界面更新时以官方帮助为准。