Краткое руководство. Создание агента и общение с ним в Teams

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

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

Это краткое руководство состоит из двух разделов. В первом разделе вам потребуется:

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

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

Создание кода для агента и его использование на игровой площадке агентов Microsoft 365

  1. Установите интерфейс командной строки разработчика Teams и игровую площадку агентов Microsoft 365.

    npm install -g @microsoft/teams.cli @microsoft/m365agentsplayground

  2. Используйтеteams project new, чтобы создать код для нового агента из шаблона и открыть его в Visual Studio Code.

    teams project new typescript echo-bot
cd echo-bot
code .

  3. В Visual Studio Code откройте .src/index.ts Найдите строку, которая читает const app = new App(); , и измените ее для чтения:

    const app = new App({ skipAuth: true });

    Это временное изменение, позволяющее предоставить тестовой площадке агентов Microsoft 365 возможность взаимодействовать с агентом.

  4. Запустите агент. После запуска вы увидите подтверждение того, что он доступен через порт 3978.

    npm install
npm run dev

  5. В новом окне консоли запустите microsoft 365 Agents Playground.

    agentsplayground

    Откроется интерфейс на новой вкладке браузера.

  6. Используйте поле создания, чтобы отправить агенту сообщение и увидеть его ответ в чате. Ваш агент работает локально!

    Снимок экрана: короткое взаимодействие с агентом на детской площадке агентов Microsoft 365.

  7. Закройте вкладку "Агенты" в браузере и нажмите клавиши CTRL+C в обоих окнах консоли, чтобы остановить агентов и агент. Оставьте открытым окно консоли, которое вы использовали для создания агента, и в ближайшее время оно понадобится снова.

  8. В Visual Studio Code отмените изменения, внесенные на шаге 3. Это обеспечит безопасное подключение к Teams на следующих шагах.

    const app = new App();

Вход и подтверждение разрешений

Примечание.

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

Если у вас нет учетной записи Microsoft 365, вы можете перейти к дальнейшим действиям , чтобы продолжить работу с кодом агента и завершить оставшиеся части этого краткого руководства позже. Сведения о получении подписки на песочницу для разработчиков, которую можно использовать для пробного использования приложения в Teams, см. в статье Microsoft 365 Developer Program .

Войдите в учетную запись Microsoft 365 из интерфейса командной строки разработчика Teams.

teams login

Интерфейс командной строки подтвердит ваше имя входа, разрешения вашей учетной записи на установку пользовательских приложений ("загрузка неопубликованных приложений") и проверка наличие установки Azure CLI (не требуется для этого краткого руководства).

✔ Logged in as user@contoso.com
✔ Sideloading: enabled

Azure CLI: installed, not logged in

Чтобы продолжить работу с этим кратким руководством, необходимо включить загрузку неопубликованных приложений. Если он отключен, вам потребуется администратор Microsoft 365 вашей организации, чтобы включить его для вашей учетной записи. Инструкции администратора по включению этого разрешения см. в статье Разрешить пользователям загружать пользовательские приложения . Тем временем можно перейти к дальнейшим действиям , чтобы продолжить работу с кодом агента.

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

Это краткое руководство состоит из двух разделов. В первом разделе вам потребуется:

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

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

Создание кода для агента и его использование на игровой площадке агентов Microsoft 365

  1. Установите интерфейс командной строки разработчика Teams и игровую площадку агентов Microsoft 365.

    npm install -g @microsoft/teams.cli @microsoft/m365agentsplayground

  2. Используйтеteams project new, чтобы создать код для нового агента из шаблона и открыть его в Visual Studio Code.

    teams project new python echo-bot
cd echo-bot
code .

  3. Откройте .src/main.py Найдите строку, которая читает app = App() , и измените ее для чтения:

    app = App(skip_auth=True)

    Это временное изменение, позволяющее предоставить тестовой площадке агентов Microsoft 365 возможность взаимодействовать с агентом.

  4. Запустите агент. После запуска вы увидите подтверждение того, что он работает на порту 3978.

    python -m venv .venv
