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

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

Примечание

Агент, созданный в этом руководстве, предназначен для лицензированных пользователей Microsoft 365 Copilot. Вы также можете создавать агенты для пользователей Microsoft 365 Copilot Chat с ограниченными возможностями. Дополнительные сведения см. в разделе Лицензии для разработчиков Microsoft 365 Copilot.

Совет

Рекомендуется: Начните с Work IQ Dev Tools для поддерживаемых сценариев декларативного агента и плагинов для кода. См. краткое руководство по WIQD. Инструкции на основе набора средств остаются доступными для существующих проектов и рабочих процессов, для которых они требуются. Перед выбором инструмента проверьте поддержку возможностей и целевого интерфейса : WIQD не нацелен на агентов пользовательской подсистемы.

Примечание

Декларативные агенты на основе Microsoft 365 Copilot теперь поддерживаются в Word и PowerPoint.

Необходимые условия

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

Примечание

Снимки экрана и ссылки на пользовательский интерфейс в этой статье используют версию выпуска набора средств агентов Microsoft 365. Предварительные версии могут отличаться от пользовательского интерфейса.

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

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

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

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

  2. Выбор набора средств > для агентов Microsoft 365 Создание агента или приложения.

    Снимок экрана: кнопка

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

    Снимок экрана: параметры нового проекта с выбранным агентом

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

  5. Выберите папку по умолчанию для сохранения корневой папки проекта в расположении по умолчанию.

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

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

    Снимок экрана: параметр подготовки на панели

Тестирование агента

  1. Перейдите в приложение Copilot по адресу https://m365.cloud.microsoft/chat.

  2. Выберите значок панели бесед рядом с кнопкой "Создать Chat".

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

    Снимок экрана: декларативный агент в Copilot

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

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

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

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

    @instructions("""
      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 в манифесте агента. Дополнительные сведения см. в разделе Декларативный агент manifest object.

  2. Выберите Подготовка в области жизненного цикла набора средств агентов.

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

Снимок экрана: ответ декларативного агента на основе обновленных инструкций

Как начать беседу

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

  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?"
    })
    

    Дополнительные сведения см. в разделе Возражение "Начать беседу".

  2. Выберите Подготовка в области жизненного цикла набора средств агентов.

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

Снимок экрана, показывающий варианты начала беседы от декларативного агента в Microsoft 365 Copilot

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

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

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

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

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

    Примечание

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

  2. Выберите Подготовка в области жизненного цикла набора средств агентов.

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

Снимок экрана, показывающий ответ декларативного агента, содержащий веб-содержимое

Добавление содержимого 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. Выберите Подготовка в области жизненного цикла набора средств агентов.

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

Снимок экрана: ответ агента декларации, содержащий содержимое SharePoint и OneDrive

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

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

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

    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. Выберите Подготовка в области жизненного цикла набора средств агентов.

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

Снимок экрана, показывающий ответ декларативного агента, содержащий содержимое Teams

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

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

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

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

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

  2. Выберите Подготовка в области жизненного цикла набора средств агентов.

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

Снимок экрана: ответ декларативного агента, содержащий сведения о людях

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

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

  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. Выберите Подготовка в области жизненного цикла набора средств агентов.

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

Снимок экрана: ответ декларативного агента со сведениями о работе с электронной почтой

Добавить генератор изображений

Функция "Генератор изображений" позволяет агентам создавать изображения на основе запросов пользователей.

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

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

    Подробнее см. в разделе Графический объект.

  2. Выберите Подготовка в области жизненного цикла набора средств агентов.

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

Снимок экрана: ответ декларативного агента, содержащий сгенерированную графическую картинку

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

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

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

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

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

  2. Выберите Подготовка в области жизненного цикла набора средств агентов.

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

Снимок экрана: ответ декларативного агента, содержащий созданный график

На этом снимке экрана показан код Python, используемый для создания запрошенного графа

Добавление содержимого соединителей 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. Выберите Подготовка в области жизненного цикла набора средств агентов.

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

Снимок экрана: ответ декларативного агента, содержащий содержимое соединителя Copilot

Завершено

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

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