# 区域访问限制 (/zh-CN/ai/build/harden-and-optimize/regional-restrictions)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
为适应不同国家或地区的法律法规,声网对话式 AI 引擎支持区域访问限制功能。
开启区域访问限制后,不论用户在哪个区域使用你的 App,对话式 AI 引擎都只会访问指定区域的声网服务器。
例如你指定了北美为访问区域,假设有两位用户分别从北美和新加坡发起通话:
| 指定访问区域 | 用户所在区域 | 实际访问区域 | 连接后的用户体验 |
| --- | --- | --- | --- |
| 北美 | 北美 | 北美 | 正常 |
| 北美 | 新加坡 | 北美 | [geofencing-markdown-1-2-3 details](#table-slot-geofencing-markdown-1-2-3) |
**geofencing-markdown-1-2-3 details**
可能受到较大影响。由于指定区域与 App 用户所在区域之间存在跨区域公共互联网,公共互联网网络质量较差会导致音视频体验受到影响。如果指定区域的服务器都不可用,服务会直接报错。
## 默认行为 [#默认行为]
在未开启区域访问限制或使用 `GLOBAL` 区域访问限制时,对话式 AI 引擎会根据 LLM URL 的 IP 地址自动选择最近的服务器启动对话式 AI 引擎服务,并支持故障转移 (failover):
1. **智能部署**: 系统会根据你配置的 LLM URL 对应的 IP 地址,自动在相应区域启动对话式 AI 引擎服务。
2. **就近选择**: 如果对应区域没有可用服务器,系统会自动选择最近的可用区域。
3. **故障转移**: 当某个区域的服务不可用时,系统会自动切换到其他可用区域。
:::warning[注意]
开启区域访问限制后,上述默认行为将不再适用。系统会严格限制在指定区域内访问,不会进行跨区域的故障转移。
:::
## 实现方法 [#实现方法]
### 配置对话式 AI 引擎区域访问限制 [#配置对话式-ai-引擎区域访问限制]
在调用[创建对话式智能体 API](/zh-CN/api-reference/api-ref/conversational-ai/join) 时,通过 `properties.geofence` 字段配置区域访问限制。
#### 参数说明 [#参数说明]
下表说明 `properties.geofence` 中各字段的含义。
| 字段 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `area` | String | 是 | [geofencing-html-0-1-3 details](#table-slot-geofencing-html-0-1-3) |
| `exclude_area` | String | 否 | [geofencing-html-0-2-3 details](#table-slot-geofencing-html-0-2-3) |
**geofencing-html-0-1-3 details**
允许访问的区域。可选以下值:
- `GLOBAL`:全球
- `NORTH_AMERICA`:北美
- `EUROPE`:欧洲
- `ASIA`:亚洲
- `INDIA`:印度
- `JAPAN`:日本
**geofencing-html-0-2-3 details**
排除的区域。仅当 `area` 为 `GLOBAL` 时可用。可选以下值:
- `NORTH_AMERICA`:北美
- `EUROPE`:欧洲
- `ASIA`:亚洲
- `INDIA`:印度
- `JAPAN`:日本
#### 配置示例 [#配置示例]
**示例 1: 限制仅访问北美区域**
```json
{
"name": "customer_service",
"properties": {
"channel": "test_channel",
"token": "your_rtc_token",
"agent_rtc_uid": "123",
"remote_rtc_uids": ["456"],
"geofence": {
"area": "NORTH_AMERICA"
},
"llm": {
// ... LLM 配置
},
"tts": {
// ... TTS 配置
}
}
}
```
**示例 2: 全球访问但排除印度**
```json
{
"name": "customer_service",
"properties": {
"channel": "test_channel",
"token": "your_rtc_token",
"agent_rtc_uid": "123",
"remote_rtc_uids": ["456"],
"geofence": {
"area": "GLOBAL",
"exclude_area": "INDIA"
},
"llm": {
// ... LLM 配置
},
"tts": {
// ... TTS 配置
}
}
}
```
### 配置 RTC 区域访问限制 [#配置-rtc-区域访问限制]
声网对话式 AI 引擎服务和声网 RTC 服务的区域访问限制配置是**相互独立**的。如果你需要实现完整的端到端区域访问限制,确保和智能体互动的整个音视频通话链路都限定在指定区域内,你还需要参考 [RTC 区域访问限制](/zh-CN/realtime-media/rtc-server-sdk/build/set-region)进行配置。
## 数据驻留 (Data Residency) [#数据驻留-data-residency]
除了配置对话式 AI 引擎的区域访问限制外,部分 LLM、TTS、ASR 供应商也提供了不同区域的数据驻留服务。你可以通过配置 LLM、TTS、ASR 模块使用的 URL 来确保数据不会跨区域传输。
例如,ElevenLabs 支持通过不同的 URL 端点选择数据处理区域,详见 [ElevenLabs 文档](https://elevenlabs.io/docs/overview/administration/data-residency)。
以下示例代码展示了如何配置 ElevenLabs 的 TTS 服务,使用欧洲区域的 URL 端点:
```json
{
"properties": {
"tts": {
"vendor": {
"name": "elevenlabs"
},
"url": "wss://api.eu.elevenlabs.io/v1/text-to-speech/{voice_id}/stream-input"
}
}
}
```
### 最佳实践建议 [#最佳实践建议]
为了确保数据完全驻留在指定区域,建议采取以下措施:
1. **配置对话式 AI 引擎区域限制**: 使用 `geofence` 参数限制对话式 AI 引擎服务器的访问区域。
2. **配置 RTC 区域限制**: 在 RTC SDK 中配置相应的区域访问限制。
3. **选择区域化的 AI 服务**: 在配置 LLM、TTS、ASR 时,选择支持区域数据驻留的供应商,并使用对应区域的 URL 端点。
4. **验证配置**: 在生产环境部署前,充分测试区域访问限制是否生效,确保数据不会意外跨区域传输。
## 注意事项 [#注意事项]
1. **性能影响**: 区域访问限制可能会影响用户体验。如果用户所在区域与指定区域相距较远,可能会出现较高的网络延迟。
2. **服务可用性**: 开启区域访问限制后,如果指定区域的服务器不可用或资源不足,服务将直接报错,不会自动切换到其他区域。
3. **配置一致性**: 确保对话式 AI 引擎、RTC SDK 和 LLM、TTS、ASR 供应商的区域配置保持一致,避免数据跨区域传输。
4. **合规要求**: 在配置区域访问限制前,请充分了解目标区域的法律法规要求,确保配置符合当地的数据保护和隐私法规。