Что это
Microsoft Teams Bot Framework встречается в старых проектах и инструкциях по ботам Teams. Приложение получает сообщения и события, выполняет собственную логику и возвращает ответ или карточку. Простому боту с командами языковая модель не нужна.
Bot Framework SDK и Emulator архивированы; поддержка обращений по SDK прекращена с 31 декабря 2025 года. Поэтому новый проект не стоит начинать по старому руководству без оценки перехода. Для Teams-сценариев Microsoft рекомендует Teams SDK, для других агентских каналов - Microsoft 365 Agents SDK. Это не одно и то же с Microsoft Agent Framework для оркестрации.
Ниже приведен первый тест на актуальном Teams SDK, а не обещание работоспособности архивного пакета. Подключение AI, памяти, Graph и рабочих действий - следующие отдельные задачи. Имя и адрес этой карточки сохранены, чтобы старые ссылки продолжали вести к актуальному пояснению.
Ключевые параметры
- Категория: Инструменты разработчика
- Сложность: Для разработчика
- Запуск: Один рабочий день
- Open-source: Да
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- События и обработчики позволяют отделить обмен сообщениями от бизнес-логики.
- Боты работают в предусмотренных контекстах Teams: личном чате, группе и канале.
- Adaptive Cards позволяют показывать структурированный ответ и принимать действия пользователя.
- Для новых проектов существуют официальные SDK и руководства перехода, а не только старые примеры.
Ограничения
- Bot Framework SDK и Emulator архивированы и больше не сопровождаются.
- Переход на новый SDK требует адаптации проекта и повторных тестов; замены имени пакета недостаточно.
- Для реального Teams нужны регистрация приложения, аутентификация и разрешенная установка в организации.
- Модель, хранение состояния, доступ к данным и согласование действий не появляются автоматически у обычного бота.
Как использовать
1. Подготовка. Для нового учебного проекта выберите Teams SDK и Node.js 22.12 или новее по текущему TypeScript quickstart. Рабочие токены и корпоративные данные не используйте. Для старого бота сначала сохраните код и список проверяемых сценариев переноса.
2. Настройка. Установите @microsoft/teams.cli, выполните teams project new typescript quote-agent --template echo. В папке quote-agent выполните npm install и npm run dev. Локальный тест через Agents Playground настройте по актуальному quickstart: без учетных данных входящие запросы по умолчанию отклоняются.
3. Первый результат. Только в изолированной локальной среде без внешнего доступа настройте предусмотренный quickstart тестовый режим dangerouslyAllowUnauthenticatedRequests. Запустите Agents Playground командой agentsplayground -e http://localhost:3978/api/messages -c emulator после установки @microsoft/m365agentsplayground. Отправьте учебное Привет и получите повтор сообщения.
4. Проверка. Убедитесь, что echo отвечает без вызова модели и не меняет данные. Перед реальным Teams уберите режим без аутентификации и настройте регистрацию, защищенный endpoint и разрешения по руководству Running in Teams. Локальный Playground не проверяет установку приложения, доступ Graph или политики организации.
Доступ и оплата
- Модель оплаты: Open-source
- Бесплатный тариф: Да
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Бесплатная лицензия SDK не означает бесплатные Azure, Microsoft 365 или вызовы модели. Локальное повторение сообщения можно изучить без AI-провайдера. Архивный Bot Framework и актуальный Teams SDK нужно рассматривать отдельно.
Когда не подходит
- Начать новый проект на архивном SDK без плана сопровождения
- Получить модель и RAG установкой транспорта Teams
- Считать локальный echo-тест готовой публикацией в Teams
Альтернативы
Copilot Studio - визуальный облачный конструктор. Microsoft Agent Framework организует логику и состояние агентов, но не является прямой заменой Teams-транспорта. Slack API предназначен для другой платформы. Для кода нового Teams-бота рассматривайте именно Teams SDK и официальный путь миграции.
