本文为您介绍如何创建智能体运行时（Runtime），定义智能体的部署方式、访问模式、权限与访问控制等。 ## 前提条件使用 AgentKit 前，请先完成**核心基础服务**开通。其他服务可根据模型调用、部署方式、网络访问、监控和安全需求按需开通。 |分类 |说明 | |---|---| |核心基础服务 |* 已开通 AgentKit 服务。若未开通，请登录 [AgentKit 控制台](https://console.volcengine.com/AgentKit)，根据系统引导开通产品。

> 首次登录 AgentKit 服务控制台，平台将默认勾选使用 AgentKit 基础功能的必备依赖产品（包含函数服务、API 网关、镜像仓库、持续交付等），您也可以根据实际业务需求，勾选所需的其他产品，然后单击“批量开通并授权”按钮确认“AgentKit 依赖服务开通及跨服务授权”，允许 AgentKit 服务使用已选择的产品。

> ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_87c284ee59c1af4cf749d2f322d4400e.jpg) | |场景扩展服务 |* 如需使用自定义 Agent，请确认已上传 Agent 镜像到镜像仓库（CR）中。详细操作，请参见[基于Docker推送和拉取镜像](https://www.volcengine.com/docs/6420/68645)。

> AgentKit 还支持使用 AgentKit CLI 或 VeADK等方式将 Agent 代码部署到运行时。更多场景，请参见[运行时构建方式](https://docs.volcengine.com/docs/86681/1844854?lang=zh#V79WwTr9)。

* 如需使用火山引擎方舟模型服务提供的预置模型，请确认已[开通火山方舟模型服务](https://console.volcengine.com/ark/openManagement)。

* 如需通过私有网络 VPC 访问智能体运行时，请确保已开通火山引擎私有网络，并已在智能体运行时待部署地域创建私有网络、子网。详细操作请参见[创建私有网络](https://www.volcengine.com/docs/6401/69467)、[创建子网](https://www.volcengine.com/docs/6401/67823)。

* 如需观测运行时的运行时监控、运行时日志等，请确认已[开通全栈可观测平台](https://console.volcengine.com/observe/apmplus-server/region:apmplus-server+cn-beijing/console/overview/server?projectName=default)。

* 如需使用 AgentKit 模型服务中的模型，请先前往模型服务控制台[创建模型服务](https://docs.volcengine.com/docs/agentkit/Creating_model_service)。

* 如需使用安全围栏服务防护 Agent 输入输出全链路的安全，请确认已[开通大模型应用防火墙服务](https://console.volcengine.com/omni-shield/llm-shield)。 | ## 操作步骤 1. 登录 [AgentKit 控制台](https://console.volcengine.com/agentkit)。 2. 在左侧导航树中，选择“智能体运行时”。 3. 单击“创建智能体”按钮，在创建页面参照下表完成参数配置。 * **基础配置** |参数 |说明 |示例 | |---|---|---| |名称 |自定义智能体运行时名称。同一账号下智能体运行时名称不可重复，创建后不支持修改。 |agentkit_runtime | |所属网关 |选择智能体运行时所属的网关类型。

* **专属网关**（推荐）：智能体运行时运行在您独立创建的网关实例上，资源专属不共享，可提供稳定的容量保障，适用于对可靠性要求较高的生产环境。选择后，需指定关联的网关实例，如果没有可用网关实例，单击下拉框中“去创建”按钮创建，详细操作请参见[创建网关实例](https://docs.volcengine.com/docs/86681/2650647)。

* **共享模式**：智能体运行时运行在平台统一提供的共享网关资源上，无需创建网关实例。共享模式下存在 QPS 等限流限制，适用于功能验证（POC）或低流量测试场景，不建议用于生产环境。

注意

智能体运行时创建后，所属网关不可更换，请根据实际业务场景谨慎选择。

|共享模式 | |镜像 |支持自定义镜像和公共镜像。

* **自定义镜像**：

* **从镜像仓库选择：** 下拉选择当前账号下镜像仓库（CR）中的镜像。

* **输入火山镜像地址**：填写当前账号下镜像仓库的镜像地址，或其他账号下的镜像地址。

注意

使用其他账号镜像时，需确保该镜像所在实例已开启公网访问，否则可能导致拉取失败，无法创建运行时。

* **公共镜像**：AgentKit 平台预置的开箱即用的镜像。当前仅支持**财务分析智能体**。 |公共镜像：财务分析智能体 | |最小实例数 |配置承载 Agent 运行的计算资源最小实例数。设置后，无论是否存在请求负载，平台均会持续保留该数量的实例并按此计费。

* 取值：0～最大实例数。

* 默认值为 2。

> 设置为2，可有效减少实例冷启动（即实例从无资源分配状态下，从零加载运行环境、初始化依赖组件，直至完成全量初始化并被触发启动的全过程）耗时。 |1 | |最大实例数 |智能体运行时实例配额上限。

* 取值：1～100。如需提升最大实例数上限，请前往[配额中心](https://console.volcengine.com/quota/productList/ParameterList?ProviderCode=agentkit)申请提升 runtime / instances 配额上限。

* 默认值为100。 |10 | |预览模式 |默认开启，用于把调试中的版本和对外服务的版本隔离开，避免调试内容直接影响线上。开启后，不支持关闭。

* **开启（默认）** ：版本分为 Latest 版本和正式版本两类。

* **Latest 版本**：支持修改运行时配置、发起调试和评测。

* **正式版本（只读）** ：仅支持查看和评测，不能修改；如需变更，需在 Latest 版本上修改后重新发布。

* **关闭**：不再区分 Latest 与正式版本，所有修改直接作用于当前对外服务的版本，改动发布后会立刻生效。 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0a95c4c407b681dd632c7227d66da198.png) | * **网络配置** |参数 |说明 |示例 | |---|---|---| |网络访问 |配置访问智能体运行时的网络访问方式。支持同时开启公网访问和私网访问。

* **公网访问**：默认访问方式。如需使用[在线测试](https://www.volcengine.com/docs/86681/2122004)功能调试 Agent ，则需开启公网访问。

* **私网访问**：选择同地域中的任意一个 VPC 和子网，每个可用区支持最多选择一个子网。

说明

当所属网关为专属网关时，私网出口将使用该专属网关配置的入站 VPC。

|\-\- | |共享公网访问 |运行时公网出口配置。仅当**网络访问**选择**私网访问**时，支持开启共享公网端口。

* **开启**：运行时将使用平台提供的公网出口访问公网。

* **未开启**：将默认使用您私有网络中已配置的公网出口（例如，使用[公网IP](https://www.volcengine.com/docs/6396/67792)或[NAT网关](https://www.volcengine.com/docs/6499/155862)等公网产品）访问公网。 |\-\- | * **权限与访问控制** |参数 |说明 |示例 | |---|---|---| |IAM角色 |配置智能体运行时访问火山其他云服务资源的权限。

* **新建角色**：可自定义一个角色名称，创建成功后，系统自动配置相关权限。您可在[访问控制-角色管理](https://console.volcengine.com/iam/identitymanage/role)中查看角色权限，不支持修改角色。

* **选择已有**：选择已创建的角色。您可单击“查看角色”，查看角色权限详情。

说明

如果您无法选中已有角色，可能是该角色缺少相关信任关系，请根据页面提示添加所需信任关系。

确认所需的信息关系，单击对应角色的“查看角色”按钮。

在角色详情页面信任关系页签下，单击“编辑信任策略”按钮。

在Service下添加缺失的信任关系，添加完成后单击“保存”按钮保存配置。

|\-\- | |入站身份认证 |配置智能体运行时托管资源认证信息，用来控制谁可以访问此智能体运行时托管资源。

* **API Key**：输入名称后，将自动为智能体运行时创建和绑定 API Key，智能体运行时创建成功后，可在智能体运行时详情页查看。

* **OAuth JWT**：使用 OAuth 授权模式完成访问令牌申请和 API 调用，提升安全性，同时简化配置。配置前，请确认已[创建用户池](https://www.volcengine.com/docs/86681/1873447#zL1cxFcx)和[客户端](https://www.volcengine.com/docs/86681/1873447#zL1cxFcx)。

说明

OAuth JWT 入站身份认证的 Agent，如需使用在线测试功能进行调试，则客户端必须选择为 M2M 类型的客户端。

API Key 与 OAuth JWT 为互斥的认证方式，仅可启用其中一种。

API Key 模式仅支持配置 1 个，OAuth JWT 模式最多可绑定 5 个客户端。

|apikey\-ls0e2sw8 | * **高级配置** |参数 |说明 |示例 | |---|---|---| |观测服务 |开启观测服务后，将会提供指标、链路、日志服务等一体化观测服务并绘制观测大盘。平台将会同时开通 APMPlus 和 TLS 服务，并授权 APMPlus 服务写入日志。如果您计划使用在线评测，必须开启该服务。

* APMPlus 服务产生的费用请参见[监控计费说明](https://www.volcengine.com/docs/6431/69089)。

* TLS 服务产生的费用请参见[日志计费说明](https://www.volcengine.com/docs/6470/1215813)。 |启用 | |安全围栏服务 |启用安全围栏服务后，将会提供提示词攻击防护、模型滥用防护、敏感数据防护、算力消耗防护等防护策略。

> * 安全围栏服务产生的费用请参见[大模型防火墙计费说明](https://www.volcengine.com/docs/84990/1510769)。

> * 如需要更多防护策略，可前往[大模型防火墙资产管理](https://console.volcengine.com/omni-shield/llm-shield/region:llm-shield+cn-beijing/asset)进行自定义配置后进行切换。

* 自动创建：如果是首次绑定，可选择自动创建，并输入名称，系统将自动为智能体运行时创建和绑定安全围栏服务。

* 选择已有：选择已创建的安全围栏服务。

说明

单个地域最多可创建 100 个安全围栏服务资产。

启用后，还需要在 Agent 中集成安全围栏服务，否则防护策略不生效。

|启用 | |注册到 A2A 空间 |下拉选择 Agent 接入的 A2A 空间，接入后，平台将自动完成 Agent 在 A2A 空间的注册、身份标识及网络适配。

注册地址将根据网络访问方式自动选择。开启私网访问时使用私网地址完成注册，若未开启私网访问，则默认使用公网地址完成注册。

> * 如果还未创建 A2A 空间，请前往 [A2A 中心控制台](https://console.volcengine.com/agentkit/a2acenter) 创建。详情请参见 [创建 A2A 智能体空间](https://www.volcengine.com/docs/86681/2229303)。

> * Agent to Agent（A2A）是 Google 推出的开放协议，旨在实现不同框架与供应商的 AI Agent 之间的互联互通与协作。**AgentKit A2A 中心**面向已按照 A2A 协议对外提供能力的智能体服务，提供统一接入、按空间组织和管理、检索与发现以及治理能力，帮助用户集中管理分散在不同业务、团队或系统中的智能体服务。同时，A2A 中心基于底层网关提供标准 A2A 协议的同步和异步通信能力，支持平台内外的智能体协作。更多信息，请参见 [A2A 中心概述](https://www.volcengine.com/docs/86681/2229299)。 |\-\- | |模型选择 |选择 Agent 运行时调用的大语言模型。不同模型在**响应速度、推理能力和调用成本**上可能存在差异。请根据是否需要统一管理调用凭证，选择 **模型服务** 或 **火山方舟**。

* **模型来源**

* **模型服务**：使用已在 AgentKit 中创建的模型服务，在**模型服务**页签，选择对应的 Proxy API Key 名称，再选择所需模型。若暂无可选项，可前往[模型服务控制台](https://console.volcengine.com/agentkit/region:agentkit+cn-beijing/gateway/modelgateway)创建，详情请参见[创建模型服务](https://docs.volcengine.com/docs/agentkit/Creating_model_service)。

* **火山方舟**：使用火山方舟中的模型，请求不经过 AgentKit 网关。选择后可直接从模型列表中选择目标模型。

* **如何选择**

* 如果您希望通过 AgentKit 统一管理模型调用和访问凭证，选择**模型服务**。

* 如果您已经有火山方舟模型和 API Key，并希望直接调用模型，选择 **火山方舟。**

* **费用说明**

* 使用模型服务的模型时，将收取与其关联的网关实例费用，详情请参见[计费说明](https://docs.volcengine.com/docs/86681/2480915)。模型调用产生的相关费用由实际模型提供商收取。

* 使用火山方舟的模型时，由火山方舟模型服务收取 Token 费用，灵活按需使用，详情请参见[模型计费](https://www.volcengine.com/docs/82379/1544681)。 |\-\- | |API Key |选择调用智能体模型时使用的 API Key，作为模型调用的鉴权凭证。仅当所选模型为**火山方舟**模型时，才需要下拉选择 API Key。若所选模型为模型服务中的模型时，则无需手动配置，系统会自动显示为模型选择时对应的 Proxy API Key 名称。 |api\-key\-yei834\*\*\*\* | |关联组件 |当**镜像**选择为**自定义镜像**时，可配置以下参数。

说明

关联组件的网络访问方式需与智能体运行时网络访问方式一致。否则，无法进行关联。

* **知识库**：[在Agent代码中集成知识库](https://www.volcengine.com/docs/86681/1883770)后，可以在此处为智能体运行时关联知识库，关联后将自动配置所需的环境变量。

* **记忆库**：[在Agent代码中集成记忆库](https://www.volcengine.com/docs/86681/1883791)后，可以在此处为智能体运行时关联记忆库，关联后将自动配置所需的环境变量。

* **会话资源**：[在Agent中集成会话资源](https://www.volcengine.com/docs/86681/2175472)后，可以在此处为智能体运行时关联会话资源，关联后将自动配置所需的环境变量。

* **沙箱工具**：[在Agent代码中集成沙箱工具](https://www.volcengine.com/docs/86681/1848579)后，可以在此处为智能体运行时关联沙箱工具，关联后将自动配置所需的环境变量。

* **MCP工具集**：[在Agent代码中集成MCP工具集](https://www.volcengine.com/docs/86681/1892983)后，可以在此处为智能体运行时关联MCP工具集，关联后将自动配置所需的环境变量。 |\-\- | |实例规格 |配置承载 Agent 运行的计算资源的实例规格。创建成功后，平台会按此规格计费，详见[计费说明](https://docs.volcengine.com/docs/86681/2480915)。

* vCPU：0.5 ～16 核。

* 内存：1 ～ 128 GiB。

说明

配置实例规格时，vCPU 和内存需满足以下比值要求：

vCPU 值为整数时，比值为1:2、1:4、1:8。

vCPU 值为非整数时，比值为 1:2、1:4。

|\-\- | |单实例请求并发数 |单个实例支持的并发请求上限。实例个数将根据该设置与计算负载自动扩缩容。

* 默认为10。

* 取值：10～1000。 |10 | |环境变量 |自定义配置的环境变量，在智能体运行时代码运行时可以直接读取。实现代码和配置的分离，增强代码的可移植能力。

支持如下两种环境变量配置方法：

* **使用表单编辑**：通过键值对方式，配置环境变量。

单击**添加环境变量**，根据控制台界面提示的变量输入要求，设置**键**和**值**。

* **使用JSON格式编辑**：通过JSON文件方式配置环境变量。

JSON文件需满足如下格式：

```Bash```
```{```
``` "envKey1": "envValue1",```
``` "envKey2": "envValue2"```
```}```

|\-\- | |所属项目 |项目是一组资源的集合，您可以将本次创建的智能体运行时添加至项目中并按项目维度统一管理，有利于保持资源独立，维护数据安全。有关项目的更多信息请参见[项目管理](https://www.volcengine.com/docs/86681/2075078)。

* 默认为default，一个资源只能归属于一个项目。

* 选定项目后，创建的智能体运行时只能被具有该项目权限的用户使用。创建智能体运行时后，您可以按需[更改实例所属项目](https://www.volcengine.com/docs/6649/94336)。

* 进入创建页面时，如果您已在顶部导航栏选择了具体项目，则新创建的智能体运行时只能绑定该项目；若要绑定其他项目，请将顶部导航栏的项目更改为“账号全部资源”或目标项目。

* 若无可用项目，您可单击“新建项目”按钮进行创建，创建完成后，返回本页面即可选择新添加的项目。 |default | |标签 |标签由一个键\-值对（Key\-Value）组成，用于标识云资源，可以从不同维度（例如用途、所有者或环境等）对云资源进行分类，便于搜索和聚合。

单击“+ 添加标签” 按钮，选择已有标签或输入新的标签，为智能体运行时绑定标签。更多信息，请参见[标签管理](https://www.volcengine.com/docs/86681/2075077)。

说明

单次操作最多可绑定20个标签，单个资源最多可绑定50个标签。

|Key1:Value1 | 4. 单击“创建”按钮，在弹出的对话框中，确认已了解相关云产品及其计费方式后，单击“我已知悉，确认创建”按钮，完成智能体创建。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_95514aff1fba78e8c2d60142b0ef5c0e.png) 5. （可选）若已**开启预览模式**，智能体创建成功后，还需进入详情页，将 ** Latest 版本**发布为**正式版本**。您也可以先完成**在线调试**，确认效果符合预期后再发布。发布成功后，相关配置才会对外生效。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4030425708f3680c4f232ed5b586b48d.png) ## 后续操作 ### 调试Agent 支持通过控制台或通过`curl`命令验证Agent是否正常工作。详情请参见[调用Agent](https://www.volcengine.com/docs/86681/2122004)。 ### 观测Agent Agent 在运行过程中通常会涉及模型调用、工具执行、记忆库或知识库检索等多个环节。开启数据观测后，AgentKit 与 VeADK SDK 会基于 OpenTelemetry 自动采集各环节的 Trace（调用链）与 Metrics（指标），并将数据投递至观测平台。您可以在 **数据观测** 页面查看以下内容：运行时监控（如请求量、延迟、错误率）、Trace 分析（完整调用链）、会话分析、模型监控（如 Token 消耗）以及日志分析。观测数据也是后续开展评测的前提。详情请参见[数据观测](https://www.volcengine.com/docs/86681/1873528)。 ### 评测Agent 评测通过结构化方式持续量化 Agent 在效果、性能和成本三个维度的表现，为上线决策和优化迭代提供依据。评测机制通常由三部分组成：评测集、评估器和实验。其中，评测集用于提供标准化输入与参考答案；评估器可以基于 LLM 或 Code 按既定规则打分；实验则负责组合执行、聚合结果指标，并支持多实验之间的对比分析。详情请参见[评测](https://www.volcengine.com/docs/86681/1873446)。 ## 相关文档智能体运行时创建成功后，您可以根据业务需要，为 Agent 集成以下能力： * [集成沙箱模板](https://www.volcengine.com/docs/86681/1848579)：为 Agent 提供隔离的代码运行环境，用于执行代码、操作浏览器等任务。 * [集成会话资源](https://www.volcengine.com/docs/86681/2175472)：为 Agent 提供短期记忆能力，支持维护会话连接和管理上下文。 * [集成记忆库](https://www.volcengine.com/docs/86681/1883791)：为 Agent 提供长期记忆能力，支持跨会话获取上下文、开展个性化交互，并持续学习。 * [集成知识库](https://www.volcengine.com/docs/86681/1883770)：支持 Agent 通过 API 调用知识库，实现低成本、可维护、可更新且可追溯的知识检索。 * [集成 MCP 服务](https://www.volcengine.com/docs/86681/1892983)： Agent 无需修改代码即可调用 MCP 服务，扩展与大模型及存量系统的交互能力。 * [集成技能空间](https://www.volcengine.com/docs/86681/2172382)：将技能注入技能空间并集成至 Agent，使 Agent 能够快速扩展特定能力，适配不同业务场景。集成后，您需将所有依赖都正确配置在`requirements.txt`中并将 Agent 打包上传至镜像仓库，然后[更新智能体运行时镜像版本](https://www.volcengine.com/docs/86681/2204798)，重新发布。如果您通过 AgentKit CLI、VeADK、存量 Agent 迁移或 TRAE 构建智能体运行时，需要在本地工程中更新代码、配置和依赖，然后按照对应方式重新构建并发布运行时。更多信息，请参见[进阶入门：开发并部署 Agent](https://docs.volcengine.com/docs/86681/2609487)、[进阶入门：存量 Agent 迁移](https://docs.volcengine.com/docs/86681/2606796)、[自然语言驱动：使用 TRAE 开发并部署 Agent](https://docs.volcengine.com/docs/86681/2627844)。