AgentKit 实战｜搭建一个有记忆、懂业务、会执行的智能客服

当前，很多企业已具备快速构建 Agent Demo 的能力，但真正的挑战在于，如何让 Agent 真正进入生产环境，稳定服务真实用户。

从 Demo 到生产环境，需要解决记忆持久化、知识索引与版本管理、工具调用的权限与容错，以及运行状态的监控和问题追溯。而作为火山引擎推出的企业级 AI Agent 基础设施平台，AgentKit 提供 Agent 开发、运行与治理的端到端能力，通过安全隔离的 Sandbox、统一身份与权限、运行治理及企业系统集成，让 Agent 在安全、可控、可观测的环境中持续运行，并真正融入企业业务流程。

下面以智能售后客服为例，基于 AgentKit 接入 VikingDB、Mem0 和 CRM，构建具备知识检索、长期记忆与业务系统操作能力的 Agent，并将其部署至云端 Runtime。

原理解读

智能售后客服 = 大脑 (AgentKit 引擎) + 知识 (知识库) + 记忆 (Memory) + 接口 (CRM 工具集成)

大脑： 基于火山引擎大模型，理解用户意图，进行逻辑判断，并为Agent提供运行环境。
知识： 存储在 Viking 向量数据库中的产品手册和维修政策，为回答提供业务依据。
记忆： 记录用户的对话历史和个人信息，保证服务连贯性。
接口： 通过 API 连接 CRM 系统，执行查订单、开工单等实际操作。

前期准备

1. 本地环境要求：

本地操作系统要求：

建议使用 MacOS/Linux 操作系统。
Windows 用户建议使用 wsl 完成当前实验。

本地 Python 版本：

需要 Python 3.12 或更高版本。

2. 在火山引擎控制台准备好以下资源：

