Создание декларативных агентов с помощью набора средств агентов Microsoft 365 и TypeSpec

Декларативный агент — это настраиваемая версия Microsoft 365 Copilot, которая позволяет пользователям создавать персонализированные интерфейсы путем объявления конкретных инструкций, действий и знаний. В этом руководстве показано, как создать декларативный агент с помощью TypeSpec и microsoft 365 Agents Toolkit.

Предварительные условия

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

Для вашей среды разработки доступны следующие параметры:

• Песочница организации Microsoft 365 с Copilot (доступна в ограниченной предварительной версии благодаря членству в TAP).
• Рабочая среда Microsoft 365 или Office 365 с лицензией на Microsoft 365 Copilot.

Для выполнения действий, описанных в этой статье, требуются следующие ресурсы:

• Visual Studio Code
• Расширение microsoft 365 Agents Toolkit Visual Studio Code

Необходимо ознакомиться со следующими стандартами и рекомендациями для декларативных агентов для Microsoft 365 Copilot:

• Стандарты соответствия требованиям, производительности, безопасности и пользовательского интерфейса, описанные в руководстве по проверке Магазина Teams.

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

Начните с создания базового декларативного агента.

1. Откройте Visual Studio Code.

2. Выберите Microsoft 365 Agents Toolkit > Create a New Agent/App (Создать агент или приложение).

   

3. Выберите Декларативный агент.

   

4. Выберите Начать с TypeSpec для Microsoft 365 Copilot, чтобы создать базовый декларативный агент.

5. Выберите Папка по умолчанию , чтобы сохранить корневую папку проекта в расположении по умолчанию.

6. Введите My Agent имя приложения и нажмите клавишу ВВОД.

7. В открывавшемся окне нового Visual Studio Code выберите Microsoft 365 Agents Toolkit (Набор средств агентов Microsoft 365). В области Жизненный цикл выберите Подготовка.

   

Протестируйте агент

1. Перейдите к приложению Copilot с URL-адресом https://m365.cloud.microsoft/chat.

2. Рядом с кнопкой Создать чат выберите значок ящика беседы.

3. Выберите декларативный агент Мой агент.

   

4. Введите вопрос для декларативного агента, чтобы увидеть его в действии.

Добавление инструкций

Инструкции изменяют поведение агента.

1. main.tsp Откройте файл и замените @instructions декоратор следующим кодом.

   @instructions("""
     You are a declarative agent and were created with Team Toolkit. You are an expert at creating poems.
     Every time a user asks a question, you **must** turn the answer into a poem. The poem **must** not use the quote markdown and use regular text.
   """)
   

Содержимое этого декоратора вставляется в instructions свойство в манифесте агента во время подготовки. Дополнительные сведения см. в разделе Объект манифеста декларативного агента.

1. Выберите Подготовить в области Жизненный цикл набора средств агентов Microsoft 365.

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

Добавление начальных общения

Начальные параметры общения — это подсказки, которые отображаются пользователю, чтобы продемонстрировать, как приступить к работе с декларативным агентом.

1. main.tsp Откройте файл и замените закомментированный @conversationStarter декоратор следующим содержимым:

   @conversationStarter(#{
     title: "Getting started",
     text: "How can I get started with Agents Toolkit?"
   })
   
   @conversationStarter(#{
     title: "Getting Help",
     text: "How can I get help with Agents Toolkit?"
   })
   

Дополнительные сведения см. в разделе Начальный объект Conversation.

1. Выберите Подготовить в области Жизненный цикл набора средств агентов Microsoft 365.

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

Добавление веб-содержимого

Возможность поиска в Интернете позволяет агентам использовать индекс поиска в Bing для реагирования на запросы пользователей.

1. main.tsp Откройте файл и добавьте WebSearch возможность в MyAgent пространство имен со следующим содержимым.

   namespace MyAgent {
     op webSearch is AgentCapabilities.WebSearch<Sites = [
       {
         url: "https://learn.microsoft.com",
       },
     ]>;
   }
   

   Дополнительные сведения см. в разделе Объект веб-поиска.

   Примечание.

   Если не указать Sites массив, агенту будет доступно все веб-содержимое.

2. Выберите Подготовить в области Жизненный цикл набора средств агентов Microsoft 365.

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

Добавление содержимого OneDrive и SharePoint

Возможность SharePoint позволяет агенту использовать OneDrive и содержимое SharePoint в качестве знаний.

1. main.tsp Откройте файл и добавьте OneDriveAndSharePoint возможность в MyAgent пространство имен со следующим значением, заменив https://contoso.sharepoint.com/sites/ProductSupport URL-адресом сайта SharePoint в организации Microsoft 365.

   namespace MyAgent {
     // Omitted for brevity
     op od_sp is AgentCapabilities.OneDriveAndSharePoint<ItemsByUrl = [
       {
         url: "https://contoso.sharepoint.com/sites/ProductSupport"
       }
     ]>;
     // Omitted for brevity
   }
   

   Дополнительные сведения см. в статье OneDrive и объект SharePoint.

   Примечание.

   • URL-адреса должны содержать полный путь к элементам SharePoint (сайту, библиотеке документов, папке или файлу). Вы можете использовать параметр "Копировать прямую ссылку" в SharePoint, чтобы получить полный путь или файлы и папки. Щелкните файл или папку правой кнопкой мыши и выберите Пункт Сведения. Перейдите в раздел Путь и щелкните значок копирования.
   • Если не указать ItemsByUrl массив (или альтернативный ItemsBySharePointIds массив), все содержимое OneDrive и SharePoint в организации Microsoft 365, доступное для вошедшего пользователя, станет доступным агенту.

