Создание пользовательского агента обработчика
В этом руководстве показано, как создать пользовательский агент обработчика с помощью набора средств Teams с OpenAI.
В этом руководстве вы узнаете:
- Создание пользовательского агента обработчика с помощью набора средств Teams.
- Взаимодействие с LLM и данными.
- Структура каталогов пользовательского агента обработчика.
Примечание.
- Поддержка агента пользовательского обработчика для Microsoft 365 Copilot Chat доступна только в общедоступной предварительной версии для разработчиков.
- Пользовательский агент обработчика не поддерживается в Python.
Предварительные условия
Убедитесь, что установлены следующие средства для создания и развертывания приложений:
| Установка | Для использования... | |
|---|---|---|
| Набор средств Teams | Расширение Microsoft Visual Studio Code, которое создает шаблон проекта для вашего приложения. Используйте последнюю версию. | |
| Node.js и NPM | Серверной среды выполнения JavaScript. Дополнительные сведения см . вNode.js таблице совместимости версий для типа проекта. | |
| Microsoft Edge (рекомендуется) или Google Chrome | Браузера со средствами разработчика. | |
| Visual Studio Code; | Сред сборки JavaScript, TypeScript или SharePoint Framework (SPFx). Используйте последнюю версию. | |
| OpenAI | Сначала создайте ключ API OpenAI, чтобы использовать GPT OpenAI. Если вы хотите разместить приложение или получить доступ к ресурсам в Microsoft Azure, перед началом работы необходимо создать службу Azure OpenAI . |
Примечание.
Добавление поддержки Microsoft 365 Copilot Chat в пользовательском агенте обработчика
Если вы хотите, чтобы агент пользовательского обработчика поддерживал Microsoft 365 Copilot Chat, необходимо установить предварительную версию набора средств Teams. После установки предварительной версии выполните следующие действия.
Убедитесь, что вы включили Fx-extension. Включите агент пользовательского обработчика в наборе средств Teams.
Выполните шаг 1. для шага 4. создайте агент пользовательского обработчика и убедитесь, что вы выбрали базовый чат-бот ИИ работает в Teams и Microsoft 365 Copilot для шага 5. в наборе средств Teams. Перейдите к остальным шагам (шаг 6. шаг 11.), чтобы создать пользовательский агент обработчика.
Настройте пользовательский агент обработчика. Перед отладкой выполните следующие действия.
Убедитесь, что манифест приложения содержит
copilotAgentsи его вложенное свойствоcustomEngineAgents:"copilotAgents": { "customEngineAgents": [ { "type": "bot", "id": "<Bot-Id-Guid>" } ] }Убедитесь, что
scopesзадано значениеpersonalдляbotsиcommandLists:"bots": [ { "botId": "<Bot-Id-Guid>", "scopes": [ "personal", "team", "groupChat" ], "commandLists": [ { "scopes": ["personal"], "commands": [ { "title": "Sample prompt title", "description": "Description of sample prompt" } ] }, { "scopes": ["personal"], "commands": [ { "title": "Sample prompt title", "description": "Description of sample prompt" } ] } ], } ],
Создание пользовательского агента обработчика
Создание пользовательского агента обработчика с помощью набора средств Teams
Перейдите к Visual Studio Code.
Щелкните значок Набора средств
Teams на панели действий Visual Studio Code.Выберите Создать новое приложение.
Выберите Агент пользовательского обработчика.
Выберите Базовый чат-бот ИИ.
Выберите JavaScript в качестве языка.
Выберите OpenAI.
Введите Ключ OpenAI.
Выберите Папка по умолчанию , чтобы сохранить корневую папку проекта в расположении по умолчанию.
Вы также можете изменить расположение по умолчанию, выполнив следующие действия.
Нажмите кнопку Обзор.
Выберите расположение рабочей области проекта.
Выберите выбрать папку.
Введите подходящее имя для приложения и нажмите клавишу ВВОД.
Откроется диалоговое окно. Выберите Да, я доверяю авторам или Нет, я не доверяю авторам на основе ваших требований.
Пользовательский агент обработчика будет создан через несколько секунд.
После создания приложения набор средств Teams отображает следующее сообщение:
Знакомство с исходным кодом
Ознакомьтесь с тем, что находится в этом шаблоне чат-бота пользовательского агента пользовательского обработчика > .
| Имя папки | Содержание |
|---|---|
.vscode |
Файлы VS Code для отладки. |
appPackage |
Шаблоны для манифеста приложения Teams. |
env |
Пары имен или значений хранятся в файлах среды и используются teamsapp.yml для настройки правил подготовки и развертывания. |
infra |
Шаблоны для подготовки ресурсов Azure. |
src/ |
Исходный код для приложения Teams для уведомлений. |
src/index.js |
Настройка сервера приложений бота. |
src/adapter.js |
Настраивает адаптер бота. |
src/config.js |
Определяет переменные среды. |
src/prompts/chat/skprompt.txt |
Определяет запрос. |
src/prompts/chat/config.json |
Настраивает запрос. |
src/app/app.js |
Обрабатывает бизнес-логику для чат-бота Basic AI. |
teamsapp.yml |
Основной файл проекта описывает конфигурацию приложения и определяет набор действий, выполняемых на каждом этапе жизненного цикла. |
teamsapp.local.yml |
Это переопределяется teamsapp.yml действиями, которые обеспечивают локальное выполнение и отладку. |
teamsapp.testtool.yml |
Это переопределит teamsapp.yml действиями, которые обеспечивают локальное выполнение и отладку в средстве тестирования приложений Teams. |
Настройка пользовательского агента обработчика
После создания пользовательского агента обработчика давайте настроим его.
Настройка и отладка пользовательского агента обработчика
Давайте настроим запрос для пользовательского агента обработчика.
Перейдите к
src/prompts/chat/skprompt.txtи обновите следующий код вskprompt.txtфайле:The following is a conversation with an AI assistant, who is an expert on answering questions over the given context. Responses should be in a short journalistic style with no more than 80 words.
В левой области выберите Выполнить и отладить (CTRL+SHIFT+D).
Выберите Отладка в средстве тестирования (предварительная версия).
Примечание.
Если вы хотите выполнить отладку в Teams или Copilot, выберите "Отладка в Teams " или "Отладка в Copilot".
Выберите клавишу F5 .
Агент пользовательского обработчика запускается в средстве тестирования приложений Teams, которое открывается в браузере.
Выполнение задачи
В средстве тестирования приложений Teams задавайте вопросы, связанные с документом, и общайтесь с агентом пользовательского обработчика, чтобы узнать больше о данных.
Поздравляем!
Поздравляем, вы завершили работу с этим руководством!
Возникла проблема с этим разделом? Если это так, отправьте нам отзыв, чтобы мы исправили этот раздел.
Platform Docs