Поделиться через

Краткое руководство по началу работы с библиотекой ИИ Teams

  • Статья

Начните работу с библиотекой ИИ Teams с помощью примера LightBot, который поможет вам в создании приложений, которые могут управлять индикаторами, например включать и выключать их с помощью библиотеки ИИ Teams. Бот использует модель gpt-3.5-turbo, чтобы общаться с пользователями Microsoft Teams и реагировать вежливо и уважительно, оставаясь в область беседы.

Предварительные условия

Чтобы приступить к работе, убедитесь, что у вас есть следующие средства:

Установка Для использования...
Visual Studio Code Среды сборки JavaScript, TypeScript и Python. Используйте последнюю версию.
Набор средств Teams Расширение Microsoft Visual Studio Code, которое создает шаблон проекта для вашего приложения. Используйте последнюю версию.
Git Git — это система управления версиями, которая помогает управлять различными версиями кода в репозитории.
Node.js Серверной среды выполнения JavaScript. Дополнительные сведения см . вNode.js таблице совместимости версий для типа проекта.
Microsoft Teams Для совместной работы со всеми пользователями вы работаете с ними с помощью приложений для чата, собраний и звонков в одном месте.
OpenAI или Azure OpenAI Сначала создайте ключ API OpenAI, чтобы использовать GPT OpenAI. Если вы хотите разместить приложение или получить доступ к ресурсам в Microsoft Azure, необходимо создать службу Azure OpenAI.
Microsoft Edge (рекомендуется) или Google Chrome Браузера со средствами разработчика.
Учетная запись разработчика Microsoft 365 Доступ к учетной записи Teams с соответствующими разрешениями для установки приложения, включения пользовательских приложений Teams и включения отправки пользовательских приложений.

Если вы уже выполняли примеры ранее или столкнулись с ошибкой среды выполнения, выполните следующие действия, чтобы начать заново:
  • Проверьте все .env файлы и env/.env.*.* в примере и удалите автоматически заполненные значения, чтобы убедиться, что Набор средств Teams создает новые ресурсы.
  • Если вы не хотите, чтобы Teams Toolkit создавал идентификатор и пароль приложения, обновите BOT_ID и BOT_PASSWORD в .env файле своими собственными значениями.
  • Удалите значения или оставьте их пустыми для SECRET_BOT_PASSWORD и TEAMS_APP_UPDATE_TIME в .env файле, чтобы избежать конфликтов.

Набор средств Teams автоматически подготавливает ресурсы и BOT_PASSWORD ресурсыBOT_ID. Если вы хотите использовать собственные ресурсы, необходимо вручную добавить их в .env файл. Набор средств Teams не создает следующие ресурсы автоматически:

  • Ключ Azure OpenAI или OpenAI
  • База данных или аналогичные варианты хранения

Создание и запуск примера приложения

Начало работы с библиотекой ИИ Teams с помощью примера LightBot. Это позволяет локальному хосту компьютера быстро выполнить пример на основе библиотеки ИИ Teams.

  1. Перейдите к примеру.

  2. Выполните следующую команду, чтобы клонировать репозиторий:

    git clone https://github.com/microsoft/teams-ai.git

  3. Перейдите к Visual Studio Code.

  4. Выберите Файл>Открыть папку.

  5. Перейдите в расположение, в котором вы клонировали репозиторий teams-ai, и выберите папку teams-ai .

  6. Выберите Выбрать папку.

    Снимок экрана: папка teams-ai и параметр Выбрать папку.

  7. Выберите Просмотреть>терминал. Откроется окно терминала.

  8. В окне терминала выполните следующую команду, чтобы перейти в папку js :

    cd .\js\

  9. Выполните следующую команду, чтобы установить зависимости:

    yarn install

  10. Выполните следующую команду, чтобы создать зависимости:

    yarn build

  11. После установки зависимостей выберите Файл>Открыть папку.

  12. Перейдите в teams-ai > js > samples> 03.ai-concepts> c.actionMapping-lightBot и выберите Выбрать папку. Все файлы для примера LightBot перечислены в разделе EXPLORER Visual Studio Code.

  13. Обновите следующие шаги на основе выбранной службы ИИ.

    1. Перейдите в папку env и обновите следующий код в ./env/.env.local.user файле:

       SECRET_OPENAI_KEY=<your OpenAI key>

    2. Перейдите в папку infra и убедитесь, что следующие строки в azure.bicep файле закомментированы:

          // {
    //   name: 'AZURE_OPENAI_KEY'
    //   value: azureOpenAIKey
    // }
    // {
    //   name: 'AZURE_OPENAI_ENDPOINT'
    //   value: azureOpenAIEndpoint
    // }

  14. В левой области выберите Набор средств Teams.

  15. В разделе УЧЕТНЫЕ ЗАПИСИ войдите в следующую команду:

    • Учетная запись Microsoft 365
    • Учетная запись Azure

  16. Чтобы отладить приложение, выберите F5.

    Вкладка браузера открывает веб-клиент Teams, чтобы добавить бота в клиент.

  17. Нажмите Добавить.

    Снимок экрана: диалоговое окно сведений о приложении для добавления приложения LightBot.

    При добавлении приложения появляется диалоговое окно для выбора необходимого область.

  18. Выберите Открыть, чтобы открыть приложение в личных область.

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

    Снимок экрана: диалоговое окно выбора область со списком общих областей.

    Откроется окно чата.

  19. В области создания сообщения отправьте сообщение для вызова бота.

    Снимок экрана: пример выходных данных LightBot.

