# Реализация циклов в сценарии | Слот Repeat
## Назначение и общая информация
Слот Repeat и его дочерние Слоты (Repeat Next, Repeat End, Repeat Error, Repeat Limit) предназначены для выполнения цикла из заданного количества итераций в Сценарий агента.Слот Repeat является Комплексный слотом и не может существовать без четырех Дочерний слотов: Repeat Next, Repeat End, Repeat Error, Repeat Limit которые начинают собственные Ветка сценария.Добавить другие дочерние Дочерний слоты невозможно.
Лимит на количество итераций цикла одного слота Repeat: 500 итераций.В Сценарий агента допустимо несколько конструкций Repeat.
Подслот Repeat Next и следующая за ним Ветка сценария являются непосредственно веткой цикла. Сценарий агента идет по этой Ветка сценария до выполнения одного из следующих условий:
* достигнуто установленное в Слоте Количество итераций цикла;
* получено Сообщение собеседника, в случае если в цикле нет Слота, который может его обработать;
* достигнут Лимит на количество итераций цикла одного слота Repeat (500 итераций) или Лимит на количество итераций цикла в минуту на компанию (200 итераций).
Подслот Repeat End предназначен для продолжения Сценарий агента когда закончился цикл, т.е. выполнено установленное в Слоте Количество итераций цикла, а также для выхода из цикла, если в процессе его выполнения поступило Сообщение собеседника, а в цикле нет Слота, который может его обработать.Подслот Repeat Error предназначен для продолжения Сценарий агента в случае, если возникла ошибка выполнения цикла, когда было установлено невалидное количество итераций.Подслот Repeat Limit предназначен для выхода из цикла при достижении Лимит на количество итераций цикла одного слота Repeat (500 итераций) или Лимит на количество итераций цикла в минуту на компанию (200 итераций).
## Создание и настройки комплексного слота Repeat
### Атрибуты слота Repeat
1. Slot Name\*ー название Слота, которое будет отображено в Дерево сценария. Максимальная длина значения поля — 40 символов.
2. Number of iterations\* ー Количество итераций цикла.
3. 1. Допустимые значения:
2. 1. точное значение — положительное целое число или 0;
2. Выражение, дающее результат — положительное целое число или 0;
3. Контекстная переменная.
3. Обрезка пробелов: по нажатию кнопки CREATE (при создании слота) или SAVE (при редактировании слота) обрезаются пробелы и переносы строк в начале и в конце поля Number of iterations.
4. При импорте конфигурационного файла Агента с невалидным значением в поле Number of iterations (см. п. 2а) будут выведены сообщения об ошибке и Агент не будет импортирован в Платформа.\
4. Подсказка с текстом Variable {{ repeat\_index }} will be used as iteration counter. It will be incremented on 1 every time subslot Next is being executed.
5. Кнопка Show more, по нажатию которой подсказка разворачивается.
### Подслоты Repeat Next, Repeat End, Repeat Error, Repeat Limit
1. При создании слота автоматически генерируются четыре Подслота Repeat Next, Repeat End, Repeat Error, Repeat Limit.
2. Эти Подслоты не подлежат изменению и их можно удалить только с Родительский слотом.
3. Расположение Подслотов определяется автоматически, перемещать Подслоты нельзя.
4. Добавлять новые Подслоты в Родительский слот Repeat нельзя.
### Атрибуты подслотов
#### Repeat Next
1. Slot Nameー название Слота, которое будет отображено в Дерево сценария. По умолчанию в поле установлено значение Repeat Next. Максимальная длина значения поля — 40 символов.
2. Подсказка с текстом:
3. * Variable {{ repeat\_index }} is incremented on 1 every time subslot Next is being executed
* If you jump to this slot {{ repeat\_index }} will be incremented and loop will be continued
#### Repeat End
1. Slot Nameー название Слота, которое будет отображено в Дерево сценария. По умолчанию в поле установлено значение Repeat End. Максимальная длина значения поля — 40 символов.
2. Подсказка с текстом The agent goes to subslot End when the loop completes all iterations.
#### Repeat Error
1. Slot Nameー название Слота, которое будет отображено в Дерево сценария. По умолчанию в поле установлено значение Repeat Error. Максимальная длина значения поля — 40 символов.
2. Подсказка с текстом The agent goes to subslot Error if you set invalid value (e.g. string or negative value) as number of iterations.
#### Repeat Limit
1. Slot Nameー название Слота, которое будет отображено в Дерево сценария. По умолчанию в поле установлено значение Repeat Limit. Максимальная длина значения поля — 40 символов.
2. Подсказка с текстом The agent goes to slot Limit if the loop reaches the technical limit of iterations (see your subscription limits).
### Использование синтаксиса в Слоте
В Слоте Repeat допустимо использование Выражение в поле Number of iterations. Подробнее: Синтаксис
## Работа слота
Для отражения номера текущей итерации цикла используется Системная контекстная переменная repeat\_index. Нумерация итераций начинается с 0.
### Запуск цикла
1. При попадании в Слот Repeat устанавливается значение repeat\_index, равное -1, и происходит вычисление значения Количество итераций цикла в поле Number of iterations:
2. 1. Если в результате вычисления получается не целое число или число меньше 0, происходит переход в Repeat Error, при этом:
2. 1. значение repeat\_index не изменяется и остается равным -1 (цикл попытались запустить, но он ни разу не отработал);
2. error принимает значение invalid number of iterations.
3. Если в результате вычисления получается 0, происходит переход в Repeat End, при этом:
4. 1. значение repeat\_index не изменяется и остается равным -1 (цикл попытались запустить, но он ни разу не отработал)
2. происходит Сброс состояния цикла (см. Сброс состояния цикла)
5. Если в результате вычисления получается целое число больше 0, происходит переход в Repeat Next.
### Продолжение цикла
1. Ветка сценария Repeat Next реализует цикличный алгоритм без блокировки.
2. При попадании в Подслот Repeat Next происходит определение, куда необходимо совершить дальнейший переход, затем выполняется сам переход:
3. 1. Проверяется достижение указанного в Слоте Repeat Количество итераций цикла:\
если значение repeat\_index больше или равно числу <указанное в поле Number of iterations значение> - 1, то происходит переход в Repeat End.
2. > Пример: в поле Number of iterations указано число 10. Т.к. нумерация итераций в repeat\_index начинается с 0, то, когда repeat\_index принимает значение 9, происходит переход в Repeat End.
3. Проверяется достижение Лимит на количество итераций цикла одного слота Repeat:\
если значение repeat\_index больше или равно Лимит на количество итераций цикла одного слота Repeat:
4. 1. происходит переход в Ветка сценария Repeat Limit .
5. > Пример: Лимит на количество итераций цикла одного слота Repeat равен 500. Если значение repeat\_index равно 500 или 501, происходит переход в Repeat Limit.
4. Начало очередной итерации цикла:\
Если в предыдущих операциях не произошел выход в Подслоты Repeat Limit и Repeat End, то происходит увеличение значения на 1 и переход в Repeat Next.
5. > Пример: в поле Number of iterations указано число 10. Значение repeat\_index равно 3. В таком случае repeat\_index принимает значение 4 и происходит переход в Repeat Next.
6. Между итерациями цикла введена искусственная задержка в 0,3 секунды.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://chatme-ai-4.gitbook.io/docs/proekty-na-platforme/proekt-i-ego-soderzhimoe/agenty-na-platforme/kak-postroit-scenarii-agenta/kak-sozdavat-i-nastraivat-sloty/realizaciya-ciklov-v-scenarii-or-slot-repeat.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.