备注
Go to the end to download the full example code.
可视化
AgentScope 支持包括 Gradio 和 AgentScope Studio 在内的可视化,以提高用户体验。
Gradio
首先,请确保已安装完整版本的 AgentScope, 其中包含 Gradio 包。
# From pypi
pip install agentscope[full]
# From source code
cd agentscope
pip install .[full]
之后,请确保您的应用程序被封装在一个 main 函数中。
from agentscope.agents import DialogAgent, UserAgent
import agentscope
def main():
# Your code here
agentscope.init(model_configs={
"config_name": "my-qwen-max",
"model_type": "dashscope_chat",
"model_name": "qwen-max"
})
agent = DialogAgent(
name="Alice,
model_config_name="my-qwen-max",
sys_prompt="You're a helpful assistant named Alice."
)
user = UserAgent(agent)
msg = None
while True:
msg = agent(msg)
msg = user(msg)
if msg.content == "exit":
break
然后在终端执行以下命令启动 Gradio UI:
as_gradio {path_to_your_python_code}
最后,您可以访问 Gradio UI,如下所示:

AgentScope Studio
AgentScope Studio 是一个开源的 Web UI 工具包,用于构建和监控多智能体应用程序。它提供以下功能:
仪表板: 一个用于监控正在运行的应用程序,查看、管理运行历史的界面。
工作站: 一个拖拽式构建应用的低代码开发界面。
服务器管理器: 一个用于管理大规模分布式应用的界面。
画廊: 工作站中应用程序示例。(即将推出!)
启动 AgentScope Studio
要启动 Studio,首先确保您已安装最新版本的 AgentScope。然后运行以下 Python 代码:
import agentscope
agentscope.studio.init()
或者可以在终端中运行以下命令:
as_studio
之后,可以访问 http://127.0.0.1:5000 上的 AgentScope Studio,将显示以下页面:

当然,也可以更改主机和端口,并通过提供以下参数链接到你的应用程序运行历史记录:
import agentscope
agentscope.studio.init(
host="127.0.0.1", # AgentScope Studio的IP地址
port=5000, # AgentScope Studio的端口号
run_dirs = [ # 应用运行历史的文件目录
"xxx/xxx/runs",
"xxx/xxx/runs"
]
)
仪表板
仪表板是一个 Web 界面,用于监控您正在运行的应用程序并查看运行历史记录。
注意
目前,仪表板存在以下限制,我们正在努力改进。欢迎任何反馈、贡献或建议!
运行的应用程序和 AgentScope Studio 必须运行在同一台机器上,以保证”URL/路径一致性”。如果您想在其他机器上访问 AgentScope,您可以尝试通过在远程机器上运行以下命令来转发端口:
# 假设 AgentScope 运行在{as_host}:{as_port},远程机器的端口是{remote_machine_port}
ssh -L {remote_machine_port}:{as_host}:{as_port} [{user_name}@]{as_host}
对于分布式应用程序,支持单机多进程模式,但尚不支持多机多进程模式。
注册应用程序
在启动 AgentScope Studio 后,可以通过在 agentscope.init() 中指定 studio_url 来注册正在运行的应用程序:
import agentscope
agentscope.init(
# ...
project="xxx",
name="xxx",
studio_url="http://127.0.0.1:5000" # AgentScope Studio的URL
)
注册后,可以在仪表板中查看正在运行的应用程序。为了区分不同的应用程序,可以指定应用程序的项目和名称。

单击状态为 waiting 的程序,即可进入执行界面。例如,下图显示了一个对话界面。

备注
一旦注册了正在运行的应用程序,`agentscope.agents.UserAgent` 类中的输入操作将转移到 AgentScope Studio 的仪表板。
导入运行历史记录
在 AgentScope 中,运行历史记录默认保存在 ./runs 目录中。如果您想在仪表板中查看这些运行历史记录,可以在 agentscope.studio.init() 中指定 run_dirs :
import agentscope
agentscope.studio.init(
run_dirs = ["xxx/runs"]
)
Total running time of the script: (0 minutes 0.000 seconds)