Добавление события-триггера

Note

Функции, описанные в этой статье, питаются стандартным жгутом, который использует опции выставления счетов, описанные в разделе «Лицензирование для агентов, работающих на стандартном жгуте». Узнайте, как получить доступ к стандартным функциям в стандартных агентах и потоках агентов доступа.

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

Important

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

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

Note

Эта функция доступна только для агентов с включенной генеративной оркестрацией.

Чтобы добавить триггер события в агент:

1. На странице Обзор для агента перейдите в раздел Триггеры.

2. Выберите " Добавить триггер".

3. Выберите требуемый триггер.

4. При необходимости предоставьте данные для аутентификации.

5. Нажмите кнопку Далее.

   Note

   Вы можете аутентифицировать соединители триггеров только с использованием учетной записи создателя агента (аутентификация автора агента). Создатель агента может установить триггер для вашего агента только на основе событий в системах, доступ к которым у вас есть как у автора агента. Для получения дополнительной информации см. ограничения триггеров событий.

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

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

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

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

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

1. Запустите событие триггера один раз, чтобы сгенерировать полезные данные. Например, при использовании триггера Планировщика (Майкрософт) Когда мне назначается новая задача для Планировщика (Майкрософт), назначьте себе тестовое задание в Планировщике (Майкрософт), чтобы активировать триггер.

2. Выберите значок Тестировать триггер рядом с триггером на страницеОбзор агента. Список включает в себя все недавние экземпляры события.

3. Выберите экземпляр, который хотите протестировать, и выберите Начать тестирование.

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

Изменение триггера

После создания триггера вы можете изменить параметры и полезные данные события через Power Automate. Чтобы открыть триггер из Copilot Studio:

1. На странице Обзор найдите триггер.

2. Выберите три точки (…), затем выберите Изменить в Power Automate.

3. Выберите триггер, затем перейдите на вкладки Параметры и Код, чтобы внести изменения. Информацию о том, какие переменные и строковые операторы можно добавлять, см. на вкладке О программе.

4. Внесите изменения и сохраните их. Подробнее о том, как вносить изменения в Power Automate, см. в разделе Начало работы с триггерами в Power Automate.

Публикация агента с триггером

Перед публикацией агента с триггерами событий вы получите предупреждение о том, что агент использует учетные данные автора. Триггеры событий могут использовать для проверки подлинности только учетные данные автора агента (то есть учетные данные, которые вы использовали для авторизации подключений). Это может позволить пользователям агента без собственной авторизации получить доступ к данным и системам, к которым у них не должно быть доступа. Дополнительные сведения см. в разделе Рекомендации по защите данных для триггеров.

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