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

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

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

Установка	Для использования...
Visual Studio Code	Среды сборки JavaScript, TypeScript и Python. Используйте последнюю версию.
Microsoft 365 Agents Toolkit (ранее известный как Набор средств 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.*.* в примере и удалите автоматически заполненные значения, чтобы убедиться, что набор средств агентов создает новые ресурсы.
• Если вы не хотите, чтобы набор средств агентов создавал идентификатор и пароль приложения, обновите BOT_ID и BOT_PASSWORD в .env файле собственными значениями.
• Удалите значения или оставьте их пустыми для SECRET_BOT_PASSWORD и TEAMS_APP_UPDATE_TIME в .env файле, чтобы избежать конфликтов.

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

• Ключ 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. Выберите Выбрать папку.

   

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. Обновите следующие шаги на основе выбранной службы ИИ.

    • Ключ OpenAI
    • Azure OpenAI

    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. В левой области выберите Microsoft 365 Agents Toolkit(Набор средств агентов Microsoft 365).

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

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

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

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

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

    

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

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

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

    

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

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

    

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

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

Установка	Для использования...
Visual Studio	Среды сборки C Sharp. Используйте последнюю версию.
Microsoft 365 Agents Toolkit	Расширение 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.*.* в примере и удалите автоматически заполненные значения, чтобы убедиться, что набор средств агентов создает новые ресурсы.
• Если вы не хотите, чтобы набор средств агентов создавал идентификатор и пароль приложения, обновите MicrosoftAppId и MicrosoftAppPassword в .env файле собственными значениями.
• Удалите значения или оставьте их пустыми для SECRET_BOT_PASSWORD и TEAMS_APP_UPDATE_TIME в .env файле, чтобы избежать конфликтов.

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

• Ключ 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...

   

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

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

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

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

11. Щелкните правой кнопкой мыши меню и выберите Microsoft 365 Agents Toolkit(Выбор> учетной записи Microsoft 365).

    

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

12. Нажмите OK.

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

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

    

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

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

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

    

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

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

    

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

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

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

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

Установка	Для использования...
Visual Studio Code	Среды сборки JavaScript, TypeScript и Python. Используйте последнюю версию.
Microsoft 365 Agents Toolkit	Расширение 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.*.* в примере и удалите автоматически заполненные значения, чтобы убедиться, что набор средств агентов создает новые ресурсы.
• Если вы не хотите, чтобы набор средств агентов создавал идентификатор и пароль приложения, обновите BOT_ID и BOT_PASSWORD в .env файле собственными значениями.
• Удалите значения или оставьте их пустыми для SECRET_BOT_PASSWORD и TEAMS_APP_UPDATE_TIME в .env файле, чтобы избежать конфликтов.

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

• Ключ 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.

   • Ключ OpenAI
   • Azure OpenAI

   Перейдите в папку 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. Нажмите Добавить.

    

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

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

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

    

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

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