> ## 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 поэтапно, проверяйте каждое изменение настроек и держите наготове проверенный запрос на откат.

Развертывание имеет два независимых элемента управления: `rollout.enabled` определяет, включен ли агент, а `ai_audience` определяет, кто может получать ответы агента.

**Справочник по API:** [GET Get Settings](/api-reference/meta-business-agents/get-settings) · [PUT Replace Settings](/api-reference/meta-business-agents/replace-settings)

## Включение агента для получателей из белого списка

Ограничьте аудиторию во время первых реальных тестов в WhatsApp.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request PUT \
  "https://api.ycloud.com/v2/metaBusinessAgents/$PHONE_NUMBER_ID/settings" \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "rollout": {"enabled": true},
    "ai_audience": "ALLOWLISTED_ONLY"
  }'
```

Отправьте репрезентативные сообщения с каждого тестового номера из белого списка и убедитесь, что номера, не входящие в белый список, не получают ответы агента.

## Чтение действующих настроек

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.ycloud.com/v2/metaBusinessAgents/$PHONE_NUMBER_ID/settings" \
  --header "X-API-Key: $YCLOUD_API_KEY"
```

Ответ представляет собой массив, даже если существует только один объект настроек. Проверяйте как `rollout.enabled`, так и `ai_audience` после каждого изменения развертывания.

## Установка бюджетов агента

Бюджеты ограничивают использование токенов или обращений к ИИ в течение скользящего временного окна. YCloud использует идентификатор номера телефона WhatsApp Business для поиска связанного Business Manager.

**Справочник по API:** [GET Get Budgets](/api-reference/meta-business-agents/get-budgets) · [PUT Replace Budgets](/api-reference/meta-business-agents/replace-budgets)

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request PUT \
  "https://api.ycloud.com/v2/metaBusinessAgents/$PHONE_NUMBER_ID/budgets" \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "budgets": [
      {
        "unit_type": "token",
        "time_window": "one_day",
        "max_budget": 10000
      },
      {
        "unit_type": "ai_turn",
        "time_window": "seven_days",
        "max_budget": 500
      }
    ]
  }'
```

`unit_type` — это `token` или `ai_turn`. `time_window` — это `one_day`, `seven_days`, `fourteen_days` или `thirty_days`. `max_budget` должно быть положительным целым числом.

`PUT` заменяет всю коллекцию бюджетов. Включите `budget_id` для каждого существующего бюджета, который вы хотите сохранить, и опустите его для нового бюджета. Каждая пара `(unit_type, time_window)` должна быть уникальной. Отправьте `{"budgets":[]}`, чтобы снять все ограничения. Считывайте коллекцию обратно после каждой замены.

## Расширение на всю аудиторию

Изменяйте только аудиторию после того, как развертывание для белого списка пройдет приемочное тестирование.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request PUT \
  "https://api.ycloud.com/v2/metaBusinessAgents/$PHONE_NUMBER_ID/settings" \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"ai_audience":"EVERYONE"}'
```

Пропущенные настройки остаются без изменений со стороны YCloud. Снова прочитайте настройки и отслеживайте реальные разговоры, прежде чем считать развертывание завершенным.

## Откат при необходимости

Держите этот запрос наготове перед расширением аудитории:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request PUT \
  "https://api.ycloud.com/v2/metaBusinessAgents/$PHONE_NUMBER_ID/settings" \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "rollout": {"enabled": false},
    "ai_audience": "ALLOWLISTED_ONLY"
  }'
```

Прочитайте действующие настройки после отката. Отключение развертывания не удаляет агента, знания, навыки или коннекторы.

<Warning>
  Включение развертывания изменяет обработку сообщений в реальном времени. Согласуйте ответственность со службами поддержки и не используйте полную аудиторию в качестве замены завершению ограниченного приемочного тестирования.
</Warning>

<Card title="Далее: Эксплуатация и устранение неполадок" icon="arrow-right" href="/ru/documentation/meta-business-agent/operate-and-troubleshoot">
  Контролируйте живые разговоры, обрабатывайте события, проверяйте журналы и устраняйте сбои после запуска.
</Card>


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