Создание первой надстройки в качестве навыка Copilot

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

Предварительные требования к знаниям

• Базовое понимание декларативных агентов в Microsoft 365 Copilot. Если вы еще не знакомы с ними, рекомендуем ознакомиться с декларативными агентами для Microsoft 365 Copilot обзоре.

Предварительные требования к программному обеспечению

• Все предварительные требования, перечисленные в статье Создание декларативных агентов с помощью microsoft 365 Agent Toolkit.
• Набор средств агентов Microsoft 365. Инструкции по установке см. в статье Установка набора средств агентов Microsoft 365.

Создание проекта

1. В Visual Studio Code откройте Microsoft 365 Agents Toolkit.

   

2. Выберите Создать агент или приложение.

3. В списке Новый проект выберите Надстройка Office.

   

4. В списке Выбор возможностей выберите Создать декларативный агент с помощью действия надстройки Office.

   

5. В открывающемся списке расширенных возможностей выберите Новый декларативный агент с действиями надстроек Office.

   

6. В открываемом элементе управления Папка рабочей области выберите папку для проекта.

7. В текстовом поле Имя приложения введите "Надстройка + действия агента".

8. Проект откроется в новом окне Visual Studio Code. Закройте исходное окно Visual Studio Code.

9. Откройте набор средств агентов и в разделе Учетные записи убедитесь, что вы вошли в клиент Microsoft 365 и что включены пользовательские функции отправки приложений и Copilot Access .

Запуск проекта

1. Закройте все приложения Office.

2. Выберите Вид | Выполните в Visual Studio Code. В раскрывающемся меню ЗАПУСК И ОТЛАДКА выберите {{HOST}} Рабочий стол (пограничный Chromium),где {{HOST}} — , ExcelPowerpointили Word.

3. Нажмите клавишу F5. Выполняется сборка проекта, и откроется окно Node dev-server. Этот процесс может занять несколько минут. В конце концов откроется приложение Office.

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

Запуск надстройки

1. На вкладке Главная ленты должна быть группа надстроек Contoso. Если его нет, нажмите кнопку Надстройки на ленте, а затем выберите приложение Надстройка и действия агента во всплывающем окне.

2. Группа надстроек Contoso имеет кнопку Показать область задач , которая открывает область задач, и кнопку Выполнить действие .

   Примечание.

   Если появится запрос Остановить при загрузке WebView , нажмите кнопку ОК.

3. Протестируйте надстройку, нажав ссылку Выполнить в области задач или нажав кнопку Выполнить действие .

Запуск агента

1. Нажмите кнопку динамического действия для Copilot Chat на поверхности открытого документа.

   

2. В области Copilot выберите элемент управления гамбургер.

3. Для полного перерисовки области может потребоваться минута. В этом случае в списке должен быть список агентов и навык надстройки + агент для надстройки + действия агента .

4. Когда агент отображается в списке, выберите его. Откроется панель Навык надстройки + Агент для надстройки + Действия агента .

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

6. Выберите Подтвердить в ответ на запрос на подтверждение.

   Совет

   Если Copilot сообщает об ошибке, повторите запрос, но добавьте в запрос следующее предложение: "Если вы получаете ошибку, сообщите мне полный текст ошибки".

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

Полное завершение сеанса

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

1. В Visual Studio Code откройте меню Выполнить и выберите Остановить отладку или нажмите клавишу SHIFT+F5. Из-за ошибки, над которыми мы работаем, это действие не всегда приводит к полному закрытию сервера, закрытию приложения Office и удалению надстройки. Итак, выполните остальные шаги.

2. Закройте приложение Office, если оно по-прежнему работает.

3. Если сервер разработки по-прежнему работает, завершение работы сервера зависит от того, в каком окне он работает.

   • Если веб-сервер работает в отдельном окне от Visual Studio Code, откройте командную строку или Visual Studio Code TERMINAL. В корневом каталоге проекта выполните команду npm run stop.
   • Если веб-сервер работает в терминале Visual Studio Code, наведите фокус на окно и нажмите клавиши CTRL+C. Выберите "Y" в ответ на запрос, чтобы завершить процесс.

4. Очистите кэш Office, следуя инструкциям в разделе Очистка кэша вручную.

5. Откройте Teams и выберите Приложения на панели приложений, а затем выберите Управление приложениями в нижней части области Приложения .

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

7. Щелкните значок корзины рядом с правой частью строки, а затем выберите Удалить в командной строке.

Устранение неполадок

См. раздел Устранение неполадок с объединенными надстройками и агентами.

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

1. Ознакомьтесь с руководством по созданию декларативных агентов с помощью microsoft 365 Agent Toolkit.
2. Добавьте агент Copilot в существующую надстройку.

См. также

• Объединение агентов Copilot с надстройками Office
• Объект манифеста декларативного агента
• Схема манифеста подключаемого модуля API 2.4 для Microsoft 365 Copilot