Быстрый старт

В этой статье вы узнаете, как использовать триггеры, AI-агента и функции в Agent Platform.

Бета

Платформа Agent Platform выпущена в бета-версии. Интерфейс и функции могут меняться, мы будем регулярно обновлять эту статью.

В качестве примера мы создадим процесс для работы с новостями про космос. Процесс позволит:

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

Чтобы начать работу:

1. Создайте проект.
2. Настройте поиск статей через AI-агента.
3. Настройте регулярную отправку последних новостей в чат.

Шаг 1. Создание проекта

1. Зарегистрируйтесь в Agent Platform.

   к сведению

   Agent Platform и Conversational Cloud используют общую базу аккаунтов, поэтому если вы зарегистрированы в Conversational Cloud, дополнительно регистрироваться в Agent Platform не нужно.

2. На странице Проекты нажмите Создать AI-приложение.

3. Выберите шаблон Пустой проект и укажите название.

   подсказка

   Вы также можете создать проект на основе шаблона Быстрый старт. Он уже содержит полностью готовый процесс из этой статьи.

4. Нажмите Создать. Вы сразу перейдете внутрь проекта.

Шаг 2. Поиск статей через AI-агента

Триггер по новому сообщению

Триггер

1. На левой панели нажмите , чтобы открыть конструктор процессов.

2. В верхнем левом углу нажмите , чтобы открыть список блоков.

   Далее раскройте раздел Триггеры:

   

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

   

Функция для агента

Пользовательская функция

Инструмент

Добавьте новую функцию:

1. В списке блоков откройте раздел Функции.
2. Нажмите справа от раздела Пользовательские.
3. В открывшемся окне выберите, куда сохранить новую функцию — Новая коллекция и нажмите Далее.
4. Укажите информацию о коллекции:
   • Название: Новости про космос.
   • Идентификатор SpaceArticles.
   • Описание: Коллекция функций для работы с новостями про космос.
5. Нажмите Добавить.
6. В открывшемся окне укажите информацию о новой функции:
   • Название: Найти статьи.
   • Идентификатор: searchArticles.
   • Описание: Найти последние статьи по нужной теме. По описанию агент будет понимать, что делает функция.
7. Нажмите Сохранить.

Настройте функцию:

1. Перетащите новую функцию Найти статьи из раздела Функции → Пользовательские → Новости про космос на холст.

2. На холсте нажмите на блок этой функции, чтобы открыть ее настройки.

3. Нажмите Посмотреть код. В открывшемся окне вы сможете настроить параметры функции и написать ее код.

4. Нажмите Добавить в секции Параметры и выберите string. Далее:

   • В поле Название укажите название параметра, например query.
   • В поле Описание введите Термин на английском языке, по которому нужно найти статьи. По этому описанию агент будет понимать, что нужно передать в параметр.

5. В секции Поля ответа в поле Описание укажите Данные статей.

6. Перейдите на вкладку Код и введите тело функции на языке JavaScript:

   // Отправляем запрос, чтобы получить статьи по термину
   return Http.get({
     url: "https://api.spaceflightnewsapi.net/v4/articles/",
     params: {
       // Передаем в API-запрос параметр query
       search: query,
       ordering: "-published_at"
     },
     headers: {}
   })
     .then(function (response) {
       var body = typeof response.body === "string" ? JSON.parse(response.body) : response.body;
   
       // Сохраняем нужные данные о статьях
       var articles = (body.results || []).map(function (a) {
         return {
           title: a.title,
           summary: a.summary,
           url: a.url,
           publishedAt: a.published_at
         };
       });
   
       // Если статей нет
       if (articles.length === 0) {
         return "No data";
       }
   
       return JSON.stringify(articles);
     })
     .catch(function (err) {
       return "Error fetching articles: " + err;
     });

   Функция получает релевантные статьи из Spaceflight News API и возвращает их данные.

7. Нажмите Сохранить.

Далее переведите функцию в режим инструмента, чтобы AI-агент мог ее использовать:

1. В окне настроек включите Режим инструмента и у параметра query включите опцию Заполнит агент.
2. Нажмите Сохранить.

Теперь на холсте есть два блока:

Создание AI-агента

Агент

Добавьте агента:

1. Перетащите блок Агенты → Агент на холст.

2. На холсте нажмите на блок агента.

3. Раскройте панель Основные:

   1. В поле LLM выберите Добавить новую интеграцию.
   2. В поле Доступ к LLM выберите Через Just AI.
   3. В поле Провайдер выберите OPEN_AI, а в поле Модель — gpt-4.1.

