本文展示了如何使用VeADK构建一个简单的智能体，用于调用MCP服务。 ## 前提条件 * 已安装Python，且版本不低于3.10。查看Python版本的命令示例：`python --version`。 * 已[开通AgentKit服务](https://console.volcengine.com/AgentKit)。 * 已[开通火山方舟模型服务](https://console.volcengine.com/ark/openManagement)，并[获取API Key](https://www.volcengine.com/docs/82379/1399008)。 * 登录平台控制台[获取AK/SK](https://www.volcengine.com/docs/6291/65568)，进入[API访问密钥](https://console.volcengine.com/iam/keymanage/)页面，创建并获取**Access Key ID**和**Secret Access Key。** * 已部署MCP后端服务。 ## 步骤一：配置本地环境可以使用`uv`或者`python3 -m venv`进行虚拟环境管理，本文将以`uv`为例进行介绍。 1. 虚拟环境配置。 ```Bash mkdir agentkit-mcp-quickstart cd agentkit-mcp-quickstart uv venv --python 3.12.0 source .venv/bin/active ``` 2. 安装依赖。 > 您也可以通过`--index`指定源，加快安装速度。 ```Bash uv pip install veadk-python uv pip install google-adk pip install agentkit-sdk-python ``` ## 步骤二：创建AgentKit MCP 1. 登录[AgentKit MCP服务控制台](https://console.volcengine.com/agentkit/region:agentkit+cn-beijing/gateway/mcpservice?pageSize=10¤tPage=1)，为前提条件中的MCP后端服务创建MCP服务。具体操作，请参见[创建MCP服务](https://www.volcengine.com/docs/86681/1844857?lang=zh#GsgcqzsJ)。 2. 获取MCP服务的Endpoint和ApiKey。具体操作，请参见[获取MCP服务调用示例](https://www.volcengine.com/docs/86681/1844857#JSLkeDYY)。 ## 步骤三：配置环境变量 ```Bash export MCP_ENDPOINT={{步骤二中获取的Endpoint}} export MCP_AUTH_KEY={{步骤二中获取的ApiKey}} export API_KEY={{方舟的APIKEY}} ``` ## 步骤四：运行Agent ### **代码示例** ```Python import logging from veadk import Agent, Runner from veadk.config import getenv from agentkit.apps import AgentkitSimpleApp from google.adk.tools.mcp_tool.mcp_toolset import MCPToolset, StreamableHTTPConnectionParams logger = logging.getLogger(__name__) url = getenv("MCP_ENDPOINT") mcp_auth_key = getenv("MCP_AUTH_KEY") apikey = getenv("API_KEY") mcp_ecs_toolset = MCPToolset( connection_params=StreamableHTTPConnectionParams( url=url, headers={"Authorization": f"Bearer {mcp_auth_key}"} ), ) app = AgentkitSimpleApp() root_agent = Agent( name="ecs_helper", model_name="doubao-1-5-pro-256k-250115", instruction=''' Help user find ECS instances and their details. ''', description="ECS Helper Agent", tools=[mcp_ecs_toolset] ) runner = Runner(agent=root_agent) @app.entrypoint async def run(payload: dict, headers: dict) -> str: prompt = payload["prompt"] user_id = headers["user_id"] session_id = headers["session_id"] logger.info( f"Running agent with prompt: {prompt}, user_id: {user_id}, session_id: {session_id}" ) # 运行智能体，自动处理工具调用 response = await runner.run( messages=prompt, user_id=user_id, session_id=session_id ) logger.info(f"Run response: {response}") return response @app.ping def ping() -> str: """健康检查接口""" return "pong!" if __name__ == "__main__": # 启动本地开发服务器 app.run(host="0.0.0.0", port=8000 ``` ### 执行请求 ```Python curl --location 'http://localhost:8000/invoke' \ --header 'Content-Type: application/json' \ --header 'user_id: veadk-test' \ --header 'session_id: local_session' \ --data '{"prompt": "分析下我的ecs实例"}' ``` ### 运行结果 ```Plain Text 2025-10-24 20:17:33 | INFO | ark_veauth.py:25 - Fetching ARK token... 2025-10-24 20:17:33 | INFO | agent.py:118 - Model extra config: {'extra_headers': {'x-is-encrypted': 'true', 'veadk-source': 'veadk', 'veadk-version': '0.2.13', 'User-Agent': 'VeADK/0.2.13', 'X-Client-Request-Id': 'veadk/0.2.13'}, 'extra_body': {'caching': {'type': 'enabled'}, 'expire_at': 1761311852}} 2025-10-24 20:17:33 | DEBUG | agent.py:127 - LiteLLM client created with config: {'extra_headers': {'x-is-encrypted': 'true', 'veadk-source': 'veadk', 'veadk-version': '0.2.13', 'User-Agent': 'VeADK/0.2.13', 'X-Client-Request-Id': 'veadk/0.2.13'}, 'extra_body': {'caching': {'type': 'enabled'}, 'expire_at': 1761311852}} 2025-10-24 20:17:33 | INFO | agent.py:153 - VeADK version: 0.2.13 2025-10-24 20:17:33 | INFO | agent.py:155 - Agent `ecs_helper` init done. 2025-10-24 20:17:33 | DEBUG | agent.py:156 - Agent: {'name': 'ecs_helper', 'tools': [], 'model_name': 'doubao-1-5-pro-256k-250115', 'model_api_base': 'https://ark.cn-beijing.volces.com/api/v3/'} 2025-10-24 20:17:33 | WARNING | runner.py:198 - No short term memory or session service provided, use an in-memory one instead. 2025-10-24 20:17:33 | INFO | runner.py:217 - No long term memory provided. INFO: Started server process [1330124] INFO: Waiting for application startup. INFO: Application startup complete. INFO: Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit) 2025-10-24 20:18:35 | INFO | runner.py:250 - Run config: speech_config=None response_modalities=None save_input_blobs_as_artifacts=False support_cfc=False streaming_mode= output_audio_transcription=AudioTranscriptionConfig() input_audio_transcription=AudioTranscriptionConfig() realtime_input_config=None enable_affective_dialog=None proactivity=None session_resumption=None context_window_compression=None save_live_audio=False max_llm_calls=100 2025-10-24 20:18:35 | DEBUG | runner.py:265 - Auto create session: local_session, user_id: veadk-test, app_name: veadk_default_app 2025-10-24 20:18:38 | DEBUG | runner.py:280 - Function call: id='call_xbyfcvc86wc26mbxz39v****' args={'region': 'cn-beijing', 'needNum': 10} name='describe_instances' 2025-10-24 20:19:14 | DEBUG | runner.py:288 - Event output: 以下是您的ECS实例详情： 1. **实例1**： - **实例ID**：i-ye7irm2sqobw80cq**** - **创建时间**：2025-10-23T21:36:31+08:00 - **计费方式**：PostPaid（按量计费） - **实例规格**：ecs.e-c1m2.xlarge - **CPU**：4核（核心数2，每核心线程数2） - **内存**：8192MB - **操作系统**：Windows Server 2022 Datacenter Edition 64 - bit Chinese - **镜像ID**：image-ye5907jc6ikhx1ex**** - **状态**：RUNNING（运行中） - **所属可用区**：cn - beijing - a 2. **实例2**： - **实例ID**：i-ye7ipm0dtsqc6imh**** - **创建时间**：2025-10-23T21:05:44+08:00 - **计费方式**：PostPaid（按量计费） - **实例规格**：ecs.e-c1m2.xlarge - **CPU**：4核（核心数2，每核心线程数2） - **内存**：8192MB - **操作系统**：Debian 12 64 bit - **镜像ID**：image-ydzwsvy72n46nmxz**** - **状态**：RUNNING（运行中） - **所属可用区**：cn - beijing - a 3. **实例3**： - **实例ID**：i-ye7ilsbbpcbw80ca**** - **创建时间**：2025-10-23T20:06:54+08:00 - **计费方式**：PostPaid（按量计费） - **实例规格**：ecs.e-c1m2.xlarge - **CPU**：4核（核心数2，每核心线程数2） - **内存**：8192MB - **操作系统**：Windows Server 2022 Datacenter Edition 64 - bit Chinese - **镜像ID**：image-ye5907jc6ikhx1ex**** - **状态**：RUNNING（运行中） - **所属可用区**：cn - beijing - a 4. **实例4**： - **实例ID**：i-ye7fg1hgqoxjd1ut**** - **创建时间**：2025-10-22T14:57:49+08:00 - **计费方式**：PostPaid（按量计费） - **实例规格**：ecs.e-c1m2.xlarge - **CPU**：4核（核心数2，每核心线程数2） - **内存**：8192MB - **操作系统**：Windows Server 2022 Datacenter Edition 64 - bit Chinese - **镜像ID**：image-ye5907jc6ikhx1ex**** - **状态**：RUNNING（运行中） - **所属可用区**：cn - beijing - a 5. **实例5**： - **实例ID**：i-ye5ejwoow0cva4fq**** - **创建时间**：2025-09-24T14:25:37+08:00 - **计费方式**：PostPaid（按量计费） - **实例规格**：ecs.e-c1m2.xlarge - **CPU**：4核（核心数2，每核心线程数2） - **内存**：8192MB - **操作系统**：Windows Server 2022 Datacenter Edition 64 - bit Chinese - **镜像ID**：image-ye5907jc6ikhx1ex**** - **状态**：RUNNING（运行中） - **所属可用区**：cn - beijing - a 6. **实例6**： - **实例ID**：i-ye5ejub08wbw80bp**** - **创建时间**：2025-09-24T14:24:35+08:00 - **计费方式**：PostPaid（按量计费） - **实例规格**：ecs.e-c1m2.xlarge - **CPU**：4核（核心数2，每核心线程数2） - **内存**：8192MB - **操作系统**：Windows Server 2022 Datacenter Edition 64 - bit Chinese - **镜像ID**：image-ye5907jc6ikhx1ex**** - **状态**：RUNNING（运行中） - **所属可用区**：cn - beijing - a 7. **实例7**： - **实例ID**：i-ye5e5jyq68bw80c8**** - **创建时间**：2025-09-24T10:44:54+08:00 - **计费方式**：PostPaid（按量计费） - **实例规格**：ecs.e-c1m2.xlarge - **CPU**：4核（核心数2，每核心线程数2） - **内存**：8192MB - **操作系统**：Windows Server 2022 Datacenter Edition 64 - bit Chinese - **镜像ID**：image-ye5907jc6ikhx1ex**** - **状态**：RUNNING（运行中） - **所属可用区**：cn - beijing - a 8. **实例8**： - **实例ID**：i-ye5c4jbx8gqc6ily**** - **创建时间**：2025-09-23T16:02:05+08:00 - **计费方式**：PostPaid（按量计费） - **实例规格**：ecs.e-c1m2.xlarge - **CPU**：4核（核心数2，每核心线程数2） - **内存**：8192MB - **操作系统**：Windows Server 2022 Datacenter Edition 64 - bit Chinese - **镜像ID**：image-ye5907jc6ikhx1ex**** - **状态**：RUNNING（运行中） - **所属可用区**：cn - beijing - a 9. **实例9**： - **实例ID**：i-ye5c4end34xjd1um**** - **创建时间**：2025-09-23T16:00:05+08:00 - **计费方式**：PostPaid（按量计费） - **实例规格**：ecs.e-c1m2.xlarge - **CPU**：4核（核心数2，每核心线程数2） - **内存**：8192MB - **操作系统**：Debian 12 64 bit - **镜像ID**：image-ydzwsvfxhokhx11p**** - **状态**：RUNNING（运行中） - **所属可用区**：cn - beijing - a 10. **实例10**： - **实例ID**：i-ye5blj0xdsxjd1tk**** - **创建时间**：2025-09-23T11:09:46+08:00 - **计费方式**：PostPaid（按量计费） - **实例规格**：ecs.e-c1m2.xlarge - **CPU**：4核（核心数2，每核心线程数2） - **内存**：8192MB - **操作系统**：Debian 12 64 bit - **镜像ID**：image-ydzwsvfxhokhx11p**** - **状态**：RUNNING（运行中） - **所属可用区**：cn - beijing - a 以上10个实例均为按量计费，规格为ecs.e-c1m2.xlarge ，且大部分使用Windows Server 2022 Datacenter Edition 64 - bit Chinese操作系统，少数使用Debian 12 64 bit操作系统，目前状态均为运行中，所属可用区为cn - beijing - a 。若您还需要进一步分析或有其他操作需求，可继续向我提问。 ```