Примечание.

Если вы создаете бот впервые, рекомендуется использовать расширение Teams Toolkit для Visual Studio Code для создания бота. См. статью Создание первого приложения бота с помощью JavaScript.

Предварительные условия

Чтобы приступить к работе, убедитесь, что у вас есть следующие средства:

Установка Для использования...
Visual Studio Среды сборки C Sharp. Используйте последнюю версию.
Набор средств Teams Расширение Microsoft Visual Studio Code, которое создает шаблон проекта для вашего приложения. Используйте последнюю версию.
Git Git — это система управления версиями, которая помогает управлять различными версиями кода в репозитории.
Microsoft Teams Для совместной работы со всеми пользователями вы работаете с ними через приложения для чатов, собраний и звонков в одном месте.
OpenAI или Azure OpenAI Сначала создайте ключ API OpenAI, чтобы использовать GPT OpenAI. Если вы хотите разместить приложение или получить доступ к ресурсам в Microsoft Azure, необходимо создать службу Azure OpenAI.
Microsoft Edge (рекомендуется) или Google Chrome Браузера со средствами разработчика.
Учетная запись разработчика Microsoft 365 Доступ к учетной записи Teams с соответствующими разрешениями для установки приложения, включения пользовательских приложений Teams и включения отправки пользовательских приложений.

Если вы уже выполняли примеры ранее или столкнулись с ошибкой среды выполнения, выполните следующие действия, чтобы начать заново:
  • Проверьте все .env файлы и env/.env.*.* в примере и удалите автоматически заполненные значения, чтобы убедиться, что Набор средств Teams создает новые ресурсы.
  • Если вы не хотите, чтобы Teams Toolkit создавал идентификатор и пароль приложения, обновите MicrosoftAppId и MicrosoftAppPassword в .env файле своими собственными значениями.
  • Удалите значения или оставьте их пустыми для SECRET_BOT_PASSWORD и TEAMS_APP_UPDATE_TIME в .env файле, чтобы избежать конфликтов.

Набор средств Teams автоматически подготавливает ресурсы и MicrosoftAppPassword ресурсыMicrosoftAppId. Если вы хотите использовать собственные ресурсы, необходимо вручную добавить их в .env файл. Набор средств Teams не создает следующие ресурсы автоматически:

  • Ключ Azure OpenAI или OpenAI
  • База данных или аналогичные варианты хранения

Создание и запуск примера приложения

  1. Перейдите к примеру.

  2. Клонируйте репозиторий, чтобы протестировать пример приложения.

    git clone https://github.com/microsoft/teams-ai.git

  3. Перейдите в папку dotnet .

    cd teams-ai/dotnet

  4. Перейдите в папку, в которой вы клонировали репозиторий, и выберите 04.ai.c.actionMapping.lightBot.

  5. Выберите LightBot.sln. Решение откроется в Visual Studio.

  6. В Visual Studio обновите параметры, связанные с OpenAI, в appsettings.Development.json файле.

    "Azure": {
"OpenAIApiKey": "<your-azure-openai-api-key>",
"OpenAIEndpoint": "<your-azure-openai-endpoint>"
},

  7. Перейдите к Prompts/sequence/skprompt.txt и обновите следующий код в skprompt.txt файле:

    The following is a conversation with an AI assistant. 
