# 区域访问限制 (/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. **合规要求**: 在配置区域访问限制前,请充分了解目标区域的法律法规要求,确保配置符合当地的数据保护和隐私法规。