Преобразование типов (Type Convert)
Описание
Компонент Type Convert выполняет роль универсального адаптера, который обеспечивает трансформацию данных из одного формата в другой.
Использование данного модуля является необходимым условием для достижения технической совместимости между узлами потока в ситуациях, когда тип данных на выходе одного компонента не совпадает с требованиями входного порта следующего элемента.
Поддерживаемые типы данных
Система AI Server оперирует тремя основными структурами данных:
- Data: Структурированный объект (
JSON), содержащий основной текстовый ключ (по умолчаниюtext) и дополнительные пары ключ-значение. - DataFrame: Табличная структура данных (массив строк и столбцов). Используется для результатов поиска, баз данных и аналитических выгрузок.
- Message: Формат текстового сообщения, используемый для общения с LLM и вывода в чат. Содержит текст и метаданные (отправитель, сессия).
Применение в потоке
Компонент Type Convert обычно используется для преобразования данных в формат, необходимый для следующего компонента в цепочке.
Например, если один компонент выдает сообщение (Message), а следующему требуются данные (Data), вы можете использовать Type Convert для смены формата перед передачей данных дальше.
Пример использования: Подготовка данных поиска для LLM
В этом примере мы преобразуем таблицу (DataFrame) из результатов поиска в сообщение (Message), которое LLM сможет использовать как контекст:
- Создайте поток на основе шаблона Basic prompting.
- Добавьте Web Search и установите поисковый запрос, например:
environmental news(новости экологии). - Настройте Prompt Template: Замените текст в поле Template на следующий:
Answer the user’s question using the{context}
Фигурные скобки создают переменнуюcontext, которая станет входным полем для передачи данных в промпт. - Добавьте Type Convert и установите параметр Output Type в значение
Message. Поскольку выход DataFrame от поиска несовместим напрямую с входомMessageпромпта, этот шаг необходим для корректной передачи результатов. - Соедините компоненты:
- Выход Web Search → Вход Type Convert.
- Выход Type Convert → Вход
contextкомпонента Prompt Template.

- Настройте модель: Введите ваш API-ключ в компоненте Language Model.
- Протестируйте: Откройте Playground и задайте вопрос, например: «Какие последние новости экологии?».
Результат: Языковая модель использует результаты поиска, ваше сообщение и свои знания, чтобы дать актуальный ответ.
Например:
*Here are some of the latest news articles related to the environment:*
*Ozone Pollution and Global Warming: A recent study highlights that ozone pollution is a significant global environmental concern, threatening human health and crop production while exacerbating global warming.* Параметры
| Имя (Name) | Отображаемое имя | Информация |
|---|---|---|
input_data | Input Data | Входной параметр. Данные для конвертации. Принимает форматы Data, DataFrame или Message. |
output_type | Output Type | Входной параметр. Желаемый тип данных на выходе: Data, DataFrame или Message. |
output | Output | Выходной параметр. Преобразованные данные. Порт вывода меняется в зависимости от выбранного Output Type. |