一、引言：企业智能体落地的关键一步

在大模型技术快速发展的背景下，腾讯云智能体开发平台（Tencent Cloud Agent Development Platform，简称ADP）为企业提供了一站式的智能体构建与运营环境。然而，构建一个智能体只是第一步，真正让智能体产生业务价值的关键在于——如何将其与企业现有的系统、数据和工作流程进行对接集成。

本文将从实操角度出发，系统讲解腾讯云智能体开发平台的对接使用方法。无论你是想将智能体嵌入到自有网站或App中，还是希望智能体能够调用企业内部的API完成业务操作，亦或是需要将智能体发布到企业微信等办公平台，本文都将提供清晰的路径和可执行的代码示例。

需要先登录腾讯云控制台，点击：

腾讯云智能体开发平台深度整合了LLM+RAG增强检索、自动化工作流、多Agent协作架构等核心能力。平台提供了四种应用模式，分别对应不同复杂度的业务场景：

使用腾讯云账号完成实名认证后，首次进入智能体开发平台，系统会自动为主账号创建一个"企业"和一个默认工作空间。工作空间是组织和管理应用的顶层容器，一个企业下可以创建多个工作空间，实现不同项目或团队的资源隔离。

在工作空间内创建"应用"，每个应用通常对应一个具体的业务场景。在左侧菜单栏单击"应用开发"，然后点击"新建应用"，输入应用名称并选择合适的模式即可完成创建。

应用创建后，需要配置模型和提示词。在模型设置模块中，可以根据实际业务场景选择适配的模型并调整参数。提示词配置则用于输入针对大模型的精细化指导内容，例如任务目标、工作方式、限制说明等。平台提供了预设的提示词模板库，涵盖角色扮演类、知识问答类、内容生成类等场景。

四、知识库配置：让智能体"懂业务"

知识库是智能体"知道什么"的来源。平台支持文档、网页及问答对内容的上传与构建。

知识库以应用为单位，每个应用有对应的知识库，应用服务将基于知识库内的内容回答用户问题。标签是用于精细化分类与检索文档、问答的核心元数据，通过标签管理可以实现知识库的智能筛选与精准回答。

除了在控制台手动上传文档外，开发者还可以通过API接口对知识库进行操作。平台API支持创建上传文档、录入问答等操作。将文件存储到应用的知识库内需要三步：获取临时密钥、上传文件、保存文档信息。

五、连接器与工具：打通外部系统

连接器与工具是智能体对接外部系统的核心桥梁。通过连接器，智能体可以在获得授权后访问外部系统中的业务数据。

连接器用于接入第三方SaaS、企业系统或腾讯生态产品中的数据与操作能力。当平台预置连接器无法满足需求时，可以基于MCP（Model Context Protocol）创建自定义连接器。MCP是专为大语言模型应用设计的开放协议，通过统一的接口规范将分散的API工具集成简化为"即插即用"模式。

接入自定义MCP连接器时，需要配置MCP Server的在线URL地址，并确保Server符合MCP协议规范。平台支持接入sse和streamableHttp两种协议类型的MCP。

自定义工具用于将企业自定义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"

选择"基于代码"创建工具时，可以使用Python编写自定义函数代码来实现API功能。这种方式适合需要复杂数据处理逻辑的场景，开发者可以在平台内直接编写和调试代码，无需额外部署服务。

六、工作流编排：构建复杂业务逻辑

工作流是单工作流模式应用的核心，通过可视化画布拖拽的方式快速添加大模型、代码、插件等多种节点，编排复杂的业务流程。

以下是一个在代码节点中处理数据转换的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后，就可以使用对话端接口与智能体开发平台进行交互。平台提供了两种常用的接入方式。

WebSocket是面向连接的、全双工通道。建立连接前需要先从服务端获取Token，通过这个Token才能与服务端创建WebSocket链接。Token仅建立链接时有效，链接建立成功后废弃。

HTTP SSE是单向通道，客户端发起HTTP请求后，服务端持续推送流式数据到客户端，此时不支持双向交互。SSE方式实现更简单，适合不需要双向通信的场景，如问答对话。

应用发布后，在"应用发布 > 服务状态"页面可以查看AppKey。AppKey是调用对话接口的身份凭证，需要妥善保管。平台还提供体验链接，可直接在Web页面中体验搭建的智能体应用。

腾讯云提供了多种编程语言的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())

将应用从测试环境发布到正式环境后，可以根据业务需要选择多种接入方式。

在控制台打开目标应用，进入"应用发布"页面，点击发布按钮将应用发布至生产环境。发布成功后，在服务状态页签内可以获取体验链接和AppKey。

腾讯云智能体开发平台支持将智能体一键发布到企业微信。具体步骤如下：

平台也支持扫码授权方式，在企业微信中扫码即可一键创建机器人并授权。

除了企业微信，平台还支持接入微信公众号、小程序、LINE、Telegram等渠道。开发者也可以自研前端通过API/SDK调用。

应用上线后，需要在平台中查看请求量、成功率、响应延迟、Token消耗等指标。通过分析常见问题和满意度数据，可以持续优化：补充或清洗知识库、调整工作流和提示词、优化模型选择和路由策略。

十、企业级落地的三个关键建议

建议使用RAM子账号进行最小权限授权，避免主账号密钥泄露。对于涉及敏感数据的工具和连接器，应配置OAuth 2.0授权而非APIKey。

合理规划知识库的存储策略，定期清理无用文档。在模型选择上，根据场景复杂度选择合适的模型规格，避免过度配置。监控Token消耗，及时发现异常调用。

智能体不是一次性交付的产品，而是一个需要持续运营的系统。建议建立定期的效果评测机制，为关键场景编写测试用例，通过评测能力批量评估知识检索效果（召回率、准确率等）和对话质量（相关性、完整性、流畅度等）。

腾讯云智能体开发平台提供了从智能体构建到企业级集成的完整链路。通过自定义工具和连接器，企业可以将智能体与内部系统深度对接；通过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代码，用于处理数据转换、科学计算、自定义业务逻辑等。代码节点是工作流中实现灵活定制能力的重要组件。

腾讯云智能体开发平台对接使用完全指南：从零搭建到企业级集成

云计算

后端

架构设计

腾讯云智能体开发平台(ADP)提供一站式企业智能体构建方案，支持LLM+RAG增强检索、多Agent协作、工作流编排等功能。平台支持四种应用模式，可对接企业微信等办公平台，提供WebSocket/HTTPSSE两种API接入方式。开发者可通过自定义工具、连接器实现企业系统集成，利用知识库增强业务理解，并通过可视化工作流编排复杂业务逻辑。平台还提供Python等8种语言SDK，助力企业快速实现智能体落地应用。

数据处理

敏感数据

数据分析

文件存储

安全合规

数据转换

容器

Python

路由

OAuth

Java

JSON

SaaS

2026上云采购 | AI焕新·智启新局

xiaowei

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

腾讯云智能体开发平台(ADP)提供一站式企业智能体构建方案，支持LLM+RAG增强检索、多Agent协作、工作流编排等功能。平台支持四种应用模式，可对接企业微信等办公平台，提供WebSocket/HTTPSSE两种API接入方式。开发者可通过自定义工具、连接器实现企业系统集成，利用知识库增强业务理解，并通过可视化工作流...

腾讯云智能体开发平台对接使用完全指南：从零搭建到企业级集成

腾讯云智能体开发平台对接使用完全指南：从零搭建到企业级集成

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