掌握使用Qwen運行代理：從安裝到自定義自治工作流程

28次閱讀

截至2025年12月，阿里雲的Qwen系列，尤其是Qwen3型號，在代理功能方面表現出色，通過工具調用、規劃和內存實現自主任務執行。官方的Qwen-Agent框架簡化了構建LLM驅動的代理，支持函數調用、模型上下文協議（MCP）、代碼解釋、檢索增強生成（RAG）和GUI部署等功能。本指南詳細介紹了安裝、配置、基本和高級用法、本地部署選項（例如Ollama、vLLM）和實際示例，允許開發人員爲從Web瀏覽到複雜推理的任務創建強大的自主代理。

Qwen-Agent框架的核心特性

模塊化組件

Qwen-Agent提供原子構建塊：LLM包裝器（通過本機函數調用繼承BaseChatModel）、工具（繼承BaseTool）和高級代理（例如，單代理任務的Assistant類）。

高級能力

並行功能呼喚效率。

外部工具（例如，數據庫、文件系統）的MCP集成。

內置工具：代碼解釋器、圖像生成、網絡搜索。

支持Qwen3中的思維模式（推理與非思維速度）。

通過Gradio進行快速原型設計的GUI。

部署靈活性

與DashScope API、本地OpenAI兼容服務器（vLLM、SGLang、Ollama）和自定義端點兼容。

安裝和設置

從安裝框架開始：

pip install -U "qwen-agent[gui,rag,code_interpreter,mcp]"

對於最小的設置：pip install-U qwen-agent。

對於本地模型，請單獨安裝Ollama或vLLM。通過Ollama下載Qwen3模型（例如，ollama運行qwen3：8b）。

爲API設置環境變量（例如，用於雲訪問的DASHSCOPE_API_KEY）。

基本教程：運行簡單代理

配置LLM並實例化一個Assistant代理：

from qwen_agent.agents import Assistantllm_cfg = {    'model': 'qwen3-32b',  # Or 'qwen-max-latest' for cloud    'model_server': 'http://localhost:8000/v1',  # For local vLLM/Ollama    'api_key': 'EMPTY',    'generate_cfg': {'top_p': 0.8}}system_instruction = "You are a helpful assistant."tools = ['code_interpreter', 'my_image_gen']  # Built-in toolsbot = Assistant(llm=llm_cfg, system_message=system_instruction, function_list=tools)messages = [{'role': 'user', 'content': 'Generate an image of a futuristic city and analyze it with code.'}]response = list(bot.run(messages))print(response)

高級配置：本地部署和自定義工具

將Ollama用於離線代理

運行ollama服務並配置：

llm_cfg['model_server'] = 'http://localhost:11434/v1'llm_cfg['model'] = 'qwen3:8b'

非常適合以隱私爲中心的自治代理。

自定義工具與MCP集成

爲持久工具（例如SQLite、文件系統）定義MCP服務器：

{  "mcpServers": {    "sqlite": {"command": "uvx", "args": ["mcp-server-sqlite", "--db-path", "data.db"]}  }}

通過數據庫查詢代理的配置加載。

GUI部署

啓動交互式演示：

from qwen_agent.gui import WebUIWebUI(bot).run()

高級代理集成以增強代理可靠性

對於需要網絡訪問或繞過限制（例如瀏覽工具）的代理，集成代理。IPFLY提供與SOCKS5兼容的住宅代理，在190多個國家/地區擁有超過9000萬個IP，確保99.9%的正常運行時間和無限併發——這對於處理實時數據獲取的自治代理至關重要。

代理提供商比較：IPFLY與替代品

IPFLY的ISP分配的住宅IP提供獨家、穩定的連接，檢測風險低，優於容易被禁止的共享免費代理。無限流量支持密集的代理運行，不像有上限的選項。高級加密和全球低延遲增強了工具調用的可靠性，而競爭對手往往在一致性和支持方面猶豫不決。

想要訪問被封鎖的海外學術數據庫、受地理限制的流媒體平臺或跨境平臺後端？不要讓地理障礙阻礙你！立即訪問IPFLY.net特定地區的代理（190+個國家），然後加入IPFLY Telegram社區-獲取“解鎖NetflixUS/BBC UK的分步指南”和“跨境學術資源訪問提示”。輕鬆繞過限制，自由訪問全球資源！