腾讯云智能体开发平台对接使用完全指南：从零搭建到企业级集成
一、引言：企业智能体落地的关键一步
在大模型技术快速发展的背景下，腾讯云智能体开发平台（Tencent Cloud Agent Development Platform，简称ADP）为企业提供了一站式的智能体构建与运营环境。然而，构建一个智能体只是第一步，真正让智能体产生业务价值的关键在于——如何将其与企业现有的系统、数据和工作流程进行对接集成。
本文将从实操角度出发，系统讲解腾讯云智能体开发平台的对接使用方法。无论你是想将智能体嵌入到自有网站或App中，还是希望智能体能够调用企业内部的API完成业务操作，亦或是需要将智能体发布到企业微信等办公平台，本文都将提供清晰的路径和可执行的代码示例。
需要先登录腾讯云控制台，点击：腾讯云控制台，还没有账号，点击：注册后再关联，已有账号点击：登录后再关联
二、平台基础认知与开通准备
2.1 平台核心能力概述
腾讯云智能体开发平台深度整合了LLM+RAG增强检索、自动化工作流、多Agent协作架构等核心能力。平台提供了四种应用模式，分别对应不同复杂度的业务场景：
- 标准模式：适合"从一个简单智能体开始，后续按需扩展能力"的轻量任务，例如先做基础问答，再逐步加入知识库查询和工具调用能力。
- Multi-Agent模式：适合"一个智能体无法完成，需要小团队配合"的复杂任务，系统在后台自动分工协作。
- 单工作流模式：适合已经固化下来的标准业务流程，通过可视化画布拖拽编排成可复用的流程。
- Claw模式：拥有独立工作空间，可自主编写和运行代码来完成复杂任务，适用于数据分析、内容生成等场景。
2.2 开通服务与创建工作空间
使用腾讯云账号完成实名认证后，首次进入智能体开发平台，系统会自动为主账号创建一个"企业"和一个默认工作空间。工作空间是组织和管理应用的顶层容器，一个企业下可以创建多个工作空间，实现不同项目或团队的资源隔离。
三、创建应用与基础配置
3.1 新建应用
在工作空间内创建"应用"，每个应用通常对应一个具体的业务场景。在左侧菜单栏单击"应用开发"，然后点击"新建应用"，输入应用名称并选择合适的模式即可完成创建。
3.2 模型与提示词设置
应用创建后，需要配置模型和提示词。在模型设置模块中，可以根据实际业务场景选择适配的模型并调整参数。提示词配置则用于输入针对大模型的精细化指导内容，例如任务目标、工作方式、限制说明等。平台提供了预设的提示词模板库，涵盖角色扮演类、知识问答类、内容生成类等场景。
四、知识库配置：让智能体"懂业务"
知识库是智能体"知道什么"的来源。平台支持文档、网页及问答对内容的上传与构建。
4.1 知识库的核心概念
知识库以应用为单位，每个应用有对应的知识库，应用服务将基于知识库内的内容回答用户问题。标签是用于精细化分类与检索文档、问答的核心元数据，通过标签管理可以实现知识库的智能筛选与精准回答。
4.2 知识库的API对接方式
除了在控制台手动上传文档外，开发者还可以通过API接口对知识库进行操作。平台API支持创建上传文档、录入问答等操作。将文件存储到应用的知识库内需要三步：获取临时密钥、上传文件、保存文档信息。
五、连接器与工具：打通外部系统
连接器与工具是智能体对接外部系统的核心桥梁。通过连接器，智能体可以在获得授权后访问外部系统中的业务数据。
5.1 连接器：接入第三方系统
连接器用于接入第三方SaaS、企业系统或腾讯生态产品中的数据与操作能力。当平台预置连接器无法满足需求时，可以基于MCP（Model Context Protocol）创建自定义连接器。MCP是专为大语言模型应用设计的开放协议，通过统一的接口规范将分散的API工具集成简化为"即插即用"模式。
接入自定义MCP连接器时，需要配置MCP Server的在线URL地址，并确保Server符合MCP协议规范。平台支持接入sse和streamableHttp两种协议类型的MCP。
5.2 自定义工具：封装企业API
自定义工具用于将企业自定义API、函数能力或已发布应用封装为可被智能体调用的工具。开发者可以根据业务需要定义工具名称、描述、输入参数、输出参数和调用方式。
5.2.1 基于API创建工具
在"连接器与工具 > 自定义工具"中点击"新建工具"，选择"基于API"创建。需要填写API的基础信息（名称、描述、调用地址等），配置接口对应的入参和出参。
平台支持通过OpenAPI规范（YAML或JSON格式）导入API工具。以下是一个OpenAPI配置示例：
openapi: "3.0.0"
info:
title: "企业知识查询API"
version: "1.0.0"
description: "查询企业内部知识库"
servers:
- url: "https://api.example.com"
paths:
/knowledge/search:
get:
summary: "搜索知识"
parameters:
- name: "keyword"
in: "query"
required: true
schema:
type: "string"
- name: "limit"
in: "query"
schema:
type: "integer"
default: 10
responses:
'200':
description: "成功"
content:
application/json:
schema:
type: "object"
properties:
results:
type: "array"
items:
type: "object"
properties:
title:
type: "string"
content:
type: "string"5.2.2 授权方式配置
平台支持两种授权方式：
- APIKey授权：通过密钥或令牌对请求方身份进行校验，在Header或Query中配置密钥对应参数名称和密钥值。
- OAuth 2.0授权：用于对接需要OAuth鉴权的第三方API服务。需要配置ClientId、ClientSecret、AuthorizationUrl、TokenUrl等字段。回调地址为：
https://adp.cloud.tencent.com/api/plugin/oauth/callback。
5.2.3 基于代码创建工具
选择"基于代码"创建工具时，可以使用Python编写自定义函数代码来实现API功能。这种方式适合需要复杂数据处理逻辑的场景，开发者可以在平台内直接编写和调试代码，无需额外部署服务。
六、工作流编排：构建复杂业务逻辑
工作流是单工作流模式应用的核心，通过可视化画布拖拽的方式快速添加大模型、代码、插件等多种节点，编排复杂的业务流程。
6.1 工作流节点类型
- 开始节点：工作流的入口，用于设定启动工作流需要的信息。
- 大模型节点：集成大模型能力，通过配置提示词完成目标业务处理。
- 插件节点：调用智能体商店已上架插件或自定义插件。
- 代码节点：支持在节点内部使用IDE编写Python代码（内置NumPy等常用包）和JavaScript代码处理业务逻辑。
- 知识检索节点：配置知识检索范围，支持"全部知识"、"按特定知识"和按标签三种方式。
- 回复节点：工作流运行中回复给用户的内容。
- 工具节点：调用外部服务，需要配置基础信息、API参数、输出变量及异常处理。
6.2 代码节点实战示例
以下是一个在代码节点中处理数据转换的Python示例：
# 代码节点 - 数据格式化处理
import json
def main(event, context):
# 获取输入变量
raw_data = event.get('raw_data', {})
# 数据转换逻辑
formatted = {
'timestamp': raw_data.get('time', ''),
'summary': raw_data.get('content', '')[:200],
'tags': raw_data.get('categories', []),
'score': calculate_score(raw_data)
}
return {
'status': 'success',
'data': formatted
}
def calculate_score(data):
# 自定义评分逻辑
base_score = data.get('relevance', 0)
popularity = min(data.get('views', 0) / 10000, 10)
return min(base_score + popularity * 0.5, 100)七、对话接口对接：将智能体集成到自有系统
完成应用配置、对话测试和发布并获取AppKey后，就可以使用对话端接口与智能体开发平台进行交互。平台提供了两种常用的接入方式。
7.1 WebSocket接入方式
WebSocket是面向连接的、全双工通道。建立连接前需要先从服务端获取Token，通过这个Token才能与服务端创建WebSocket链接。Token仅建立链接时有效，链接建立成功后废弃。
7.2 HTTP SSE接入方式
HTTP SSE是单向通道，客户端发起HTTP请求后，服务端持续推送流式数据到客户端，此时不支持双向交互。SSE方式实现更简单，适合不需要双向通信的场景，如问答对话。
7.3 获取AppKey
应用发布后，在"应用发布 > 服务状态"页面可以查看AppKey。AppKey是调用对话接口的身份凭证，需要妥善保管。平台还提供体验链接，可直接在Web页面中体验搭建的智能体应用。
7.4 Python SDK调用示例
腾讯云提供了多种编程语言的SDK，已封装签名和请求过程。以下是一个使用Python SDK调用对话接口的示例：
# 安装SDK
# pip install tencentcloud-sdk-python-adp
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.lke.v20231130 import lke_client, models
# 初始化认证
cred = credential.Credential("你的SecretId", "你的SecretKey")
# 配置HTTP
httpProfile = HttpProfile()
httpProfile.endpoint = "lke.tencentcloudapi.com"
clientProfile = ClientProfile()
clientProfile.httpProfile = httpProfile
# 创建客户端
client = lke_client.LkeClient(cred, "ap-guangzhou", clientProfile)
# 构建请求
req = models.ChatRequest()
req.AppKey = "你的AppKey"
req.Query = "你好，请帮我查询一下最新的销售数据"
# 发送请求
resp = client.Chat(req)
print(resp.to_json_string())八、发布与渠道接入
将应用从测试环境发布到正式环境后，可以根据业务需要选择多种接入方式。
8.1 发布流程
在控制台打开目标应用，进入"应用发布"页面，点击发布按钮将应用发布至生产环境。发布成功后，在服务状态页签内可以获取体验链接和AppKey。
8.2 企业微信对接
腾讯云智能体开发平台支持将智能体一键发布到企业微信。具体步骤如下：
- 进入"应用开发 > 查看应用 > 应用发布 > 发布渠道"
- 单击"新建发布渠道"，选择"企微智能机器人"
- 在企业微信管理后台创建API模式机器人，获取Bot ID和Secret
- 将获取的参数填入智能体开发平台的渠道配置中
平台也支持扫码授权方式，在企业微信中扫码即可一键创建机器人并授权。
8.3 其他接入渠道
除了企业微信，平台还支持接入微信公众号、小程序、LINE、Telegram等渠道。开发者也可以自研前端通过API/SDK调用。
九、监控运营与持续优化
应用上线后，需要在平台中查看请求量、成功率、响应延迟、Token消耗等指标。通过分析常见问题和满意度数据，可以持续优化：补充或清洗知识库、调整工作流和提示词、优化模型选择和路由策略。
十、企业级落地的三个关键建议
10.1 安全合规
建议使用RAM子账号进行最小权限授权，避免主账号密钥泄露。对于涉及敏感数据的工具和连接器，应配置OAuth 2.0授权而非APIKey。
10.2 成本优化
合理规划知识库的存储策略，定期清理无用文档。在模型选择上，根据场景复杂度选择合适的模型规格，避免过度配置。监控Token消耗，及时发现异常调用。
10.3 持续迭代
智能体不是一次性交付的产品，而是一个需要持续运营的系统。建议建立定期的效果评测机制，为关键场景编写测试用例，通过评测能力批量评估知识检索效果（召回率、准确率等）和对话质量（相关性、完整性、流畅度等）。
十一、总结
腾讯云智能体开发平台提供了从智能体构建到企业级集成的完整链路。通过自定义工具和连接器，企业可以将智能体与内部系统深度对接；通过WebSocket和HTTP SSE接口，开发者可以将智能体无缝嵌入到自有应用中；通过多渠道发布能力，智能体可以快速触达最终用户。掌握这些对接方法，是让智能体从"玩具"变成"工具"的关键一步。
常见问题问答
问1：智能体开发平台支持哪些编程语言的SDK？
答：平台提供Python、Java、PHP、Go、Node.js、.NET、C++、Ruby共8种编程语言的SDK。推荐使用API Explorer工具在线调试和生成SDK调用示例。
问2：自定义工具和连接器有什么区别？
答：自定义工具主要用于将单个API或函数封装为可被智能体调用的能力，适合轻量级的接口集成。连接器则用于接入第三方SaaS或企业系统，支持更复杂的授权流程（如OAuth 2.0）和MCP协议。
问3：对话接口的WebSocket和HTTP SSE应该如何选择？
答：WebSocket是全双工通道，支持双向交互；HTTP SSE是单向通道，服务端持续推送数据。如果只需要问答对话，SSE即可满足；如果需要实时交互或双向通信，建议使用WebSocket。
问4：如何将智能体发布到企业微信？
答：在"应用发布 > 发布渠道"中新建发布渠道并选择"企微智能机器人"。可以通过扫码授权一键创建机器人，也可以手动配置Bot ID和Secret。企业微信接入只需两步配置，无需单独开发连接器。
问5：知识库中的文档支持哪些格式？
答：平台支持文档、网页及问答对内容的上传与构建。具体支持的文档格式请参考平台官方文档，通常包括常见的办公文档格式（如PDF、Word、Excel等）和纯文本文件。
问6：工作流中的代码节点可以做什么？
答：代码节点支持编写Python（内置NumPy等常用包）和JavaScript代码，用于处理数据转换、科学计算、自定义业务逻辑等。代码节点是工作流中实现灵活定制能力的重要组件。
