企业官网建设流程全解析

AgentScope 智能体框架实战指南

【免费下载链接】agentscopeBuild and run agents you can see, understand and trust.项目地址: https://gitcode.com/GitHub_Trending/ag/agentscope

AgentScope 是一个生产可用的 AI 智能体（Agent）开发框架，目标是构建、运行可观察、可理解、可信任的智能体。它解决智能体开发中的两个核心问题：推理过程与工具调用不可见，以及高风险操作不可控。AgentScope 通过完整的事件流和细粒度权限系统，使智能体行为可观察、可确认。

AgentScope 是什么

AgentScope 2.0 分为两层：SDK 层负责组装智能体，Agent Service 层负责产品化交付。SDK 层的核心构件包括：

• ReAct 循环：推理-行动循环，支持结构化输出与中断
• Toolkit：统一管理 Python 工具、MCP 服务器、技能
• Model 层：覆盖聊天、嵌入、TTS 与主流模型服务商
• 事件系统：实时流式输出推理、工具调用与多模态内容
• 权限与 HITL：细粒度权限控制，支持人工确认

核心能力速览

以上能力由内置的 Agent Service 提供：FastAPI 后端负责多租户与多会话隔离，配套 Web UI 负责可视化展示，两者可按需组合成独立应用。

🚀 3 分钟上手

要求 Python 3.11+，一行命令完成安装：uv pip install agentscope。

最小可运行示例如下，组装智能体并启动终端会话：

from agentscope.agent import Agent from agentscope.console import launch_console from agentscope.model import DashScopeChatModel from agentscope.credential import DashScopeCredential import os, asyncio agent = Agent(name="Friday", system_prompt="You're a helpful assistant.", model=DashScopeChatModel(credential=DashScopeCredential( api_key=os.environ["DASHSCOPE_API_KEY"]), model="qwen3.7-max")) asyncio.run(launch_console(agent))

设置环境变量DASHSCOPE_API_KEY后运行，智能体即在终端进入交互会话：推理与工具结果实时流式输出，敏感工具调用需按y或a确认，Ctrl+C 可中断当前回复。完整版脚本见 examples/console/main.py。

深入：AgentScope 的任务规划机制

任务规划是 AgentScope 的区分点：智能体会把复杂工作拆解为可跟踪的计划，并随执行进度持续更新。整个流程分三段：

• 输入：下达一条复杂指令，例如“梳理这个仓库并生成重构报告”
• 处理：智能体调用内置任务工具，将目标拆分为子任务并逐个跟踪
  • 工具位于 src/agentscope/tool/_task/，含 TaskCreate、TaskList、TaskUpdate
• 输出：随执行进度更新的可视化计划，工具调用与状态变化均可见

若某一步需要人工确认，事件流会停在确认点，确认后执行继续，无需从头重跑。

典型场景

• 终端调试：用 console 直接试跑智能体，不启动 Web 服务
  • 示例任务：“列出当前目录所有 Python 文件并指出潜在性能风险”
• 多智能体协作：用 Agent Service 的智能体团队分工
  • 示例任务：把“探索代码库结构”“审查安全漏洞”分派给不同工作者
• IM 接入：用渠道把智能体接入钉钉或飞书
  • 示例任务：每天早晨向群内推送“构建失败摘要”

扩展与生态

• Agent Service 是 FastAPI 应用，可替换 MCP、中间件与工作区管理器扩展为生产级多租户服务，参考 examples/agent_service/
• Web UI 为 React + Vite 项目，可在 examples/web_ui/ 中定制，覆盖模型、会话、知识库等管理界面
• 贡献与问题反馈参见 CONTRIBUTING.md，文档见 docs/

AgentScope 适合需要快速搭建智能体原型的开发者，也适合希望将智能体交付到生产环境的团队。完整可运行示例见 examples/ 目录。

【免费下载链接】agentscopeBuild and run agents you can see, understand and trust.项目地址: https://gitcode.com/GitHub_Trending/ag/agentscope