AI Toolkit для VS Code: как собрать своего AI-агента за 5 минут прямо в редакторе — VogueTech

Что нового

Microsoft выпустила AI Toolkit для VS Code — расширение, которое превращает редактор кода в полноценную среду для сборки AI-агентов.

Ключевые изменения по сравнению с привычным стеком «фреймворк + GitHub + терминал»:

Нет обязательного кода на старте. Агент можно собрать через визуальный конструктор прямо в VS Code.
Два режима работы:
- «Design an Agent Without Code» — визуальный конструктор.
- «Create in Code with Full Control» — генерация полноценного проекта с файлами и структурой.
Глубокая интеграция с GitHub Copilot. Copilot по текстовому описанию собирает весь каркас проекта агента: логику, инструменты, системные промпты, базовые тесты.
Встроенная поддержка Microsoft Foundry. AI Toolkit сам подтягивает и обновляет open-source skill microsoft-foundry, на котором работает GitHub Copilot for Azure.
Поддержка нескольких крупных моделей: в интерфейсе доступны GPT‑4.1, Claude Opus 4.6 и другие, Foundry‑модели отмечены как рекомендованные.
MCP (Model Context Protocol) для инструментов. Подключение внешних «серверов» возможностей: веб‑поиск, базы данных, файлы, внешние API и любые сервисы с MCP‑сервером.
Гранулярный контроль над инструментами. Для каждого MCP‑инструмента можно выбрать авто‑запуск или ручное подтверждение.
Prompt Optimizer. Встроенный оптимизатор промптов от Foundry, который переписывает инструкции агента, делая их более структурированными и понятными модели.
Agent Inspector. Визуализация работы агента: какие инструменты он вызывает, в каком порядке, как принимает решения.
Conversations View. История всех диалогов с агентом прямо в конструкторе, с возможностью просматривать и сравнивать сценарии.
Единая панель ресурсов. В боковой панели «My Resources» собраны:
- Recent Agents — последние агенты;
- Local Resources — локальные модели, агенты, инструменты;
- Foundry Resources — удалённые модели и агенты (при подключении).

Цифр по скорости, цене токена или размеру контекста в продукте нет — фокус на удобстве разработки и интеграции в VS Code.

Как это работает

AI Toolkit — это расширение VS Code с несколькими ключевыми компонентами под капотом:

Интерфейс агента в VS Code
- В боковой панели появляется иконка AI Toolkit.
- Через палитру команд (Ctrl+Shift+P) запускается команда Create Agent.
- Дальше пользователь выбирает: визуальный конструктор или генерация кода.
Визуальный конструктор агента (no‑code)
- Панель «Design an Agent Without Code» позволяет задать:
  - имя агента (например, Azure Advisor);
  - модель (GPT‑4.1, Claude Opus 4.6 и др., Foundry‑модели наверху списка);
  - инструкции — системный промпт: кто агент, чем он занимается, как себя ведёт.
- Важный момент: AI Toolkit сам определяет, использовать ли Chat Completions API или Responses API. Разработчику не нужно думать о типе API, переключение происходит автоматически.
- После заполнения формы достаточно нажать Run — откроется встроенный playground для общения с агентом.
Режим «Create in Code with Full Control»
- Два пути:
  - Scaffold from a template. Генерация проекта из шаблона:
    - одиночный агент;
    - multi‑agent;
    - workflow на LangGraph. AI Toolkit создаёт структуру папок, конфиги и стартовый код.
  - Generate with GitHub Copilot. В Copilot Chat можно описать задачу обычным языком, например:
    
    "Create a customer support agent that can look up order status, process returns, and escalate to a human when the customer is upset."
    
    Copilot на основе этого запроса создаёт:
    - логику агента;
    - описания инструментов (tools);
    - системные промпты;
    - базовые тесты и оценку поведения агента.
- Внутри используется skill microsoft-foundry — тот же, что лежит в основе GitHub Copilot for Azure. AI Toolkit сам его устанавливает и обновляет, без ручной настройки.
Инструменты через MCP (Model Context Protocol)
- В Agent Builder есть кнопка Add Tool.
- Через неё можно подключить MCP‑серверы, которые расширяют возможности агента:
  - веб‑поиск;
  - запросы к базе данных;
  - чтение файлов;
  - вызов внешних API;
  - любые другие сервисы, для которых есть MCP‑сервер.
