AgentScope20 行代码跑通工具调用 Agent拆解 3 个控制机制【免费下载链接】agentscopeBuild and run agents you can see, understand and trust.项目地址: https://gitcode.com/GitHub_Trending/ag/agentscopeAgentScope 是一个面向生产场景的多智能体框架把工具调用权限、上下文压缩、沙箱工作区做成了可配置的工程机制。跑通之后你手里多了一个能直接在终端执行命令、读写文件的对话 Agent工具先过审对话不会撑爆窗口。装好多智能体框架一条 import 验证环境要求 Python 3.11 及以上安装完在终端执行python -c import agentscope; print(agentscope.__version__)能打印版本号即就绪。想改源码做二次开发clonegit clone https://gitcode.com/GitHub_Trending/ag/agentscope后uv pip install -e .。uv pip install agentscope # 或 pip install agentscope三个设计决策权限、压缩、沙箱 ️权限模式改哪里、压缩阈值动哪个字段下面按取舍角度过一遍。工具调用先过权限规则BYPASS 只在沙箱里开解决的问题模型幻觉不可杜绝靠系统提示词求模型别生成危险命令不稳需要在执行层硬性拦截人随时能介入。实现路径每次工具调用先经过PermissionEngineagentscope/permission/按你配置的规则判定 allow、deny 或 askBash 按命令子串匹配Read/Write 按 glob 匹配文件路径。配置边界PermissionMode给五种模式默认 DEFAULT 逐次确认工具调用ls、git status这类只读命令自动放行BYPASS 会跳过包括危险命令警告在内的全部安全确认只在容器或虚拟机里开并用 deny 规则保护关键路径无人值守但仍要安全DONT_ASK 比 BYPASS 更稳它把所有 ask 转成 deny。80% 触发压缩两个文本字段调摘要口吻解决的问题长对话把上下文窗口填满换窗口丢掉前半程的发现返工成本高。实现路径ContextConfig监控 token 占用到阈值把旧对话重写为结构化摘要summary_schema固定五段任务概述、当前状态、重要发现、下一步计划、需保留的上下文摘要模板强制用绝对路径、绝对时间替代这个文件刚才那个方案换窗口后可直接续跑。配置边界trigger_ratio默认 0.8占满模型窗口 80% 触发上限 0.9想让摘要保留领域黑话改compression_prompt和summary_template字段别动系统提示词tool_result_limit默认 50000 token超大工具结果在此截断可再交给 offloader 外移到文件。工具清单由工作区提供换后端就是换沙箱解决的问题Bash、Read、Write 等内置工具直接挂宿主执行面没有边界。实现路径工具不直接挂系统而是绑定到 Workspaceagentscope/workspace/清单由await workspace.list_tools()给出Bash、Read、Write 到技能加载都从工作区派生执行面与宿主隔离。配置边界后端有LocalWorkspace、DockerWorkspace、E2BWorkspace等换后端等于换一整套受控的文件系统和命令环境接上AgenticMemoryMiddleware后工作区目录还能跨会话持久化长期记忆offloaderworkspace让压缩摘要和超大工具结果落到工作区文件里。20 行搭出工具调用 Agent 并打开终端对话import asyncio, os from agentscope.agent import Agent from agentscope.console import launch_console from agentscope.credential import DashScopeCredential from agentscope.model import DashScopeChatModel from agentscope.tool import Toolkit from agentscope.workspace import LocalWorkspace async def main(): async with LocalWorkspace(workdir./workspace) as workspace: agent Agent( nameFriday, system_prompt( Youre a helpful assistant named Friday.\n\n await workspace.get_instructions() ), modelDashScopeChatModel( credentialDashScopeCredential(api_keyos.environ[DASHSCOPE_API_KEY]), modelqwen3.7-max, streamTrue, ), toolkitToolkit(toolsawait workspace.list_tools()), offloaderworkspace, ) await launch_console(agent) asyncio.run(main())跑之前 export 好DASHSCOPE_API_KEY把 model 参数改成你凭据下可用的模型名workdir 默认落在脚本旁的./workspace。换其他厂商只替换 credential 与 model 参数结构同构。适配判断哪里能直接上哪里要权衡 适合直接上手要终端级带工具 Agent权限引擎默认 DEFAULT 逐次确认玩着安全规则配置在agentscope/permission/。暂时不建议裸机宿主上开无人值守长跑BYPASS 跳过全部安全确认只配容器或虚拟机隔离内使用对应PermissionMode.BYPASS。需要权衡取舍多智能体团队分工、执行者-验证者流水线要起 Agent Service 后端不止一个 Agent 类入口在agentscope/app/。延伸入口docs/更新日志 NEWS.md、changelog、roadmap 都在里面examples/console/main.py终端对话 demo接了工作区与长期记忆examples/agent_service/README.md起 Agent Service 后端与 Web UI 的方式CONTRIBUTING_zh.md贡献指南先 export 好DASHSCOPE_API_KEY直接跑examples/console/main.py第一次工具调用你会看到权限确认弹出来。【免费下载链接】agentscopeBuild and run agents you can see, understand and trust.项目地址: https://gitcode.com/GitHub_Trending/ag/agentscope创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考