AK/SK： 前往 API 访问密钥 (mic.anruicloud.com/url/2026090...%25C2%25A0%25E9%25A1%25B5%25E9%259D%25A2%25EF%25BC%258C%2522%25E5%2588%259B%25E5%25BB%25BA "https://mic.anruicloud.com/url/20260904keymanage)%C2%A0%E9%A1%B5%E9%9D%A2%EF%BC%8C%22%E5%88%9B%E5%BB%BA") Access Key"，并申请以下权限 AgentKitFullAccess、CRFullAccess、VikingdbFullAccess、Mem0FullAccess、VPCFullAccess、ArkFullAccess、AIDAPFullAccess。
私有网络： 在 VPC 控制台 (mic.anruicloud.com/url/2026090...%25C2%25A0%25E5%2588%259B%25E5%25BB%25BA%25E7%25A7%2581%25E6%259C%2589%25E7%25BD%2591%25E7%25BB%259C%25E5%2592%258C%25E5%25AD%2590%25E7%25BD%2591%25EF%25BC%258C%25E8%25AE%25B0%25E5%25BD%2595 "https://mic.anruicloud.com/url/20260904vpc)%C2%A0%E5%88%9B%E5%BB%BA%E7%A7%81%E6%9C%89%E7%BD%91%E7%BB%9C%E5%92%8C%E5%AD%90%E7%BD%91%EF%BC%8C%E8%AE%B0%E5%BD%95") VPC ID 与子网 ID
开通模型： 在火山方舟-开通管理 (mic.anruicloud.com/url/2026090...%25C2%25A0%25E5%25BC%2580%25E9%2580%259A%25E8%25AF%25AD%25E8%25A8%2580%25E6%25A8%25A1%25E5%259E%258B%25EF%25BC%258C%25E5%25BC%2580%25E9%2580%259A "https://mic.anruicloud.com/url/20260904openmanagement)%C2%A0%E5%BC%80%E9%80%9A%E8%AF%AD%E8%A8%80%E6%A8%A1%E5%9E%8B%EF%BC%8C%E5%BC%80%E9%80%9A") doubao-seed-evolving
TOS Bucket： 在对象存储 TOS (mic.anruicloud.com/url/2026090...%25C2%25A0%25E5%2587%2586%25E5%25A4%2587%25E4%25B8%2580%25E4%25B8%25AA%25E5%25AF%25B9%25E8%25B1%25A1%25E5%25AD%2598%25E5%2582%25A8%25E6%25A1%25B6%25EF%25BC%258C%25E7%2594%25A8%25E4%25BA%258E%25E5%25AD%2598%25E6%2594%25BE%25E6%259E%2584%25E5%25BB%25BA%25E4%25BA%25A7%25E7%2589%25A9%25E5%2592%258C%25E7%259F%25A5%25E8%25AF%2586%25E5%25BA%2593%25E6%2596%2587%25E6%25A1%25A3%25E3%2580%2582%25E6%25A1%25B6%25E5%2590%258D%25E8%25A7%2584%25E5%2588%2599%25E4%25B8%25BA%25C2%25A0%2560agentkit-platform- "https://mic.anruicloud.com/url/20260904tos)%C2%A0%E5%87%86%E5%A4%87%E4%B8%80%E4%B8%AA%E5%AF%B9%E8%B1%A1%E5%AD%98%E5%82%A8%E6%A1%B6%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%AD%98%E6%94%BE%E6%9E%84%E5%BB%BA%E4%BA%A7%E7%89%A9%E5%92%8C%E7%9F%A5%E8%AF%86%E5%BA%93%E6%96%87%E6%A1%A3%E3%80%82%E6%A1%B6%E5%90%8D%E8%A7%84%E5%88%99%E4%B8%BA%C2%A0%60agentkit-platform-")<你的火山引擎账号ID>，地域 cn-beijing`。

3. 获取智能售后客服代码

本次实验所需要的代码位于 Agentkit 官方的示例代码仓库中。

agentkit-samples：github.com/bytedance/a...

Clone 或下载项目代码，在下面的路径中找到智能售后客服的代码：python/02-use-cases/customer_support

在代码目录下开启一个终端，后续的命令行交互过程都在 customer_support 目录下进行。

4. 安装 Agentkit 二进制命令

在本地终端安装 agentkit 二进制命令，后续与 Agentkit 平台上各类资源的互动（创建、删除）都借助这个命令实现。

bash 复制代码

# 安装命令
wget -qO- https://agentkit-cli.tos-cn-beijing.volces.com/install.sh | sh
# 验证
ak --version
# 预期返回 agenkit-cli 版本，如 0.46.7

5. 声明环境变量

所有的系统配置，后续都会以环境变量的形式注入，故而需要后续所有的操作都在同一个终端下进行。到这一步，需要声明的环境变量如下：

ini 复制代码

# 声明AK/SK：用于本地 CLI 创建和管理云端资源
export VOLCENGINE_ACCESS_KEY=<your_ak>
export VOLCENGINE_SECRET_KEY=<your_sk>

# 声明网络信息
export VPC_ID=<vpc_id>
export SUBNET_ID=<subnet_id>

# 声明模型接入点相关信息
export MODEL_AGENT_API_KEY=<ark_api_key>
export MODEL_AGENT_NAME=doubao-seed-evolving # 推荐使用当前最新版本的 Seed 模型

# 实验名称（自定义，会作为知识库/记忆库/智能体的命名前缀）
export EXP_NAME="agentkit_customer_xxx"

# TOS 桶（注意把 xxx 换成你的账号 ID）
export DATABASE_TOS_BUCKET="agentkit-platform-xxx"

构建"知识大脑" --- 创建售后知识库

一个优秀的客服必须熟读产品手册。在这一步，我们将创建出知识库，便于后续将售后知识灌输给智能体。

在终端输入以下代码：

创建

bash 复制代码

# 执行创建命令，注意 **自定义** 知识库名称
ak knowledge create --name "knowledge_${EXP_NAME}" \
    --provider-type viking \
    --description "用于AgentKit端到端验证的知识库-knowledge_${EXP_NAME}" \
    --region cn-beijing

验证

bash 复制代码

# 列出账号下的所有知识库，确认实例的状态 STATUS = Ready，并记录 KNOWLEDGE ID
ak knowledge list

声明引用知识库所需的环境变量

ini 复制代码

# 变量的值来自于自定义的知识库名称
export DATABASE_VIKING_COLLECTION="knowledge_${EXP_NAME}"
# 变量的值来自于 ak knowledge list 的返回
export KNOWLEDGE_ID=<KNOWLEDGE ID>

赋予"记忆能力" --- 创建 Viking 记忆库

VikingDB 负责存储产品和政策，Mem0（长期记忆库）负责存储与具体用户相关的信息，包含设备型号、购买时间、已确认的故障现象、做过的排查动作和工单状态等数据。

在终端输入下面这组代码，创建长期记忆库：

matlab 复制代码

ak memory create \
  --name "mem_${EXP_NAME}" \
  --description "用于 AgentKit 验证的长期记忆库" \
  --provider-type MEM0 \
  --region cn-beijing \
  --json '{"VpcConfig":{"VpcId":"'"${VPC_ID}"'","SubnetIds":["'"${SUBNET_ID}"'"]},"LongTermConfiguration":{"Strategies":[{"Name":"default","Type":"Summary"}]}}'

查询并记录 MEMORY ID：

bash 复制代码

ak memory list
# 确认 STATUS = Ready，记录 mem-xxxx 形式的 MEMORY ID

然后前往记忆库 Mem0 控制台 (mic.anruicloud.com/url/2026090...%25EF%25BC%258C%25E7%2582%25B9%25E5%2587%25BB%25E5%2588%259A%25E6%2589%258D%25E5%2588%259B%25E5%25BB%25BA%25E7%259A%2584%25E8%25AE%25B0%25E5%25BF%2586%25E9%25A1%25B9%25E7%259B%25AE%25EF%25BC%259A "https://mic.anruicloud.com/url/20260904mem0)%EF%BC%8C%E7%82%B9%E5%87%BB%E5%88%9A%E6%89%8D%E5%88%9B%E5%BB%BA%E7%9A%84%E8%AE%B0%E5%BF%86%E9%A1%B9%E7%9B%AE%EF%BC%9A")

在「连接管理」里复制私网连接地址；
在「API Keys」里创建并复制 API Key。

声明环境变量：

ini 复制代码

export DATABASE_MEM0_BASE_URL=<Mem0 私网连接地址>
export DATABASE_MEM0_API_KEY=<Mem0 API Key>
export MEMORY_ID=<mem-xxxx>

打造与顾客"接口" --- 模拟 CRM 系统搭建

为了让 AI 能够真正处理业务（如回答客户问题，查询订单等），我们需要一个模拟的业务系统。此处我们使用 python/02-use-cases/customer_support/tools/crm_mock.py 来模拟这个业务系统，并通过自定义工具的方式传递给智能体。

把智能体发布到云端

现在，组件都已准备就绪，让我们在 AgentKit 中将智能体部署起来。

通过 agentkit-cli 进行云端部署之前，需要先创建出部署所需要的配置文件与 Dockerfile。

kotlin 复制代码

ak config --init \
  --agent_name "${EXP_NAME}" \
  --entry_point main.py \
  --knowledge_id "${KNOWLEDGE_ID}" \
  --runtime_network_mode hybrid \
  --runtime_enable_shared_internet_access \
  --runtime-vpc-id "${VPC_ID}" \
  --runtime-subnet-id "${SUBNET_ID}" \
  --tos_bucket "${DATABASE_TOS_BUCKET}" \
  --runtime_envs DATABASE_MEM0_BASE_URL="${DATABASE_MEM0_BASE_URL}" \
  --runtime_envs DATABASE_MEM0_API_KEY="${DATABASE_MEM0_API_KEY}" \
  --runtime_envs MEMORY_ID="${MEMORY_ID}" \
  --runtime_envs DATABASE_VIKING_COLLECTION="knowledge_${EXP_NAME}" \
  --runtime_envs DATABASE_TOS_BUCKET="${DATABASE_TOS_BUCKET}" \
  --runtime_envs DATABASE_TOS_REGION="cn-beijing" \
  --runtime_envs DATABASE_TOS_ENDPOINT="tos-cn-beijing.volces.com"

✅ 成功标志：当前目录生成 agentkit.yaml。

确认入口文件可加载、网络和环境变量无误后，发布：

复制代码

ak launch

✅ 成功标志：终端显示 Launch completed successfully! ，并给出 Runtime Endpoint。

发布成功后，可以登录火山引擎 AgentKit 控制台，点击智能体运行时查看部署的智能体。

发布成功！测试你的智能客服 Agent

测试场景一

sql 复制代码

你好，我之前买的电视坏了。
我的邮箱是 user@example.com，电视序列号是 SN20240001。
我需要帮助排查电视故障：无法开机。

测试场景二

yaml 复制代码

我想买一款客厅用的智能电视,主要用来打游戏,预算 3000 元以内

到这里，这个客服 Agent 已经能查资料、记得住上次的进度、也能把工单落进业务系统。

下一步，你可以尝试：

接入更多渠道： 将你的智能体对接到飞书机器人进行交互，参考：

docs.volcengine.com/docs/86681/...
丰富工具集： 增加"物流查询"或"退款申请"的 API 能力。
个性化定制： 调整 Prompt，让客服的语气更加活泼或更加专业。
自定义知识库： 上传自己的知识库，打造一个完完全全属于你的专属客服！

点击这里，进入 AgentKit 官网，了解更多！