- Для каждого инструмента можно задать режим:
  - Auto — агент вызывает инструмент сразу;
  - Manual — каждый вызов требует подтверждения в интерфейсе.
- MCP‑серверы можно удалять прямо из каталога инструментов, без ручного редактирования конфигов.
Оптимизация промптов и отладка
- Prompt Optimizer: кнопка Improve в Agent Builder запускает оптимизацию системного промпта через Foundry. Инструкции становятся более структурированными, что снижает вероятность непредсказуемого поведения агента.
- Agent Inspector: визуальный трейсинг работы агента в реальном времени:
  - какие шаги он выполняет;
  - какие инструменты вызывает;
  - в каком порядке происходят вызовы.
- Conversations View: вкладка с историей всех диалогов с агентом для анализа и регресс‑тестирования.
Интеграция с VS Code и Copilot
- Всё работает внутри VS Code, без отдельного веб‑интерфейса или CLI.
- GitHub Copilot встроен как генератор архитектуры и кода агента, а не только как чат‑бот.
- Сгенерированные проекты можно версионировать, тестировать и деплоить как обычный код.

Что это значит для вас

Для кого полезен AI Toolkit

Разработчики, которые живут в VS Code
- Не нужно прыгать между браузером, терминалом и IDE.
- Можно начать с визуальной сборки, быстро проверить идею, а потом нажать «View Code» и получить полноценный проект.
- Удобно подключать MCP‑инструменты и смотреть их работу через Agent Inspector.
Инженеры, отвечающие за интеграцию ИИ в продукты
- Поддержка multi‑agent и LangGraph‑workflow через шаблоны.
- Возможность настроить строгий контроль над инструментами: чтение — автоматически, действия — только с ручным подтверждением.
- История диалогов и визуальный трейсинг помогают отлавливать странное поведение до продакшена.
Продакт‑менеджеры и аналитики, которые не пишут код
- Визуальный конструктор позволяет собрать прототип без знания фреймворков и YAML.
- Prompt Optimizer помогает сформулировать требования к агенту на понятном языке, не погружаясь в промпт‑инжиниринг.
- Через Conversations View можно смотреть, как агент ведёт себя в разных сценариях, и формулировать требования к доработке.
Команды, которые уже используют GitHub Copilot
- Copilot превращается из «подсказчика кода» в генератор целых проектов агентов.
- Описание агента обычным текстом экономит время на ручной настройке boilerplate‑кода и конфигов.

Где инструмент особенно полезен

Быстрые прототипы AI‑функций для веб‑приложений, внутренних тулов, ассистентов поддержки.
Сборка агентов с доступом к данным: базы, файлы, внутренние API через MCP.
Проекты, где важен контроль и аудит: можно включить ручное подтверждение опасных действий и смотреть полную трассировку в Agent Inspector.
Обучение команд: новичок может начать с no‑code, потом перейти к коду того же агента и понять, как он устроен.

Где ожидания стоит снизить

Нет встроенной магии по деплою. AI Toolkit генерирует и отлаживает проект, но продакшн‑инфраструктуру всё равно нужно строить отдельно.
Без доступа к поддерживаемым LLM и Foundry‑ресурсам возможности ограничены. Если корпоративная среда не даёт подключаться к этим сервисам, часть функций будет недоступна.
Продвинутая настройка пайплайнов всё равно потребует кода. Визуальный конструктор хорош для простых сценариев и прототипов, но сложные workflows лучше собирать в режиме «Create in Code».

Доступность из России

AI Toolkit — это расширение VS Code и сам по себе он устанавливается напрямую из VS Code Marketplace. Но для работы агентов нужны внешние модели (GPT‑4.1, Claude Opus 4.6, Foundry‑модели) и сервисы Microsoft/GitHub. Доступ к ним из России часто ограничен, и на практике может потребоваться VPN и аккаунт в соответствующих облачных сервисах.

Место на рынке

AI Toolkit конкурирует не с одной моделью, а с целым классом решений для сборки агентов:

веб‑конструкторы агентов;
фреймворки вроде LangChain/LangGraph;
собственные внутренние тулкиты компаний.

