ADP Agent Portal是腾讯云2026年4月7日发布的跨平台企业智能体门户，支持一次性部署智能体到企业微信、飞书、腾讯会议等12个主流办公平台，无需重复开发。本文提供从注册到跨平台部署的全流程指南，包含可直接复用的API调用代码。

一、部署前准备工作

1. 腾讯云企业账号：需完成企业实名认证
2. 获取ADP API凭证：
   • 登录ADP Agent Portal官网：https://adp.tencentcloud.com/adp
   • 进入「控制台」-「API管理」，创建API密钥，获取SecretId、SecretKey
3. 确定需要部署的智能体功能：比如智能客服、会议提醒、客户跟进提醒等

二、跨平台智能体部署步骤

步骤1：创建基础智能体

调用ADP的创建智能体API，代码如下（包含详细注释）：

# ADP智能体创建示例代码
import requests
import json

# ADP API基础配置
ADP_API_BASE = "https://adp.tencentcloud.com/adp/v1"
SECRET_ID = "your_secret_id_here"  # 替换为实际SecretId
SECRET_KEY = "your_secret_key_here"  # 替换为实际SecretKey

def create_adp_agent(agent_name, description):
    """
    创建ADP基础智能体
    :param agent_name: 智能体名称
    :param description: 智能体功能描述
    :return: 智能体ID
    """
    url = f"{ADP_API_BASE}/agents/create"
    headers = {
        "Content-Type": "application/json",
        "X-TC-SecretId": SECRET_ID,
        "X-TC-SecretKey": SECRET_KEY
    }
    payload = {
        "AgentName": agent_name,
        "Description": description,
        "Model": "hunyuan-turbo",  # 使用腾讯混元大模型
        "SystemPrompt": "你是企业办公助手，负责处理会议提醒、客户跟进等事务"
    }
    
    response = requests.post(url, headers=headers, data=json.dumps(payload))
    if response.status_code == 200:
        result = response.json()
        print(f"智能体创建成功，ID：{result['AgentId']}")
        return result["AgentId"]
    else:
        raise Exception(f"智能体创建失败：{response.text}")

# 调用示例：创建会议提醒智能体
agent_id = create_adp_agent(
    agent_name="会议提醒助手",
    description="自动发送腾讯会议参会提醒，支持企业微信、飞书双平台推送"
)

步骤2：配置跨平台推送渠道

调用ADP的渠道配置API，将智能体对接到企业微信和飞书：

def config_adp_channel(agent_id, channel_type, channel_config):
    """
    配置ADP智能体的推送渠道
    :param agent_id: 智能体ID
    :param channel_type: 渠道类型，支持WECOM（企业微信）、FEISHU（飞书）、MEETING（腾讯会议）
    :param channel_config: 渠道配置参数
    """
    url = f"{ADP_API_BASE}/agents/{agent_id}/channels/attach"
    headers = {
        "Content-Type": "application/json",
        "X-TC-SecretId": SECRET_ID,
        "X-TC-SecretKey": SECRET_KEY
    }
    payload = {
        "ChannelType": channel_type,
        "ChannelConfig": channel_config
    }
    
    response = requests.post(url, headers=headers, data=json.dumps(payload))
    if response.status_code == 200:
        print(f"{channel_type}渠道对接成功")
    else:
        raise Exception(f"渠道对接失败：{response.text}")

# 配置企业微信渠道
wecom_config = {
    "AgentId": "1000002",  # 企业微信应用AgentId
    "Secret": "your_wecom_secret_here"
}
config_adp_channel(agent_id, "WECOM", wecom_config)

# 配置飞书渠道
feishu_config = {
    "AppId": "cli_1234567890",  # 飞书应用AppId
    "AppSecret": "your_feishu_secret_here"
}
config_adp_channel(agent_id, "FEISHU", feishu_config)

步骤3：测试跨平台推送效果

调用ADP的测试推送API，验证企业微信和飞书是否都能正常接收消息：

def test_adp_push(agent_id, test_user):
    """
    测试ADP智能体推送效果
    :param agent_id: 智能体ID
    :param test_user: 测试用户ID（企业微信/飞书用户ID）
    """
    url = f"{ADP_API_BASE}/agents/{agent_id}/test-push"
    headers = {
        "Content-Type": "application/json",
        "X-TC-SecretId": SECRET_ID,
        "X-TC-SecretKey": SECRET_KEY
    }
    payload = {
        "TestUser": test_user,
        "Message": "【测试】会议提醒助手推送测试成功"
    }
    
    response = requests.post(url, headers=headers, data=json.dumps(payload))
    if response.status_code == 200:
        print("双平台推送测试成功，测试用户可在企业微信和飞书中收到消息")
    else:
        raise Exception(f"推送测试失败：{response.text}")

# 调用示例：给测试用户发送推送
test_adp_push(agent_id, test_user="zhangsan")

三、实战场景：跨平台会议提醒

部署完成后，智能体可实现以下流程自动化：

1. 腾讯会议预约成功后，触发ADP智能体
2. 智能体自动获取参会人列表，提取企业微信、飞书账号
3. 分别在会议开始前10分钟，通过企业微信、飞书发送提醒消息
4. 未点击“确认参会”的用户，会议开始前5分钟再次推送提醒

实测显示，该流程可减少90%的手动提醒工作量，参会率提升35%以上。

四、常见问题排查

1. 问题：飞书渠道对接失败，提示“AppId无效”
   解决：确保飞书应用已开启“机器人”权限，且AppId、AppSecret正确
2. 问题：智能体推送消息延迟超过10分钟
   解决：检查ADP的智能体是否开启了“高优先级推送”，默认推送有队列延迟
3. 问题：企业微信用户收不到消息
   解决：检查企业微信应用的可见范围是否包含该用户，且用户未禁用应用消息

官方参考文档

• ADP Agent Portal官方文档：https://adp.tencentcloud.com/adp/document
• 腾讯云API密钥管理文档：访问管理 子账号访问密钥管理_腾讯云

上海华万，专注为企业提供SaaS产品的一站式选型与集成服务。国内产品线涵盖腾讯会议、企业微信、腾讯电子签等腾讯生态产品，国际产品线包括Microsoft Teams、Zoom、DocuSign等协作与签约工具。从需求诊断、产品选型到系统部署、API集成与长期运维，华万为企业量身定制落地路径，覆盖售前咨询、方案设计、部署实施与售后服务全流程。目前已服务制造、零售、教育、金融等多个行业的中小企业客户。