4. Раскройте панель Промты:

   • Роль: Помощник.

   • Цель: Выполни задание, которое тебе дал пользователь.

   • Инструкции:

     Если пользователь просит найти новости:
     1. Вызови функцию searchArticles и передай термин на английском языке в качестве параметра.
     2. Когда получишь новости, составь один абзац текста со всей информацией.
     3. Переведи на русский язык, подпиши, за какой период новости, и приложи список ссылок.
     4. Отправь пользователю.
     
     Если пользователь просит краткий обзор новостей за последнее время:
     1. Проанализируй последние сообщения в чате.
     2. Составь один абзац текста с основными событиями, переведи на русский язык. Ссылки и даты не включай.
     3. Отправь пользователю.

5. Нажмите Сохранить вверху окна настроек.

Далее соедините триггер Сообщение с агентом, а функцию Найти статьи присоедините к агенту как инструмент.

подсказка

Чтобы удалить связь между блоками, нажмите на связь и затем нажмите Delete или Backspace.

Тестирование

Вы можете протестировать процесс в тестовом виджете. Нажмите Тестировать в правом верхнем углу редактора.

При открытии виджета отправляется системное сообщение — агент сразу среагирует на него и напишет приветствие в чат.

Пример диалога:

1. 🤖 Ассистент:

   Здравствуйте! Я ваш помощник. Чем могу помочь вам сегодня?

2. 👤 Пользователь:

   Может есть что интересное про Марс?

3. 🤖 Ассистент:

   Вот последние интересные новости о Марсе за август 2025 года:

   В начале августа марсоход Curiosity продолжил исследование уникальных структур на Марсе, известных как «boxwork» — это сложные рельефы, которые могут дать новые данные о геологической истории планеты. Команда марсохода подробно изучила так называемые «peace sign» гребни, чтобы узнать больше о процессах формирования этих структур. Кроме того, NASA активно использует марсоход Perseverance для создания панорам и изучения атмосферы Марса, а Европейское космическое агентство разрабатывает новые технологии для будущих марсианских миссий. Важными остаются также международные планы по отправке новых аппаратных комплексов для поиска признаков жизни и исследования климата на Марсе.

   Ссылки на источники:

   • https://science.nasa.gov/blog/curiosity-blog-sols-4624-4626-a-busy-weekend-at-the-boxwork/
   • https://www.nasa.gov/missions/mars-2020-perseverance/perseverance-rover/nasas-perseverance-rover-captures-mars-vista-as-clear-as-day/
   • https://europeanspaceflight.com/esa-to-develop-hummingbird-inspired-flying-mars-explorer/
   • https://europeanspaceflight.com/italy-signs-agreement-with-spacex-for-starship-mars-mission/

Шаг 3. Регулярная отправка новостей в чат

Расписание и вебхук

Триггеры

Добавьте блок Планировщик:

1. Перейдите к блоку Триггеры → Планировщик и перетащите его на холст.
2. На холсте нажмите на блок.
3. В поле Cron-выражение в формате Quartz введите 0 0 9 * * ?, чтобы запускать процесс каждый день в 9:00 UTC.
4. Нажмите Сохранить.

Далее добавьте блок Вебхук — перейдите в раздел Триггеры и перетащите этот блок на холст. Когда GET-запрос приходит на адрес вебхука, триггер срабатывает и запускает процесс. Это позволяет внешним системам запускать процесс, например, при наступлении какого-то события.

Получение новостей

Пользовательская функция

Добавьте новую функцию:

1. В списке блоков выберите Функции.
2. Нажмите справа от раздела Пользовательские.
3. Выберите коллекцию Новости про космос и нажмите Далее.
4. В открывшемся окне укажите информацию о новой функции:
   • Название: Сделать пост.
   • Идентификатор: sendNews.
   • Описание: Получить последние новости и составить пост. По описанию агент будет понимать, что делает функция.
5. Нажмите Сохранить.

Настройте функцию:

1. Перетащите новую функцию Сделать пост из раздела Функции → Пользовательские → Новости про космос на холст.

2. На холсте нажмите на блок этой функции, чтобы открыть ее настройки.

3. Нажмите Посмотреть код. В открывшемся окне вы сможете настроить параметры функции и написать ее код.

4. Функция не имеет параметров, поэтому оставьте их пустыми.

5. В секции Поля ответа в поле Описание укажите Текст поста.

6. Перейдите на вкладку Код и введите тело функции:

   // Получаем дату и время, которые были день назад в формате ISO
   var oneDayAgoISO = new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString();
   
   // Отправляем запрос, чтобы получить статьи, опубликованные за последний день
   return Http.get({
     url: "https://api.spaceflightnewsapi.net/v4/articles/",
     params: {
       published_at_gte: oneDayAgoISO,
       ordering: "-published_at"
     },
     headers: {}
   })
     .then(function (response) {
       var body = typeof response.body === "string" ? JSON.parse(response.body) : response.body;
   
       var articles = (body.results || []).map(function (a) {
         return {
           title: a.title,
           url: a.url,
           publishedAt: a.published_at
         };
       });
   
       // Если статей нет
       if (articles.length === 0) {
         return "☁️ Сегодня ничего нового";
       }
   
       // Формируем текст поста
       var postText = "🛰️ Статьи про космос за день:\n\n" +
         articles.map(function (a) {
           return "**" + a.title + "**\n" +
             "🔗 " + a.url + "\n" +
             "🗓 " + new Date(a.publishedAt).toUTCString();
         }).join("\n\n");
   
       return postText;
     })
     .catch(function (err) {
       return "Произошла ошибка: " + err;
     });

   Функция получает новости про космос за день из Spaceflight News API и возвращает текст поста.