Чем подход Microsoft отличается по параметрам:

Среда разработки:
- AI Toolkit полностью живёт в VS Code. Не нужно открывать браузер или отдельный UI.
- В отличие от веб‑конструкторов, результат — это настоящий кодовый проект, который удобно хранить в Git и разворачивать в прод.
Связка no‑code и code‑first:
- В большинстве решений это два разных продукта: визуальный конструктор отдельно, SDK и фреймворк отдельно.
- В AI Toolkit это два режима одного и того же агента: можно начать в визуальном режиме, а потом переключиться на код и обратно.
Интеграция с GitHub Copilot:
- Copilot здесь не просто чат сбоку, а полноценный генератор архитектуры агента и тестов.
- Каркас проекта строится на microsoft-foundry, который Microsoft уже использует в GitHub Copilot for Azure.
MCP‑инструменты и управление ими:
- Поддержка Model Context Protocol даёт единый способ подключать внешние сервисы.
- Встроенный каталог MCP‑серверов и управление доступом (auto/manual) закрывают типичную боль с безопасностью «агент что‑то сделал без спроса».

Прямых численных сравнений по скорости работы, цене токена или размеру контекста с конкретными системами (например, с готовыми агент‑конструкторами от других вендоров) в продукте нет. Основной акцент — на том, что всё происходит внутри VS Code, а код агента остаётся под полным контролем команды.

Установка

Для старта нужно всего два шага:

Установить VS Code
- Скачать дистрибутив с официального сайта Visual Studio Code и установить.
Поставить расширение AI Toolkit
- Открыть VS Code.
- Перейти во вкладку Extensions (Ctrl+Shift+X).
- В поиске набрать AI Toolkit.
- Найти расширение AI Toolkit и установить.

Дополнительных зависимостей, ручной установки Foundry или microsoft-foundry не требуется — AI Toolkit подтягивает всё сам.

Как запустить своего первого агента

Вариант 1. Без кода, через визуальный конструктор

Откройте VS Code.
Нажмите Ctrl+Shift+P.
Введите Create Agent и выберите одноимённую команду.
В появившемся окне выберите Design an Agent Without Code.
Заполните форму:
- Name — название агента, например: Azure Advisor.
- Model — выберите модель из списка (GPT‑4.1, Claude Opus 4.6 и другие; Foundry‑модели наверху списка как рекомендованные).
- Instructions — опишите, кто ваш агент и как он должен себя вести.
Нажмите Run.
Встроенный playground откроется сразу, можно начинать диалог с агентом.

Вариант 2. Полный контроль через код

Откройте VS Code.
Нажмите Ctrl+Shift+P.
Введите Create Agent.
Выберите Create in Code with Full Control.
Дальше два пути:
- Scaffold from a template:
  - выберите тип проекта: одиночный агент, multi‑agent или LangGraph‑workflow;
  - AI Toolkit создаст структуру папок, конфиги и стартовый код;
  - откройте проект, доработайте логику, запустите и тестируйте.
- Generate with GitHub Copilot:
  - откройте Copilot Chat;
  - опишите агента на естественном языке, например:
    
    "Create a customer support agent that can look up order status, process returns, and escalate to a human when the customer is upset."
  - дождитесь, пока Copilot сгенерирует проект: логику агента, инструменты, системные промпты и тесты.

После этого можно использовать Agent Builder как playground для тестирования уже кодового агента, а не только no‑code версии.

Практические советы по использованию

Начинайте с визуального конструктора. Это быстрый способ проверить идею и системный промпт. Как только поведение станет приемлемым, переключайтесь на режим кода.
Всегда включайте Agent Inspector на этапе отладки. Он помогает увидеть, какие инструменты агент вызывает и почему ответы получаются именно такими.
Используйте Manual‑режим для опасных действий. Всё, что меняет данные или вызывает внешние API с побочными эффектами, лучше запускать только после ручного подтверждения.
Не экономьте время на Prompt Optimizer. Одна кнопка Improve часто даёт больше, чем десятки ручных правок промпта.
Версионируйте всё. Сгенерированный код — это обычный проект. Кладите его в Git, добавляйте тесты, стройте CI, как для любого backend‑сервиса.