source .venv/bin/activate
pip install -e .
python src/main.py

  5. В новом окне консоли запустите microsoft 365 Agents Playground.

    agentsplayground

    Откроется интерфейс на новой вкладке браузера.

  6. Используйте поле создания, чтобы отправить агенту сообщение и увидеть его ответ в чате. Ваш агент работает локально!

    Снимок экрана: короткое взаимодействие с агентом на детской площадке агентов Microsoft 365.

  7. Закройте вкладку "Агенты" в браузере и нажмите клавиши CTRL+C в обоих окнах консоли, чтобы остановить агентов и агент. Оставьте открытым окно консоли, которое вы использовали для создания агента, и в ближайшее время оно понадобится снова.

  8. В редакторе отмените изменения, внесенные на шаге 3. Это обеспечит безопасное подключение к Teams на следующих шагах.

    app = App()

Вход и подтверждение разрешений

Примечание.

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

Если у вас нет учетной записи Microsoft 365, вы можете перейти к дальнейшим действиям , чтобы продолжить работу с кодом агента и завершить оставшиеся части этого краткого руководства позже. Сведения о получении подписки на песочницу для разработчиков, которую можно использовать для пробного использования приложения в Teams, см. в статье Microsoft 365 Developer Program .

Войдите в учетную запись Microsoft 365 из интерфейса командной строки разработчика Teams.

teams login

Интерфейс командной строки подтвердит ваше имя входа, разрешения вашей учетной записи на установку пользовательских приложений ("загрузка неопубликованных приложений") и проверка наличие установки Azure CLI (не требуется для этого краткого руководства).

✔ Logged in as user@contoso.com
✔ Sideloading: enabled

Azure CLI: installed, not logged in

Чтобы продолжить работу с этим кратким руководством, необходимо включить загрузку неопубликованных приложений. Если он отключен, вам потребуется администратор Microsoft 365 вашей организации, чтобы включить его для вашей учетной записи. Инструкции администратора по включению этого разрешения см. в статье Разрешить пользователям загружать пользовательские приложения . Тем временем можно перейти к дальнейшим действиям , чтобы продолжить работу с кодом агента.

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

  • Node.js 24 или более поздней версии (скачать установщик)
  • .NET 10 или более поздней версии (скачать установщик)
  • Teams с рабочей или учебной учетной записью Microsoft 365, которая имеет разрешения на установку пользовательских приложений Teams (вы подтвердите эти разрешения в самом начале краткого руководства).

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

Установка средств, вход и подтверждение разрешений

Установите интерфейс командной строки разработчика Teams и игровую площадку агентов Microsoft 365, а затем войдите в интерфейс командной строки разработчика.

npm install -g @microsoft/teams.cli
teams login

Интерфейс командной строки подтвердит ваше имя входа, разрешения вашей учетной записи на установку пользовательских приложений ("загрузка неопубликованных приложений") и проверка наличие установки Azure CLI (не требуется для этого краткого руководства).

✔ Logged in as user@contoso.com
✔ Sideloading: enabled

Azure CLI: installed, not logged in

Чтобы продолжить работу с этим кратким руководством, необходимо включить загрузку неопубликованных приложений. Если он отключен, вам потребуется администратор Microsoft 365 вашей организации, чтобы включить его для вашей учетной записи. Инструкции администратора по включению этого разрешения см. в статье Разрешить пользователям загружать пользовательские приложения .

Создание кода для агента

  1. Используйте teams project new для создания кода для нового агента на основе шаблона.

    teams project new csharp EchoBot
cd EchoBot/EchoBot

  2. Запустите агент, чтобы подтвердить его запуск. После запуска вы увидите подтверждение того, что он работает на порту 3978.

    dotnet run

  3. Нажмите клавиши CTRL+C в окне консоли, чтобы остановить агент. Оставьте окно консоли открытым, скоро оно понадобится снова.