The assistant can turn a light on or off.
The assistant must return the following JSON structure:

{"type":"plan","commands":[{"type":"DO","action":"<name>","entities":{"<name>":<value>}},{"type":"SAY","response":"<response>"}]}

The following actions are supported:

- LightsOn
- LightsOff
- Pause time=<duration in ms>
- LightStatus

The lights are currently {{getLightStatus}}.

Always respond in the form of a JSON based plan. Stick with DO/SAY.

  8. В раскрывающемся меню отладки выберите Dev Tunnels>Create a Tunnel...

    Снимок экрана: пример параметра Dev Tunnel и Create a Tunnel в Visual Studio.

  9. Выберите учетную запись для создания туннеля. Поддерживаются учетные записи Azure, учетной записи Майкрософт (MSA) и GitHub. Обновите следующие параметры:

    1. Имя. Введите имя туннеля.
    2. Тип туннеля: выберите Постоянный или Временный.
    3. Доступ: выберите Общедоступный.
    4. Нажмите OK. Visual Studio отображает сообщение с подтверждением создания туннеля.

    Созданный туннель отображается в разделе Dev Tunnels > (имя туннеля).

  10. Перейдите в Обозреватель решений и выберите свой проект.

  11. Щелкните правой кнопкой мыши меню и выберите Teams Toolkit>Prepare Teams App Dependencies (Подготовка зависимостей приложений Teams).

    Снимок экрана: пример параметра

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

  12. Нажмите OK.

  13. Нажмите клавишу F5 или выберите Отладка>Начать.

  14. Нажмите кнопку Добавить , чтобы добавить бота в клиент.

    Снимок экрана: диалоговое окно сведений о приложении для добавления приложения LightBot.

    При добавлении приложения появляется диалоговое окно для выбора необходимого область.

  15. Выберите Открыть, чтобы открыть приложение в личных область.

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

    Снимок экрана: диалоговое окно выбора область со списком общих областей.

    Откроется окно чата.

  16. В области создания сообщения отправьте сообщение для вызова бота.

    Снимок экрана: пример выходных данных LightBot.

Вы также можете развернуть примеры в Azure с помощью набора средств Teams. Чтобы развернуть, выполните следующие действия.

  1. В Visual Studio перейдите к Обозреватель решений и выберите свой проект.
  2. Щелкните правой кнопкой мыши меню и выберитеTeams Toolkit Provision (Подготовканабора средств> Teams) в облаке. Набор средств подготавливает пример в Azure.
  3. Щелкните правой кнопкой мыши меню и выберитеTeams Toolkit Deploy to the Cloud (Развернутьнабор средств> Teams в облаке).

Предварительные условия

Чтобы приступить к работе, убедитесь, что у вас есть следующие средства:

Установка Для использования...
Visual Studio Code Среды сборки JavaScript, TypeScript и Python. Используйте последнюю версию.
Набор средств Teams Расширение Microsoft Visual Studio Code, которое создает шаблон проекта для вашего приложения. Используйте последнюю версию.
Python Python — это интерпретируемый и объектно-ориентированный язык программирования с динамической семантикой. Используйте версии от 3.8 до 4.0.
Поэзия Средство управления зависимостями и упаковки для Python.
Расширение VSCode для Python Обеспечивает расширенную поддержку Python в VSCode.
Git Git — это система управления версиями, которая помогает управлять различными версиями кода в репозитории.
Microsoft Teams Для совместной работы со всеми пользователями вы работаете с ними через приложения для чатов, собраний и звонков в одном месте.
OpenAI или Azure OpenAI Сначала создайте ключ API OpenAI, чтобы использовать GPT OpenAI. Если вы хотите разместить приложение или получить доступ к ресурсам в Microsoft Azure, необходимо создать службу Azure OpenAI.
Microsoft Edge (рекомендуется) или Google Chrome Браузера со средствами разработчика.
Учетная запись разработчика Microsoft 365 Доступ к учетной записи Teams с соответствующими разрешениями для установки приложения, включения пользовательских приложений Teams и включения отправки пользовательских приложений.

