XAgent的部署及运行

大家好，欢迎来到IT知识分享网。

源代码clone

git clone

config 文件的修改

在XAgent源码目录，运行 vi .env， 修改以下配置条目

CONFIG_FILE=assets/gpt-3.5-turbo_config.yml 

python环境

python >=3.10

安装conda，通过conda激活python3.10的环境

wget https://repo.anaconda.com/archive/Anaconda3-2023.03-1-Linux-x86_64.sh # 修改执行权限 chmod 777 Anaconda3-2023.03-1-Linux-x86_64.sh # 执行 ./Anaconda3-2023.03-1-Linux-x86_64.sh # 创建python3.10+ 的环境 conda create --name py310 python=3.10 #查看新创建的环境  conda info --envs # conda environments: # # base * /root/anaconda3 # py310 /root/anaconda3/envs/py310 # 激活py310环境 activate py310 # 重新进入shell后，查看python的版本 python --version 

PIP

安装pip包

# 下载安装脚本 wget https://bootstrap.pypa.io/get-pip.py # 运行安装脚本 python3 get-pip.py 

docker的部署及运行

确保已安装docker，在XAgent源码目录，运行以下命令，从代码builddocker

docker compose build # 如果不是第一次build，可以加上--no-cache参数，强制不使用缓存，否则build内容可能不会被更新 docker compose build --no-cache 

看到以下提示时，运行完毕