Размещение туннеля разработки

Teams могут взаимодействовать только с агентами, доступными из общедоступного Интернета. На этом шаге вы используете служебную программу Microsoft dev tunnel для создания туннеля, который будет предоставлять агент в Интернет.

  1. В новом окне консоли установите туннель разработки.

    winget install Microsoft.devtunnel

  2. Войдите в систему devtunnel с помощью учетной записи Microsoft 365 и разместите новый туннель.

    devtunnel user login
devtunnel create --allow-anonymous
devtunnel port create -p 3978
devtunnel host

    Вы увидите следующие выходные данные:

    Connection to host tunnel relay restored.
Hosting port: 3978
Connect via browser: https://4r9dd5xj-3978.usw2.devtunnels.ms
Inspect network activity: https://4r9dd5xj-3978-inspect.usw2.devtunnels.ms

Ready to accept connections for tunnel: joyful-dog-xgz66vp.usw2

  3. Оставьте туннель запущенным. Запишите Connect via browser URL-адрес для следующего шага.

Регистрация, установка и чат в Teams

  1. В окне консоли, которое вы использовали для создания проекта агента, используйте teams app create , чтобы зарегистрировать его на платформе Teams. Замените <tunnel-host> полным Connect via browser URL-адресом из предыдущего шага. Эта команда создает файл конфигурации, который проект агента должен взаимодействовать с Teams, поэтому важно запустить его из каталога проекта агента.

    teams app create --endpoint <tunnel-host>/api/messages --name echo-bot --env .env

  1. В окне консоли, которое вы использовали для создания проекта агента, используйте teams app create , чтобы зарегистрировать его на платформе Teams. Замените <tunnel-host> полным Connect via browser URL-адресом из предыдущего шага. Эта команда создает файл конфигурации, который проект агента должен взаимодействовать с Teams, поэтому важно запустить его из каталога проекта агента.

    teams app create --endpoint <tunnel-host>/api/messages --name echo-bot --env appsettings.json

  1. create По завершении команды отобразится меню. Выберите Установить в Teams , чтобы открыть Teams и открыть диалоговое окно установщика агента.

    Снимок экрана: диалоговое окно установки приложения в Teams.

  1. Прежде чем продолжить работу в Teams, вернитесь в окно консоли и выберите Готово в меню командной строки разработчика Teams, чтобы закрыть его. Затем снова запустите агент с помощью командной строки. Перед продолжением убедитесь, что он прослушивает порт 3978.

    npm run dev

  1. Прежде чем продолжить работу в Teams, вернитесь в окно консоли и выберите Готово в меню командной строки разработчика Teams, чтобы закрыть его. Затем снова запустите агент с помощью командной строки. Перед продолжением убедитесь, что он прослушивает порт 3978.

    python src/main.py

  1. Прежде чем продолжить работу в Teams, вернитесь в окно консоли и выберите Готово в меню командной строки разработчика Teams, чтобы закрыть его. Затем снова запустите агент с помощью командной строки. Перед продолжением убедитесь, что он прослушивает порт 3978.

    dotnet run

  1. Вернитесь в Teams и выберите Добавить в диалоговом окне установщика из шага 2, чтобы установить агент. В появившемся диалоговом окне Как вы хотите использовать это приложение сегодня? выберите Открыть , чтобы открыть чат с агентом.

    Снимок экрана: диалоговое окно Teams с вопросом о том, как пользователь хочет использовать только что установленное приложение.

  2. Chat с агентом в Teams!

    Снимок экрана: краткое взаимодействие в чате с агентом в Teams.

Дальнейшие действия

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

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

Ознакомьтесь с документацией, чтобы узнать больше о функциях и рекомендациях для агентов в Teams.

  • Last updated on