Если вы уже выполняли примеры ранее или столкнулись с ошибкой среды выполнения, выполните следующие действия, чтобы начать заново:
  • Проверьте все .env файлы и env/.env.*.* в примере и удалите автоматически заполненные значения, чтобы убедиться, что Набор средств Teams создает новые ресурсы.
  • Если вы не хотите, чтобы Teams Toolkit создавал идентификатор и пароль приложения, обновите BOT_ID и BOT_PASSWORD в .env файле своими собственными значениями.
  • Удалите значения или оставьте их пустыми для SECRET_BOT_PASSWORD и TEAMS_APP_UPDATE_TIME в .env файле, чтобы избежать конфликтов.

Набор средств Teams автоматически подготавливает ресурсы и BOT_PASSWORD ресурсыBOT_ID. Если вы хотите использовать собственные ресурсы, необходимо вручную добавить их в .env файл. Набор средств Teams не создает следующие ресурсы автоматически:

  • Ключ Azure OpenAI или OpenAI
  • База данных или аналогичные варианты хранения

Создание и запуск примера приложения

  1. Перейдите к примеру.

  2. Клонируйте репозиторий, чтобы протестировать пример приложения.

    git clone https://github.com/microsoft/teams-ai.git

  3. Перейдите в папку Python .

    cd teams-ai/python

  4. Перейдите в папку, в которой вы клонировали репозиторий, и выберите 04.ai.c.actionMapping.lightBot. Все файлы для примера LightBot перечислены в разделе EXPLORER Visual Studio Code.

  5. В разделе EXPLORER дублируйте файл sample.env и обновите его до .env.

    Перейдите в папку env и обновите следующий код в ./env/.env.local.user файле:

    SECRET_OPENAI_KEY=<your OpenAI key>

  6. Чтобы установить следующие зависимости, перейдите в раздел Просмотр>терминала и выполните следующие команды:

    Зависимости Command
    python-dotenv pip install python-dotenv
    load-dotenv pip install load-dotenv
    teams-ai pip install teams-ai
    botbuilder-core pip install botbuilder-core

  7. Обновите config.json имя развертывания модели и bot.py .

  8. Перейдите в раздел Просмотр>палитры команд... или нажмите клавиши CTRL+SHIFT+P.

  9. Введите Python: Создать среду , чтобы создать виртуальную среду.

  10. Чтобы отладить приложение, выберите F5.

    Вкладка браузера открывает веб-клиент Teams, чтобы добавить бота в клиент.

  11. Нажмите Добавить.

    Снимок экрана: диалоговое окно сведений о приложении для добавления приложения LightBot.

    При добавлении приложения появляется диалоговое окно для выбора необходимого область.

  12. Выберите Открыть, чтобы открыть приложение в личных область.

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

    Снимок экрана: диалоговое окно выбора область со списком общих областей.

    Откроется окно чата.

  13. В области создания сообщения отправьте сообщение для вызова бота.

    Снимок экрана: пример выходных данных LightBot.

Дополнительные средства

Для запуска и настройки примера можно также использовать следующие средства:

  1. Teams Toolkit CLI. Вы можете использовать интерфейс командной строки набора средств Teams для создания приложений Teams и управления ими из командной строки. Дополнительные сведения см. в разделе Инструкции по настройке интерфейса командной строки набора средств Teams.

  2. Bot Framework Emulator: Bot Framework Emulator — это классическое приложение, которое позволяет тестировать и отлаживать бота локально. Вы можете подключиться к боту, введя URL-адрес конечной точки бота, а также идентификатор и пароль приложения Майкрософт. Затем вы можете отправлять сообщения боту и просматривать его ответы в режиме реального времени. Дополнительные сведения см. в разделе инструкции по настройке Bot Framework Emulator.

  3. Ручная настройка. Если вы предпочитаете настраивать ресурсы вручную, это можно сделать, следуя инструкциям, предоставленным соответствующими службами. Дополнительные сведения см. в руководстве по настройке вручную.

Следующее действие

В качестве следующего шага выберите один из следующих вариантов:

Если вы хотите узнать, как использовать библиотеку ИИ Teams для создания бота на основе ИИ, выберите следующее:
Сборка с помощью библиотеки ИИ Teams

Если вы хотите создать пользовательский агент обработчика с помощью набора средств Teams, выберите следующее:
Создание пользовательского агента обработчика