Локализованное руководство по чтению

declarative-agent-developerНазначение, использование и источник

Создание, сборка, развертывание и локализация декларативных агентов для M365Copilot и Teams. Используйте этот навык для ЛЮБОЙ задачи, связанной с декларативным агентом, включая локализацию, создание шаблонов, редактирование манифестов, добавление возможностей и развертывание. Локализация требует токенизированных манифестов и языковых файлов, которые может создать только этот навык. Триггеры: "создать агента", "создать декларативный агент", "новый декларативный агент", "создать шаблон агента", "новый проект агента", "добавить возможность", "добавить плагин", "настроить моего агента", "развернуть моего агента", "исправить манифест моего агента", "редактировать моего агента", "локализовать моего агента", "добавить локализацию", "перевести моего агента", "многоязычный агент", "добавить плагин API", "добавить плагин MCP", "добавить OAuth к моему плагину", "просмотреть инструкции", "улучшить инструкции", "исправить мои инструкции"

Источник получен: 2026-10-29

Репозиторий-источник: microsoft/skills
SKILL.md: .github/plugins/microsoft-365-agents-toolkit/skills/declarative-agent-developer/SKILL.md
Звёзды репозитория: 3,157
Последнее обновление репозитория: 2026-10-31
Категории Skills: Рабочий процесс агента
Время последнего сбора: 2026-10-31 10:38 UTC+08:00

Лицензия: MIT

Оригинальный файл SKILL.md

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

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

Что делает этот навык

Как работает рабочий процесс на вышестоящем уровне

⛔ Проверка рабочего места — ОБЯЗАТЕЛЬНЫЙ ПЕРВЫЙ ШАГ

Прежде чем что-либо делать, проверьте файлы рабочей области, чтобы создать отпечаток проекта: Запуститеnpx -y --package @microsoft/m365agentstoolkit-cli atk --versionЧтобы убедиться, что ATK CLI установлен. Если не найден → Остановить. Посоветовать пользователю установить ATK. Проверить наличиеm365agents.ymlилиteamsApp.ymlв корне проекта. Проверьте наличиеappPackage/declarativeAgent.json.

проход вверх по течению · L26 ↗

6Всегда обновляйте инструкции и стартеры после внесения изменений.

Добавление возможности или плагина без обновления инструкций считается неполным. После ЛЮБОГО изменения: обновите инструкции, чтобы описать следующее.new/changedФункциональность — каждый источник данных должен иметь четкое описание своего предназначения (КОГДА и ПОЧЕМУ его использовать) в соответствии с критериями качества, установленными в ходе проверки инструкций. Встроенные возможности не обязательно должны иметь точные названия;actions/pluginsНеобходимо указать названия инструментов. НЕ следует перечислять названия инструментов, описания или параметры в инструкциях — они уже содержатся в метаданных плагина.ai-plugin.json(манифесты MCP, конфигурация возможностей). Инструкции должны содержать только логику принятия решений: КОГДА использовать каждый инструмент, правила цепочки и обработку ошибок. Добавьте как минимум1начало разговора за добавлениеcapability/plugin

проход вверх по течению · L158 ↗

проход вверх по течению · bash ↗

export ATK_CLI_SKILL=true

Требования и настройка

Настройка ATK CLI

Перед выполнением каких-либо команд ATK проверьте доступность интерфейса командной строки ATK, выполнив команду:npx -y --package @microsoft/m365agentstoolkit-cli atk --versionЕсли файл не найден, ПРЕКРАТИТЕ установку и сообщите пользователю — НЕ пытайтесь установить его самостоятельно. Все команды используютnpx -y --package @microsoft/m365agentstoolkit-cli atkпрефикс (например,npx -y --package @microsoft/m365agentstoolkit-cli atk provision --env local).

проход вверх по течению · L91 ↗

3Совместимость версий схемы

Прежде чем добавлять какую-либо функцию, ознакомьтесь с информацией.versionполе вdeclarativeAgent.jsonи проверьте матрицу функций схемы. Если функция не поддерживается в данной версии, откажитесь и предложите обновление. Ключевые ограничения по версиям:

проход вверх по течению · L131 ↗

Ограничения и проверки качества

2Никогда не придумывайте контент и не создавайте недостающие файлы.

НЕ придумывайте названия-заполнители, описания или инструкции. НЕ создавайтеdeclarativeAgent.jsonилиappPackage/Если их нет — это ситуация ОТКАЗА, а не ситуация «помощи в создании».

проход вверх по течению · L123 ↗

4. Использовать`npx -y --package @microsoft/m365agentstoolkit-cli atk add action`Для API-плагинов — НИКОГДА не создавайте файлы плагинов вручную.

Вам запрещено создавать вручную.ai-plugin.jsonспецификации OpenAPI, адаптивные карты или редактированиеactionsмассив. Используйте CLI: запустите одинnpx -y --package @microsoft/m365agentstoolkit-cli atk add actionВызов в соответствии со спецификацией OpenAPI, перечисляющий все операции в виде списка, разделенного запятыми.--api-operationНикогда не запускайте отдельные программы.npx -y --package @microsoft/m365agentstoolkit-cli atk add actionЭто приводит к выполнению различных операций в рамках одной и той же спецификации — в результате создается несколько плагинов вместо одного. Еслиnpx -y --package @microsoft/m365agentstoolkit-cli atk add actionЕсли возникнет ошибка, сообщите о ней; НЕ возвращайтесь к ручному созданию.

проход вверх по течению · L141 ↗

Начните с безопасного пробного периода.

Проверьте поддерживаемый хост и инструкции по установке репозитория. Храните каталог Skill, а также связанные с ним скрипты, ресурсы и документацию вместе;SKILL.mdВ одиночку можно опустить зависимости.
Предоставьте агенту ваши реальные входные данные, желаемый результат и критерии приемки. Синтаксис вызова и доступные инструменты зависят от хоста; данный сайт не предполагает универсальной команды установки.
Попробуйте запустить исходный рабочий процесс в тестовом проекте или в его копии. Перед тем как разрешить операции, изменяющие файлы, удаленные сервисы или оплачиваемые ресурсы, проверьте их.
Проверьте выходные данные на соответствие исходным проверкам качества и вашим собственным требованиям. Успешный запуск или большое количество звезд в репозитории не гарантируют корректного результата.

Формат навыков и спецификация каталога ↗

Подробнее читайте в источнике.

Перевод и сфера применения

В этом руководстве по чтению представлены избранные отрывки из закрепленного текста выше по течению.SKILL.mdПеревод выполнен с помощью переводчика. Это не полное руководство и не гарантия проверенной совместимости. Перед использованием ознакомьтесь с оригиналом и указанными в нем файлами.

Данное введение относится к закрепленной ниже версии; текущая активность в репозитории и время сбора данных отображаются отдельно.

Закрепленный источник: Прочитайте оригинал ↗
Источник получен: 2026-10-29T09:32:23Z
Исходный коммит: 00d66a64919edca5bca2c673373444e36a4b5461
Исходный SHA-256: 13d2af8dd44cca049c8ebf8a8880cca304fc3dc419c926ef146dba35b14df412

Вернуться к полному каталогу навыков