=> [ 4/12] RUN apt update && apt install -y build-essential make openjdk-17-jdk-headless curl docker.io docker-compose psmisc sudo 41.5s => [ 5/12] RUN pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple 1.9s => [ 6/12] RUN pip install playwright && playwright install chromium && playwright install-deps 83.0s => [ 7/12] COPY ToolServer/ToolServerNode/requirements.txt . 0.1s => [ 8/12] RUN pip install --no-cache-dir -r requirements.txt 144.4s => [ 9/12] RUN rm -rf /tmp/* /var/tmp/* 0.4s => [10/12] COPY ToolServer/ToolServerNode . 0.1s => [11/12] RUN mkdir -p assets 0.2s => [12/12] RUN mkdir -p workspace 0.2s => exporting to image 9.8s => => exporting layers 9.8s => => writing image sha256:45e525fd5f2f9fbbb7679ecd4b4a0658f6aaa39c0c87758b64 0.0s => => naming to docker.io/xagentteam/toolserver-node:latest 

使用 docker images 命令查看，可以看到xagent的几个images已经出现在列表中

REPOSITORY TAG IMAGE ID CREATED SIZE xagentteam/toolserver-node latest 45e525fd5f2f 18 minutes ago 3.75GB xagentteam/xagent-server latest 829edddf670b 19 minutes ago 1.29GB xagentteam/toolserver-manager latest 1fab5aa2bb99 22 minutes ago 1.03GB xagentteam/toolserver-monitor latest 803d4cd44e84 23 minutes ago 1.02GB 

再运行

# 拉取的依赖容器并启动相应的服务 docker compose up 

再使用 docker images 命令查看，依赖的images，比如redis，mongo，mysql也出现在列表中。在这里需要注意，系统中的某些端口不能被占用，比如3306，否则就会导致相应的应用启动失败

REPOSITORY TAG IMAGE ID CREATED SIZE xagentteam/toolserver-node latest 45e525fd5f2f 23 minutes ago 3.75GB xagentteam/xagent-server latest 829edddf670b 24 minutes ago 1.29GB xagentteam/toolserver-manager latest 1fab5aa2bb99 28 minutes ago 1.03GB xagentteam/toolserver-monitor latest 803d4cd44e84 28 minutes ago 1.02GB redis latest a39f 9 days ago 138MB mongo latest 5acb2131d51f 11 days ago 757MB mysql latest f7fdab215ab7 7 weeks ago 605MB 

同时，一些容器也会在系统中创建成功，可以使用docker ps –no-trunc查看（我的这个列表中mysql容器因为端口原因就启动失败了，需要更改被占用的端口后重启）

[root@opencloudos XAgent-1.0.0]# docker ps --no-trunc NAMES 0cb3036d988d8075c23ca5fa2acd952b0e2fd5301dbb xagentteam/toolserver-node:0.2 "uvicorn main:app --host 0.0.0.0 --port 31942" 19 minutes ago Up 19 minutes (healthy) 31942/tcp friendly_darwin 3cf4eb9a46caf8bc774ad731a2dae9f6dffaf67ef6da85b5f8198a117f766dd0 xagentteam/xagent-server:latest "python start_server.py" 21 minutes ago Up 21 minutes 0.0.0.0:5173->5173/tcp, :::5173->5173/tcp, 0.0.0.0:8090->8090/tcp, :::8090->8090/tcp XAgent-Server ede01c59c67f61dbbe7e16bfcdb9c65df39dadc001abb9b31b83 xagentteam/toolserver-node:latest "uvicorn main:app --host 0.0.0.0 --port 31942" 21 minutes ago Up 21 minutes 31942/tcp xagent-main-ToolServerNode-1 8c5b52f2d082ed74603fa01bf75fbbbdd44301dc6e59dbda4f03b25347 xagentteam/toolserver-manager:latest "gunicorn main:app -b 0.0.0.0:8080 --worker-class uvicorn.workers.UvicornWorker --workers 2 -t 600" 21 minutes ago Up 21 minutes (healthy) 0.0.0.0:8080->8080/tcp, :::8080->8080/tcp xagent-main-ToolServerManager-1 0c19ca7b719eeb427c13f3b0ddc6eacbf059df07bae36553aefc66170e xagentteam/toolserver-node:0.2 "uvicorn main:app --host 0.0.0.0 --port 31942" 8 hours ago Up 8 hours (healthy) 31942/tcp nice_diffie 41f1b764cbdfce3fe7d2dfad75f90fdaca9e3abd660c8942b040268f4bcb1a34 xagentteam/toolserver-node:0.2 "uvicorn main:app --host 0.0.0.0 --port 31942" 11 hours ago Up 11 hours (healthy) 31942/tcp eager_greider 1a2bfe7c41fad33417aed3a46c9c24465fc934e5cf9228ede7 mysql "docker-entrypoint.sh --default-authentication-plugin=caching_sha2_password --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci" 11 hours ago Up 8 hours (healthy) 0.0.0.0:3306->3306/tcp, :::3306->3306/tcp, 33060/tcp xagent-main-xagent-mysql-1 379d82d0c10df5ef2933acffca390bbd5f79cc4abdd2149ee42ff435a redis "docker-entrypoint.sh redis-server --requirepass xagent" 11 hours ago Up 8 hours (healthy) 0.0.0.0:6379->6379/tcp, :::6379->6379/tcp xagent-main-xagent-redis-1 

如果顺利启动，则可以看到以下提示：

INFO: Register env WebEnv with 2 tools! xagent-100-ToolServerNode-1 | INFO: Register env PythonNotebook with 2 tools! xagent-100-ToolServerNode-1 | INFO: Register env FileSystemEnv with 3 tools! xagent-100-ToolServerNode-1 | INFO: Register tool shell_command_executor! xagent-100-ToolServerNode-1 | INFO: Loaded 8 tools and 3 envs! xagent-100-ToolServerNode-1 | INFO: Application startup complete. xagent-100-ToolServerNode-1 | INFO: Uvicorn running on http://0.0.0.0:31942 (Press CTRL+C to quit) xagent-100-xagent-mysql-1 | 2023-12-14T05:49:03.Z 8 [Warning] [MY-013360] [Server] Plugin mysql_native_password reported: ''mysql_native_password' is deprecated and will be removed in a future release. Please use caching_sha2_password instead' XAgent-Server | INFO: Will watch for changes in these directories: ['/app'] XAgent-Server | INFO: Uvicorn running on http://0.0.0.0:8090 (Press CTRL+C to quit) XAgent-Server | INFO: Started reloader process [1] using StatReload xagent-100-xagent-mysql-1 | 2023-12-14T05:49:06.Z 9 [Warning] [MY-013360] [Server] Plugin mysql_native_password reported: ''mysql_native_password' is deprecated and will be removed in a future release. Please use caching_sha2_password instead' XAgent-Server | INFO: Started server process [16] XAgent-Server | INFO: Waiting for application startup. XAgent-Server | INFO: Application startup complete. 

访问XAgent-Server

XAgent-Server启动后，默认的访问地址是 http://localhost:5173， 要确保端口是对外开放的，首次访问该地址，会看到上个步骤的控制台上会打印访问的日志信息：

 XAgent-Server | XAgent Service Startup Param: XAgent-Server | app: app:app XAgent-Server | prod: False XAgent-Server | base_dir: XAgentServer XAgent-Server | use_redis: False XAgent-Server | recorder_root_dir: running_records XAgent-Server | default_login: True XAgent-Server | check_running: False XAgent-Server | host: 0.0.0.0 XAgent-Server | port: 8090 XAgent-Server | debug: True XAgent-Server | reload: True XAgent-Server | workers: 1 XAgent-Server | share_url: https://x-agent.net/api/conv/community XAgent-Server | DB: <class 'XAgentServer.application.core.envs.XAgentServerEnv.DB'> XAgent-Server | Redis: <class 'XAgentServer.application.core.envs.XAgentServerEnv.Redis'> XAgent-Server | Email: <class 'XAgentServer.application.core.envs.XAgentServerEnv.Email'> XAgent-Server | Upload: <class 'XAgentServer.application.core.envs.XAgentServerEnv.Upload'> XAgent-Server | XAgent Service Init Dependence. XAgent-Server | init a thread pool executor, max_workers: 1 XAgent-Server | XAgent Service Init Dependence: Complete! XAgent-Server | Default user: Guest, token: xagent, you can use it to login XAgent-Server | XAgent Server Dependences: XAgent-Server | Python: 3.10+ XAgent-Server | FastAPI: Http server XAgent-Server | Websocket: long connect with client XAgent-Server | MySQL: save xagent data XAgent-Server | SqlAlchemy: ORM with MySQL XAgent-Server | Redis: save status of interaction XAgent-Server | Threading: run interaction XAgent-Server | APScheduler: send data to client and keep alive XAgent-Server | FastAPI APIRouter: manage websocket route XAgent-Server | XAgentError: XAgentServer.exts.exception_ext XAgent-Server | XAgent Server Version: XAgent-Server | V 1.1.0 XAgent-Server | Notes: XAgent-Server | Since V 1.1.0, XAgent-Server | Local storage will no longer be supported, replaced by Mysql. XAgent-Server | The service depends on Redis and Mysql, XAgent-Server | so you need to install Redis and Mysql before using it. XAgent-Server | Before you use this service, please ensure that the following services are available: XAgent-Server | 1. Redis on docker, port: 6379, you can start it by docker, default password: xagent XAgent-Server | 2. Mysql on docker, port: 3306, you can start it by docker XAgent-Server | 3. XAgent Tool Server is runnning on port 8080 XAgent-Server | 4. Port 8090 is not occupied 

部署及启动过程中的一些错误解决

错误列表

ToolServerNode—but the ‘h2’ package is not installed

我是使用的是XAgent-1.0.0版本，启动过程中xagentteam/toolserver-node:latest这个image的容器碰到以下错误：

ImportError: Using http2=True, but the 'h2' package is not installed. Make sure to install httpx using `pip install httpx[http2]`. xagent-100-ToolServerNode-1 | xagent-100-ToolServerNode-1 | ERROR: Application startup failed. Exiting. 

解决方法

# 到\XAgent-1.0.0\dockerfiles\ToolServerNode\目录下 # 修改Dockerfile文件 # 在RUN pip install playwright && playwright install chromium && playwright install-deps这段之后添加: RUN pip install httpx[http2] # 注意，添加上面这段脚本后，要重新运行docker compose build 和 docker compose up 

mysql启动后不停闪现的warning信息

后台服务启动后，如果不停闪现以下错误：

 [Warning] [MY-013360] [Server] Plugin mysql_native_password reported: ''mysql_native_password' is deprecated and will be removed in a future release. Please use caching_sha2_password instead' 

解决方法 请修改mysql的healthcheck段配置：

healthcheck: # test: [ "CMD", "mysqladmin","ping", "-h", "localhost" ] test: ["CMD-SHELL", "mysql -h localhost -u root -pxagent -e 'SELECT 1'"] #interval: 10s timeout: 20s retries: 20 

如果以上配置修改不能解决您的问题，尝试将你的Xagent代码切换到master版本，我在1.00版本碰到该问题，切换到master版本后运行，以上问题应该已经被修复

max_workers must be greater than 0 错误

暂无解决方案，如果你是1.00版本，建议使用master版本尝试该问题是否能修复，总而言之，master版本似乎要比1.00版本稳定不少。

 | File "/app/XAgent/function_handler.py", line 234, in handle_tool_call XAgent-Server | command_result = self.long_result_summary( XAgent-Server | File "/app/XAgent/function_handler.py", line 167, in long_result_summary XAgent-Server | with ThreadPoolExecutor(max_workers=len(result)) as pool: XAgent-Server | File "/usr/local/lib/python3.10/concurrent/futures/thread.py", line 144, in __init__ XAgent-Server | raise ValueError("max_workers must be greater than 0") XAgent-Server | ValueError: max_workers must be greater than 0 

AttributeError: ‘ToolServerInterface’ object has no attribute ‘cookies’

伴随以上错误，同时会有以下异常信息：

 XAgentServer.exts.exception_ext.XAgentRunningError: HTTPConnectionPool(host='localhost', port=8080): Max retries exceeded with url: /get_cookie 

解决方法 问题是由localhost的8080端口沟通失败引起的，尝试使用IP地址，请注意打开8080端口的访问权限