Создавайте приложения Agent Framework с помощью агента программирования

Навык-конструктор Microsoft Agent Framework для .NETagent-framework-builder-dotnet предоставляет совместимым агентам программирования рекомендации, поддерживаемые Microsoft, по созданию решений Agent Framework для .NET (C#). Он помогает агенту для написания кода выбрать подходящий шаблон и постепенно подгружать целевые рекомендации для задачи.

Навык может направлять работу со следующим:

  • Обычные агенты, поставщики моделей, инструменты, сеансы, журнал, поставщики контекста и ПО промежуточного слоя.
  • Используйте агентов с todo-задачами, режимами, памятью, согласованиями, навыками, фоновыми агентами, средствами оболочки, сжатием и циклами.
  • Рабочие процессы и встроенные оркестрации и декларативные определения.
  • Оценка, наблюдаемость, настраиваемые клиенты, настраиваемые агенты и интеграции.
  • Размещение и развертывание.

Навык предоставляет рекомендации по разработке для внешнего агента для написания кода. Он не является пакетом NuGet и не выполняется в вашем приложении на Agent Framework.

Important

Этот навык агента кодирования отличается от навыков агента Runtime. Навыки среды выполнения загружаются агентом Agent Framework во время выполнения приложения. Навык Builder помогает агенту программирования создавать или изменять исходный код приложения.

Tip

Свяжите навык построителя с сервером MCP Microsoft Learn. Навык предоставляет агенту программирования сфокусированное руководство по рабочему процессу и реализации Agent Framework, а сервер Learn MCP позволяет искать текущую документацию Microsoft, получать полные статьи и находить примеры кода во время выполнения задачи. Настройте эту общедоступную конечную точку Streamable HTTP без аутентификации в совместимом агенте программирования:

https://learn.microsoft.com/api/mcp

Prerequisites

  • Агент для программирования, поддерживающий открытую спецификацию Agent Skills.
  • GitHub CLI с командами предварительной версии gh skill или Node.js 22.20 или более поздней версии, если вы используете cross-agent skills CLI.
  • Поддерживаемый в настоящее время .NET SDK для новых приложений Agent Framework.

Управление навыками в GitHub CLI доступно в предварительной версии и может быть изменено.

Просмотрите и установите с помощью GitHub CLI

Навык .NET builder еще не входит в помеченный выпуск, поэтому необходимо указать @main ref. Просмотрите навык перед его установкой:

gh skill preview microsoft/agent-framework agent-framework-builder-dotnet@main

Установите навык:

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main

Установка по умолчанию ограничена рамками проекта и предназначена для GitHub Copilot при неинтерактивном использовании. При необходимости выберите другой поддерживаемый агент для написания кода или область действия пользователя:

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
  --agent claude-code \
  --scope user

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
  --agent cursor

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
  --agent codex

Сведения о текущих параметрах клиента и области действия см. в разделе gh skill install.

Установка с помощью CLI cross-agent skills

В качестве альтернативы установите навык с помощью CLI кросс-агента skills:

npx skills add microsoft/agent-framework --skill agent-framework-builder-dotnet

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

Использовать навык

Естественно формулируйте запрос для агента программирования. Совместимые клиенты обнаруживают и активируют навык из его метаданных; не предполагайте универсальную слэш-команду.

Примеры запросов:

  • Build a .NET Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.
  • Add approval-required tools and persistent conversation history to this Agent Framework application.
  • Convert this multi-agent design into an Agent Framework workflow and add checkpointing.
  • Create a harness agent with todos, file access, and safe shell tooling.
  • Review this .NET Agent Framework application for current APIs and package requirements.
  • Prepare this Agent Framework agent for hosting in ASP.NET Core and add an evaluation plan.

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

Что должен сделать агент программирования

Навык дает инструкции агенту программирования:

  • Проверьте существующее решение, включая целевые фреймворки, версию пакета SDK, управление пакетами и установленные Microsoft.Agents.AI.* пакеты.
  • Выберите самый маленький подходящий шаблон, например обычный агент, обвязка, рабочий процесс, оркестрация или декларативное определение.
  • Загружайте только соответствующие сфокусированные ссылки.
  • Добавьте только узкий набор пакетов, необходимых приложению, и проверьте зрелость каждого пакета, прежде чем использовать его как зависимость, так как некоторые пакеты являются предварительными версиями.
  • Считывайте конечные точки доступа, модели и ключи из конфигурации и отдавайте предпочтение учетным данным токена вместо жестко закодированных ключей API.
  • Проверьте созданное приложение с помощью существующих тестов репозитория и запускаемых примеров.

Навык не гарантирует, что созданный код готов к промышленной эксплуатации. Просмотрите план агента программирования, выбор пакета, границы безопасности, команды и созданные изменения перед утверждением.

Управление версиями и доверенные отношения

Навык — это общедоступный, устанавливаемый, поддерживаемый Microsoft потребительский навык. Версия метаданных навыка — 0.1.

  • Используйте @main ref, пока релиз с тегом не включает skill.
  • Просматривайте содержимое навыка перед установкой и проверяйте обновления, прежде чем доверять новым сценариям или инструкциям.

Исходные и целевые ссылки см. в следующей статье:

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

Создание первого агента

Вернитесь глубже:

Навык-конструктор Microsoft Agent Framework для Python, agent-framework-builder-python, предоставляет совместимым агентам программирования поддерживаемые Microsoft рекомендации по созданию решений на Python Agent Framework. Он помогает агенту для написания кода выбрать подходящий шаблон и постепенно подгружать целевые рекомендации для задачи.

Навык может направлять работу со следующим:

  • Обычные агенты, поставщики моделей, инструменты, согласования, сеансы, журнал и поставщики контекста.
  • Используйте агентов с планированием, todo-списками, памятью, сжатием, файлами, фоновыми агентами, средствами оболочки и циклами.
  • Функциональные и графовые рабочие процессы, встроенные оркестрации и декларативные определения.
  • Оценка, наблюдаемость, ПО промежуточного слоя, пользовательские клиенты, пользовательские агенты и интеграции.
  • Самостоятельное размещение и разработка размещенного агента Microsoft Foundry.

Навык поддерживает только Python. Он предоставляет рекомендации по разработке внешнему агенту для написания кода; он не является пакетом Python, не устанавливается pip install agent-framework и не выполняется в вашем приложении Agent Framework.

Important

Этот навык агента кодирования отличается от навыков агента Runtime. Навыки среды выполнения загружаются агентом Agent Framework во время выполнения приложения. Навык Builder помогает агенту программирования создавать или изменять исходный код приложения.

Tip

Свяжите навык построителя с сервером MCP Microsoft Learn. Навык предоставляет агенту программирования сфокусированное руководство по рабочему процессу и реализации Agent Framework, а сервер Learn MCP позволяет искать текущую документацию Microsoft, получать полные статьи и находить примеры кода во время выполнения задачи. Настройте эту общедоступную конечную точку Streamable HTTP без аутентификации в совместимом агенте программирования:

https://learn.microsoft.com/api/mcp

Prerequisites

  • Агент для программирования, поддерживающий открытую спецификацию Agent Skills.
  • GitHub CLI с командами предварительной версии gh skill или Node.js 22.20 или более поздней версии, если вы используете cross-agent skills CLI.
  • Python версии 3.11 или более поздней версии для новых приложений Agent Framework. Agent Framework 1.23 по-прежнему поддерживает Python 3.10, но Python 3.10 достиг конца срока поддержки у исходного поставщика.

Управление навыками в GitHub CLI доступно в предварительной версии и может быть изменено.

Просмотрите и установите с помощью GitHub CLI

Просмотрите выпущенный навык перед установкой:

gh skill preview microsoft/agent-framework agent-framework-builder-python@python-1.23.0

Установите последнюю версию с тегом:

gh skill install microsoft/agent-framework agent-framework-builder-python

Закрепите выпуск Python 1.23, если требуются воспроизводимые рекомендации:

gh skill install microsoft/agent-framework agent-framework-builder-python@python-1.23.0

Установка по умолчанию ограничена рамками проекта и предназначена для GitHub Copilot при неинтерактивном использовании. При необходимости выберите другой поддерживаемый агент для написания кода или область действия пользователя:

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent claude-code \
  --scope user

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent cursor

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent codex

Сведения о текущих параметрах клиента и области действия см. в разделе gh skill install.

Установка с помощью CLI cross-agent skills

В качестве альтернативы установите навык с помощью CLI кросс-агента skills:

npx skills add microsoft/agent-framework --skill agent-framework-builder-python

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

Использовать навык

Естественно формулируйте запрос для агента программирования. Совместимые клиенты обнаруживают и активируют навык из его метаданных; не предполагайте универсальную слэш-команду.

Примеры запросов:

  • Build a Python Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.
  • Add approval-required tools and persistent conversation history to this Agent Framework application.
  • Convert this multi-agent design into an Agent Framework workflow and add checkpointing.
  • Create a harness agent with planning, todos, file access, and safe shell tooling.
  • Review this Python Agent Framework application for current APIs and package requirements.
  • Prepare this Agent Framework agent for Foundry hosting and add an evaluation plan.

Включите такие ограничения, как поставщик моделей, целевой объект размещения, требования к персистентности, граница безопасности и поддерживаемая версия Python, если они вам известны.

Что должен сделать агент программирования

Навык дает инструкции агенту программирования:

  • Выберите самый маленький подходящий шаблон, например обычный агент, обвязка, рабочий процесс, оркестрация или декларативное определение.
  • Загружайте только соответствующие сфокусированные ссылки.
  • Предпочитайте текущие рекомендации Microsoft Learn, ссылки на общедоступные API, сведения о жизненном цикле пакета и поддерживаемые примеры для часто меняющихся сведений.
  • Установите узкие наборы пакетов вместо того, чтобы предполагать, что каждая интеграция является стабильной или обязательной.
  • Сохраняйте явные границы сеансов, согласования, проверки подлинности и размещения.
  • Проверьте созданное приложение с помощью существующих тестов репозитория, проверок типов и запускаемых примеров.

Навык не гарантирует, что созданный код готов к промышленной эксплуатации. Просмотрите план агента программирования, выбор пакета, границы безопасности, команды и созданные изменения перед утверждением.

Управление версиями и доверенные отношения

Навык — это общедоступный, устанавливаемый Microsoft пользовательский навык, выпущенный в теге репозитория python-1.23.0. Версия метаданных навыка — 0.3.

  • Используйте неуточнённую команду install для последнего релиза с тегом.
  • Закрепите @python-1.23.0, когда важна воспроизводимость.
  • Используйте @main только в том случае, если вы намеренно хотите неопубликованные рекомендации.
  • Просматривайте содержимое навыка перед установкой и проверяйте обновления, прежде чем доверять новым сценариям или инструкциям.

Исходные и целевые ссылки см. в следующей статье:

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

Создание первого агента

Вернитесь глубже:

Note

Навык-конструктор Microsoft Agent Framework для Go пока недоступен. Используйте руководство по началу работы с Go и примеры Agent Framework Go для текущего руководства.

  • Последнее обновление: