文档中心

AgentKit

快速入门

快速入门：1分钟快速部署智能体

本文以平台提供的 VeADK 公共 Agent 镜像为起点，通过控制台演示 Agent 从创建、部署到调用的端到端全流程，帮助您在最短路径内完成 AgentKit 的首次体验。

前提条件

请确认已完成账号注册和实名认证。

已开通 AgentKit 服务。若未开通，请登录 AgentKit控制台，根据系统引导开通产品。

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

已开通火山方舟模型服务。

步骤一：创建智能体运行时

在左侧导航树中，选择“基础组件 > 智能体运行时”。

单击“创建智能体”按钮，配置智能体运行时信息，未提及的参数则保持默认配置。

说明

更多参数介绍，请参见创建智能体运行时。

参数	说明
名称	自定义智能体运行时名称。例如，agentkit_runtime。
所属网关	选择智能体运行时所属的网关类型。本示例选择“共享模式”。专属网关（推荐）：智能体运行时运行在您独立创建的网关实例上，资源专属不共享，可提供稳定的容量保障，适用于对可靠性要求较高的生产环境。选择后，需指定关联的网关实例，如果没有可用网关实例，单击下拉框中“去创建”按钮创建，详细操作请参见创建网关实例。共享模式：智能体运行时运行在平台统一提供的共享网关资源上，无需创建网关实例。共享模式下存在 QPS 等限流限制，适用于功能验证（POC）或低流量测试场景，不建议用于生产环境。注意智能体运行时创建后，所属网关不可更换，请根据实际业务场景谨慎选择。
镜像	选择“公共镜像”下的“财务分析智能体”。
网络访问	配置访问智能体运行时的网络访问方式，公共镜像仅支持选择“公网访问”。
IAM角色	选择“新建角色”，平台将自动赋予访问火山其他云服务资源的权限。
入站身份认证	配置访问智能体运行时托管资源的身份验证方式（API Key 或 OAuth JWT）。本示例选择“API Key”。 API Key：平台自动创建并绑定，适合服务端调用、快速验证与调试。 OAuth JWT：基于 OAuth 申请访问令牌，适合更高安全性与统一身份体系场景；配置前需有用户池与客户端。使用控制台在线测试调试时，OAuth JWT 客户端需为 M2M 类型。
观测服务	选择“启用”观测服务。开启观测服务后，将会提供指标、链路、日志服务等一体化观测服务并绘制观测大盘。平台将会同时开通 APMPlus 和 TLS 服务，并授权 APMPlus 服务写入日志。
模型选择	使用默认模型“doubao-seed-1-8”。
API Key	选择调用智能体模型时使用的 API Key，作为模型调用的鉴权凭证。仅当所选模型为火山方舟模型时，才需要下拉选择 API Key。若所选模型为模型服务中的模型时，则无需手动配置，系统会自动显示为模型选择时对应的 Proxy API Key 名称。
所属项目	选择“default（默认项目）”。

单击“创建”按钮。

在弹出的对话框中，请您仔细阅读创建智能体会产生的费用信息，确认无误后，单击“我已知悉，确认创建”按钮，完成操作。

步骤二：调试Agent

发布成功后，在智能体运行时列表中，单击刚创建的智能体运行时操作列的“在线测试”按钮。

在Agent在线测试面板，面板将自动填充本智能体的域名，无需手动输入。在 Body 选项卡下选择 raw（JSON），输入测试参数（本示例保持默认配置），单击“调试”按钮发起 POST 请求。详细参数说明，请参见调用Agent。

查看调试结果，确认状态码为 200，并验证返回内容符合预期。

步骤三：观测与评测智能体

调试成功后，您可以进一步通过数据观测和评测能力，持续了解 Agent 的运行情况，并从效果、性能、成本三个维度评估表现，逐步完成从“是否稳定可用”进一步走向“是否足够好、是否值得上线”的持续优化过程。

观测智能体

Agent 在运行过程中通常会涉及模型调用、工具执行、记忆库或知识库检索等多个环节。开启数据观测后，AgentKit 与 VeADK SDK 会基于 OpenTelemetry 自动采集各环节的 Trace（调用链）与 Metrics（指标），并将数据投递至观测平台。

您可以在数据观测页面查看以下内容：运行时监控（如请求量、延迟、错误率）、Trace 分析（完整调用链）、会话分析、模型监控（如 Token 消耗）以及日志分析。观测数据也是后续开展评测的前提。详情请参见数据观测。

评测智能体

评测通过结构化方式持续量化 Agent 在效果、性能和成本三个维度的表现，为上线决策和优化迭代提供依据。

评测机制通常由三部分组成：评测集、评估器和实验。其中，评测集用于提供标准化输入与参考答案；评估器可以基于 LLM 或 Code 按既定规则打分；实验则负责组合执行、聚合结果指标，并支持多实验之间的对比分析。详情请参见评测。

后续操作

智能体上线后，您可在控制台按需更新观测、自定义镜像、实例规格、模型、环境变量及关联组件等配置；完成修改后，需重新发布使新版本生效。发布时支持全量发布与灰度发布，并可在版本管理 > 发布记录中查看进度、调整流量比例、取消发布或回退版本。详情请参见更新运行时。

最近更新时间：2026.10.12 14:41:27

这个页面对您有帮助吗？

有用

无用