Когда следует использовать подключаемые модули API
С помощью подключаемых модулей API можно разрешить декларативному агенту взаимодействовать с API для чтения и изменения внешних данных. Узнайте, как решить, когда использовать подключаемые модули API для расширения декларативного агента.
Критерии принятия решений
Подключаемые модули API предоставляют мощные возможности интеграции для декларативных агентов. Следующие критерии помогут вам решить, подходят ли подключаемые модули API для вашего сценария.
Данные за пределами базовой модели
Первое, что необходимо понять, может ли агент соответствовать вашим требованиям, используя только информацию из своей базовой модели. Если ему требуется доступ к дополнительным сведениям, таким как внутренние базы данных, необходимо расширить его, например, подключаемым модулем API.
Фигура данных
Следующее, что необходимо понимать, — это форма данных, к которым агент должен получить доступ. Структурированы ли данные, такие как записи клиентов или заказы, или они неструктуризированы, как документ или отчет? Если данные структурированы, это хорошо подходит для использования с подключаемым модулем API. Если он неструктурирован, есть ли у вас индекс поиска и API, которые может использовать агент? В противном случае можно использовать соединитель Copilot для приема данных в Microsoft 365 и воспользоваться его возможностями поиска.
Доступ к данным
Последнее, что определяет решение об использовании подключаемого модуля API и количество затраченных усилий, — возможность доступа подключаемого модуля к данным. У вас есть API, к которому агент может подключиться? У вас есть спецификация OpenAPI, описывающая API? Использует ли API механизм проверки подлинности, который может обрабатывать агент? Прост ли API для понимания или использования или он использует сложные запросы, которые не удалось выполнить языковой модели?
Применение условий
Подключаемые модули API лучше всего работают, когда необходимо подключить декларативный агент к структурированным и часто меняющимся данным за пределами базовой модели. Так как в этом решении есть нюансы, давайте подумаем о том, как применить эти критерии к нашему примеру сценария.
- Требуется ли агенту доступ к данным за пределами базовой модели? Да. Сведения о ремонте не входят в базовую модель агента. Вместо этого информация хранится в базе данных и предоставляется через API, поэтому использование подключаемого модуля API является хорошим способом предоставления агенту доступа к этой информации.
- Структурирована ли информация? Да. Сведения о восстановлении — это структурированные данные, предоставляемые через API. Так как он не требует дополнительной обработки, он подходит для использования подключаемым модулем API.
- Предоставляется ли информация через API, доступная через Интернет? Да. Сведения о восстановлении предоставляются через API. Api доступен через Интернет и защищен с помощью ключа API, что означает, что агент может безопасно взаимодействовать с ним.
Декларативный агент с подключаемым модулем API представляется хорошим решением для нашего сценария. Он соответствует всем нашим требованиям и даже предлагает нам возможность расширить помощник в будущем, чтобы позволить пользователям изменять информацию о ремонте.
Сводка инструкций
На следующей блок-схеме приведены ключевые вопросы, которые следует задать, когда вы планируете расширить декларативный агент с помощью подключаемого модуля API.