2. Выберите Подготовить в области Жизненный цикл набора средств агентов Microsoft 365.

Декларативный агент имеет доступ к содержимому OneDrive и SharePoint для создания ответов после перезагрузки страницы.

Добавление сообщений Teams

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

1. main.tsp Откройте файл и добавьте TeamsMessages возможность в MyAgent пространство имен со следующим значением, заменив https://teams.microsoft.com/l/team/... url-адресом канала Teams или команды из вашей организации.

   namespace MyAgent {
     // Omitted for brevity
     op teamsMessages is AgentCapabilities.TeamsMessages<TeamsMessagesByUrl = [
       {
         url: "https://teams.microsoft.com/l/team/...",
       }
     ]>;
     // Omitted for brevity
   }
   

   Дополнительные сведения см. в статье Объект сообщений Microsoft Teams.

   Примечание.

   • URL-адрес в свойстве url должен быть хорошо сформирован ссылками на чат Teams, команду или чат собрания.
   • Если не указать TeamsMessagesByUrl массив, все каналы Teams, команды, собрания, чат 1:1 и групповые чаты в организации Microsoft 365, доступные для вошедшего пользователя, будут доступны агенту.

2. Выберите Подготовить в области Жизненный цикл набора средств агентов Microsoft 365.

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

Добавление знаний о людях

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

1. main.tsp Откройте файл и добавьте People возможность в MyAgent пространство имен со следующим содержимым.

   namespace MyAgent {
     // Omitted for brevity
     op people is AgentCapabilities.People;
     // Omitted for brevity
   }
   

Дополнительные сведения см. в разделе объект Люди.

1. Выберите Подготовить в области Жизненный цикл набора средств агентов Microsoft 365.

После перезагрузки страницы декларативный агент имеет доступ к знаниям о людях.

Добавление знаний по электронной почте

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

1. main.tsp Откройте файл и добавьте Email возможность в MyAgent пространство имен со следующим содержимым.

   namespace MyAgent {
     // Omitted for brevity
     op email is AgentCapabilities.Email<Folders = [
       {
         folder_id: "Inbox",
       }
     ]>;
     // Omitted for brevity
   }
   

   Дополнительные сведения см. в разделе объект Email.

   Примечание.

   • В этом примере выполняется доступ к пользователю почтового ящика агента. Чтобы получить доступ к общему почтовому ящику, добавьте дополнительное shared_mailbox свойство, заданное для адреса электронной почты общего почтового ящика.
   • Массив Folders ограничивает доступ к почтовым ящикам для определенных папок. Чтобы получить доступ ко всему почтовому ящику folders , опустите массив.

2. Выберите Подготовить в области Жизненный цикл набора средств агентов Microsoft 365.

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

Добавление генератора образов

Возможность генератора образов позволяет агентам создавать образы на основе запросов пользователей.

1. main.tsp Откройте файл и добавьте GraphicArt возможность в MyAgent пространство имен со следующим содержимым.

   namespace MyAgent {
     // Omitted for brevity
     op graphicArt is AgentCapabilities.GraphicArt;
     // Omitted for brevity
   }
   

Дополнительные сведения см. в разделе Графический объект.

1. Выберите Подготовить в области Жизненный цикл набора средств агентов Microsoft 365.

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

Добавление интерпретатора кода

Возможность интерпретатора кода — это расширенное средство, предназначенное для решения сложных задач с помощью кода Python.

1. main.tsp Откройте файл и добавьте CodeInterpreter возможность в MyAgent пространство имен со следующим содержимым.

   namespace MyAgent {
     // Omitted for brevity
     op codeInterpreter is AgentCapabilities.CodeInterpreter;
     // Omitted for brevity
   }
   

Дополнительные сведения см. в разделе Объект интерпретатора кода.

1. Выберите Подготовить в области Жизненный цикл набора средств агентов Microsoft 365.

Декларативный агент имеет возможность интерпретатора кода после перезагрузки страницы.

Добавление содержимого соединителей Copilot

Элементы, принятые соединителем Copilot, можно добавить в доступные знания для агента.

1. main.tsp Откройте файл и добавьте GraphConnectors возможность в MyAgent пространство имен со следующим значением, заменив допустимым идентификатором соединителя policieslocal Copilot в организации Microsoft 365. Дополнительные сведения о поиске идентификаторов соединителей Copilot см. в разделе Извлечение идентификаторов возможностей для декларативного манифеста агента.

   namespace MyAgent {
     // Omitted for brevity
     op copilotConnectors is AgentCapabilities.GraphConnectors<Connections = [
       {
         connectionId: "policieslocal",
       }
     ]>;
     // Omitted for brevity
   }
   

   Дополнительные сведения см. в разделе Объект соединителей Copilot.

   Примечание.

   Если не указать Connections массив, агенту будет доступно содержимое из всех соединителей Copilot в организации Microsoft 365, доступных вошедшего в систему пользователя.

2. Выберите Подготовить в области Жизненный цикл набора средств агентов Microsoft 365.

Декларативный агент имеет доступ к содержимому соединителей Copilot для создания ответов после перезагрузки страницы.

Завершено

Вы завершили декларативное руководство по агенту для Microsoft 365 Copilot. Теперь, когда вы знакомы с использованием TypeSpec для создания декларативного агента, дополнительные сведения см. в следующих статьях.

• Узнайте, как написать эффективные инструкции для агента.
• Протестируйте агент в режиме разработчика Copilot , чтобы проверить, выбирает ли оркестратор copilot источники знаний для использования в ответ на заданные запросы.
• Получите ответы на часто задаваемые вопросы.
• Узнайте об альтернативном методе создания декларативных агентов с Copilot Studio.

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