7. Нажмите Сохранить в окне редактирования и далее еще раз Сохранить в окне настроек функции.

Далее перетащите новую функцию из списка блоков на холст и соедините ее с триггерами.

Перевод новостей и отправка сообщения

Встроенные функции

Функция sendNews получает заголовки статей на английском языке. Добавьте запрос к LLM, чтобы перевести текст на русский язык:

1. В списке блоков откройте раздел Функции → Встроенные → Llm и перетащите функцию sendText на холст.

2. На холсте нажмите на блок этой функции.

3. В параметре LLM выберите OPEN_AI — gpt-4.1.

4. В параметре text введите {{"Переведи пост полностью на русский язык, верни только перевод в ответе: " + Context.getLastFunctionResult()}}.

   подсказка

   Встроенная функция Context.getLastFunctionResult() возвращает результат последней выполненной функции. В данном случае это текст сообщения с новостями, который формируется в sendNews.

   {{}} используется для подстановки JavaScript-выражений в параметры функций.

5. Нажмите Сохранить и соедините Сделать пост с Llm.sendText, чтобы эти функции выполнялись последовательно:

   

Добавьте функцию для отправки сообщения в чат:

1. В списке блоков откройте раздел Функции → Встроенные → Reactions и перетащите функцию sendText на холст.
2. На холсте нажмите на блок этой функции.
3. В параметре text введите {{Context.getLastFunctionResult()}} и нажмите Сохранить.
4. Соедините эту функцию с Llm.sendText.

В итоге три функции будут выполняться последовательно:

Тестирование

1. Нажмите Тестировать в правом верхнем углу редактора.

2. При открытии виджета отправляется системное сообщение — агент сразу среагирует на него и напишет приветствие в чат:

   Здравствуйте! Я ваш помощник. Чем могу помочь вам сегодня?

3. Чтобы не ждать запуска по расписанию, вызовите вручную вебхук:

   1. На холсте нажмите на блок Вебхук.
   2. Скопируйте URL из поля URL для запуска триггера.
   3. Откройте в браузере скопированный URL. Это отправит GET-запрос на адрес вебхука и запустит триггер.

4. В чате появится сообщение с последними новостями про космос:

   🛰️ Статьи про космос за день:

   Взгляд на рождение звёзд с телескопа «Джеймс Уэбб» от NASA 🔗 https://science.nasa.gov/missions/webb/glittering-glimpse-of-star-birth-from-nasas-webb-telescope/ 🗓 Чт, 04 сен 2025 14:00:00 GMT

   Офицер NASA помогает осуществить возвращение на Луну 🔗 https://www.nasa.gov/image-article/co-patricia-white-helps-moon-journey/ 🗓 Чт, 04 сен 2025 14:00:00 GMT

   …

5. Попросите агента составить краткий обзор последних новостей:

   Напиши краткий обзор новостей за последний день

6. Агент ответит:

   Вот краткий обзор главных новостей за последний день:

   За последний день в космической отрасли произошло несколько значимых событий. Телескоп Джеймс Уэбб предоставил впечатляющие изображения рождения звёзд, а NASA активно готовится к возвращению на Луну — среди прочего, контрактный офицер агентства помогает реализовать лунные миссии. Также стало известно название новой дочерней миссии Galileo — Celeste. В области технологий NASA Glenn тестирует мини-рентген для медицины будущих полётов.

7. Агент по умолчанию видит последние 50 сообщений в чате. Попросите агента составить краткий обзор по всем доступным сообщениям в чате:

   Что самое интересное ты писал в чат за всё время?

8. Агент ответит:

   За всё время в чате я писал о ключевых событиях в космической сфере: соперничестве США и Китая за первенство в возвращении человека на Луну, дискуссиях вокруг отмены лунных программ SLS и Lunar Gateway, а также кадровых перестановках в NASA. Я делал обзоры о новых технологиях — от испытаний возвращаемых капсул и спутников до медицинских инноваций для космоса и новых материалов для марсианских миссий. Также рассказывал о научных открытиях: телескоп Джеймс Уэбб предоставил уникальные изображения рождения звёзд, а учёные наблюдали редкие типы чёрных дыр и запускали новые миссии по их изучению.

Полный процесс

Дальнейшие шаги

Подключите канал к процессу. Например, вы можете опубликовать процесс в Telegram-боте.