> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta Business Agent 概述

> 通过 YCloud API 为 WhatsApp Business 电话号码构建并运行由 Meta 托管的 AI Agent。

Meta Business Agent 是一个由 Meta 托管的 AI Agent，可以使用您配置的商业信息、知识、技能和工具来回答 WhatsApp 客户消息。YCloud 通过 YCloud REST API 开放 Meta Business Agent 的生命周期管理，并代表您提供 Meta 凭证。

<Warning>
  Meta Business Agent 属于 Meta 的早期访问产品。其可用性、验证规则和运行时行为可能会独立于 YCloud 发生变化。请务必针对您计划使用的电话号码调用 [检查资格端点](/api-reference/meta-business-agents/check-eligibility)。
</Warning>

## API 基础知识

| 项 | 值 |
| - | - |
| Base URL | `https://api.ycloud.com/v2` |
| 身份验证 | `X-API-Key: YOUR_API_KEY` |
| 资源路径 | `/metaBusinessAgents/{entityId}` |
| `entityId` | 拥有该 Agent 的 WhatsApp Business 电话号码 ID |
| 载荷命名 | `snake_case` |

YCloud 会根据您的 API 密钥解析租户和 Meta 访问令牌。请勿在这些请求中发送 Meta 访问令牌。

## 推荐的生命周期

请按顺序遵循构建和发布指南。它们将各个 API 资源串联成一个端到端的上线流程。

1. [准备并检查资格](/zh/documentation/meta-business-agent/prepare-and-check-eligibility)。
2. 在受限测试状态下[接入并配置](/zh/documentation/meta-business-agent/onboard-and-configure) Agent。
3. [测试并评估](/zh/documentation/meta-business-agent/test-and-evaluate)单轮、多轮及代表性业务场景。
4. 从白名单接收者逐步[安全推广](/zh/documentation/meta-business-agent/roll-out-safely)至全部受众。
5. [运营和排查](/zh/documentation/meta-business-agent/operate-and-troubleshoot)已上线的 Agent。

## 工作流程涵盖的资源

每个 API 参考目录都有自己的着陆页，并链接到该领域内的每个端点。

| 领域 | 功能说明 | API 参考 |
| - | - | - |
| 接入 | 检查资格、接入或删除 Agent、管理资料设置和预算，以及维护白名单条目 | [打开目录](/zh/api-reference/meta-business-agents/onboard) |
| 配置 | 管理业务知识、行为与界面技能、连接器、凭据以及连接器工具 | [打开目录](/zh/api-reference/meta-business-agents/configure) |
| 运营 | 提交事件、检查对话轮次、测试响应、控制对话线程、运行评估以及获取结果 | [打开目录](/zh/api-reference/meta-business-agents/operate) |

此版本记录了 62 个 REST 操作。通过 API 创建的 Agent 还可以发出
[回显和转接 Webhook 事件](/zh/api-reference/guides/examples/webhook-examples/overview#echo-and-agent-handover-events)。

## 归属与隔离

除资格检查外，限定电话号码作用域的操作都需要属于同一 YCloud 租户的有效公开 API Agent 绑定。当绑定缺失、属于其他租户或通过不兼容的来源创建时，YCloud 会返回 `404`。这可防止某个租户或集成界面访问其他 Agent。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.