Создание согласованной системы с несколькими агентами с помощью агента-руководителя

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

Что такое агент руководителя?

Используйте Supervisor Agent, чтобы создать систему-координатор, которая координирует Genie Agents, конечные точки агентов, функции Unity Catalog, серверы MCP и пользовательские агенты, чтобы они совместно выполняли сложные задачи в разных специализированных областях. Агент руководителя использует расширенные шаблоны оркестрации ИИ для управления взаимодействием агентов, делегированием задач и синтезом результатов для предоставления комплексных решений. Он поддерживает несколько языков.

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

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

Агент руководителя позволяет улучшить качество координации руководителя и настроить поведение агента на основе отзывов о естественном языке от экспертов по теме. Укажите примеры и рекомендации по оптимизации производительности системы.

Агент-супервизор создает комплексную конечную точку, которую вы можете использовать в ваших приложениях. Например, вы можете взаимодействовать с конечной точкой, отправив запросы на площадку или создав приложение чата с помощью Databricks Apps. У руководителя есть встроенные элементы управления доступом, чтобы конечные пользователи имели доступ только к субагентам и данным, к которым они имеют право доступа.

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

Requirements

• Рабочая область, которая включает в себя следующее:
  • Доступные бессерверные вычислительные ресурсы (включены по умолчанию в рабочих областях с каталогом Unity в поддерживаемом регионе).
  • Каталог Unity включен. См. Включение рабочей области для каталога Unity.
  • Доступ к службе моделей.
  • Доступ к бессерверной политике использования с ненулевой бюджетом.
• Рабочая область в одном из поддерживаемых регионов.
• Необходимо иметь агенты или инструменты, готовые к использованию. Необходимо указать по крайней мере один подагент.
• Конечные пользователи агента-координатора должны иметь явные права доступа, чтобы взаимодействовать с каждым субагентом. Сведения о необходимых разрешениях см. в поддерживаемых подагентах и средствах .

Поддерживаемые субагенты и инструменты

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

Выполнение кода

Каждый супервизор по умолчанию включает инструмент выполнения кода. Когда запрос требует вычислений, супервайзер запускает код, сгенерированный моделью, в песочнице без сервера вычислительной сессии для анализа данных, преобразования файлов или выполнения вычислений. Она поддерживает Python (по умолчанию), SQL и команды оболочки. Супервайзер сам пишет и запускает код, когда это необходимо, поэтому вы не включаете, не настраиваете и не добавляете этот инструмент в разделе Tools и подагенты.

Исполнение кода происходит в строго изолированной песочнице:

• Нет доступа к Интернету. Он блокирует любой исходящий сетевой трафик независимо от сетевой политики рабочей области, поэтому код, выполняющийся в песочнице, не может обращаться к внешним конечным точкам.
• Ограниченный доступ только к Azure Databricks. У него нет доступа к данным. Он имеет доступ только для чтения к таблицам и томам Unity Catalog, которые вы добавляете в качестве инструментов для супервайзера, при условии прав конечного пользователя. Он не может получить доступ к файлам рабочего пространства.

Создание системы управления несколькими агентами

Перейдите к Агенты в левой панели навигации вашего рабочего пространства. Щелкните "Создать агент" и выберите "Агент руководителя".

Шаг 1. Настройка руководителя

Настройте руководителя и добавьте агентов, которых он будет курировать.

1. В разделе "Инструменты и вложенные агенты " на левой боковой панели добавьте средства и вложенные элементы. Щелкните тип инструмента или агента, который вы хотите добавить, а затем выберите в раскрывающемся списке. Кроме того, используйте панель поиска для выбора инструментов или агентов. Вы можете выбрать до 50 различных агентов и инструментов.

2. Для достижения лучших результатов добавьте описание для каждого инструмента/подагента. Нажмите на инструмент или подагент, чтобы изменить описание. Руководитель использует сведения в описании, чтобы помочь системе координировать агентов. Предоставьте максимально подробную информацию, чтобы улучшить делегирование задач.

3. Чтобы управлять разрешениями для каждого инструмента или агента, наведите указатель мыши на плитку инструмента или агента и щелкните Откроется это средство или агент в Azure Databricks, и вы можете настроить разрешения. Дополнительные сведения о необходимых разрешениях конечных пользователей см. в разделе поддерживаемых подагентов и инструментов .

   Note

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

4. (Необязательно) В поле "Инструкции" укажите рекомендации по реагированию руководителя.

5. (Необязательно) В поле "Описание" укажите сводку о том, что делает этот руководитель. Это описание отображается пользователям и используется для поиска.

Шаг 2. Тестирование агента руководителя

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

1. (Необязательно) Вы также можете протестировать агент на игровой площадке ИИ. Нажмите кнопку "Открыть" на детской площадке. Откроется площадка для изучения ИИ, к которой подключен ваш управленческий терминал. Если у вас есть вспомогательные функции искусственного интеллекта, вы можете включить ИИ-судья и создание искусственных задач , чтобы помочь вам оценить вашего руководителя.
2. Введите сложный вопрос или задачу для вашего руководителя.
3. Оцените его ответ. Убедитесь, что руководитель успешно делегирует задачи правильным агентам.
4. При взаимодействии с руководителем может появиться запрос на добавление рекомендаций , которые помогут улучшить ответ. Предоставьте рекомендации по ответу и повторно создайте ответ.
5. На основе ответов агента настройте поля "Описание " и "Инструкции " на левой боковой панели, чтобы улучшить ее конфигурацию.

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

Шаг 3. Улучшение руководителя

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

На вкладке "Примеры" добавьте вопросы и сценарии задач для руководителя.

1. Добавьте вопросы в метку:

   1. Нажмите кнопку +Добавить , чтобы добавить вопрос.
   2. В модальном окне Добавить вопрос введите свой вопрос.
   3. Нажмите кнопку Добавить. Вопрос должен появиться в пользовательском интерфейсе.
   4. Повторите, пока не добавите все вопросы, которые вы хотите оценить.
   5. Чтобы удалить вопрос, щелкните , затем Удалить.

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

3. Убедитесь, что эксперты имеют доступ к агенту руководителя и соответствующим подагентам:

   1. В правом верхнем углу щелкните значок меню Kebab, чтобы управлять разрешениями. Предоставьте экспертам CAN_MANAGE разрешения, чтобы они могли получить доступ к агенту и предоставить отзыв.
   2. Убедитесь, что SME имеет доступ к каждому субагенту. Дополнительные сведения о необходимых разрешениях для каждого подагента см. в разделе "Поддерживаемые подагенты" и средства .

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

4. Чтобы маркировать данные, щелкните на вопрос и добавьте Рекомендации на панели, которая появится. Рекомендации применяются сразу после сохранения.

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

Шаг 4. Управление разрешениями

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

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

1. Откройте агент на странице Агенты.
2. Вверху щелкните значок
3. Щелкните "Управление разрешениями".
4. В окне "Параметры разрешений " выберите пользователя, группу или субъект-службу.
5. Выберите разрешение для предоставления:
   • Может управлять агентом, включая параметры разрешений, редактирование конфигурации агента и улучшение его качества.
   • Может запрашивать: позволяет запрашивать конечную точку агента на игровой площадке ИИ и через API. Пользователи, имеющие только это разрешение, не могут просматривать или изменять агентов на странице "Агенты".
6. Нажмите кнопку Добавить.
7. Нажмите кнопку Сохранить.

Шаг 5. Выполните запрос к эндпоинту агента

На странице агента щелкните "Конечная точка ", чтобы открыть конечную точку агента и просмотреть сведения.

Существует несколько способов выполнять запросы к созданной конечной точке руководителя. Используйте примеры кода, предоставляемые в ИИ Playground в качестве отправной точки.

1. Нажмите кнопку "Открыть" на детской площадке.
2. На игровой площадке нажмите кнопку "Получить код".
3. Выберите способ использования конечной точки:
   • Выберите Curl API для примера кода, чтобы запросить конечную точку с помощью curl.
   • Выберите API Python для примера кода для взаимодействия с конечной точкой с помощью Python.

Управление супервизорами с использованием Databricks SDK

Пакет SDK Databricks для Python можно использовать для программного создания агентов-руководителей и управления ими и их инструментами. Полный список доступных операций см. в справочнике по пакету SDK для агентов руководителей.

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

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

from databricks.sdk import WorkspaceClient
from databricks.sdk.service.supervisoragents import SupervisorAgent

w = WorkspaceClient()

supervisor_agent = SupervisorAgent(
    display_name="<display-name>",
    description="<description>",
    instructions="<instructions>",
)
created = w.supervisor_agents.create_supervisor_agent(supervisor_agent=supervisor_agent)
print(created)

Замените <display-name>, <description>а <instructions> также значениями для агента-руководителя.

Управление инструментами (подагенты)

Вы можете добавлять, обновлять и удалять средства (подагенты) в существующем агенте руководителя с помощью пакета SDK. Инструменты обозначают субагентов, таких как ассистенты по работе со знаниями, агенты Genie, функции Unity Catalog и другие конечные точки агентов.

Добавить инструмент (subagent)

В следующем примере ассистент по знаниям добавляется в качестве инструмента для существующего агента-наставника.

from databricks.sdk import WorkspaceClient
from databricks.sdk.service.supervisoragents import Tool, KnowledgeAssistant

w = WorkspaceClient()

tool = Tool(
    tool_type="knowledge_assistant",
    description="<tool-description>",
    knowledge_assistant=KnowledgeAssistant(
        knowledge_assistant_id="<knowledge-assistant-id>",
    ),
)

created_tool = w.supervisor_agents.create_tool(
    parent="supervisor-agents/<supervisor-agent-id>",
    tool=tool,
    tool_id="<tool-id>",
)
print(created_tool)

Замените <supervisor-agent-id> идентификатором агента руководителя, <knowledge-assistant-id> идентификатором помощника знаний, добавляемого в качестве инструмента, и <tool-id> уникальным идентификатором для средства.

Обновление инструмента (субагента)

В следующем примере обновляется описание существующего средства.

from databricks.sdk import WorkspaceClient
from databricks.sdk.service.supervisoragents import Tool
from databricks.sdk.common.types.fieldmask import FieldMask

w = WorkspaceClient()

updated_tool = w.supervisor_agents.update_tool(
    name="supervisor-agents/<supervisor-agent-id>/tools/<tool-id>",
    tool=Tool(
        tool_type="knowledge_assistant",
        description="<new-description>",
    ),
    update_mask=FieldMask(["description"]),
)
print(updated_tool)

Допустимые поля в update_mask: description.

Удалить инструмент (подагент)

** В следующем примере из агента супервайзера удаляется инструмент.

from databricks.sdk import WorkspaceClient

w = WorkspaceClient()

w.supervisor_agents.delete_tool(
    name="supervisor-agents/<supervisor-agent-id>/tools/<tool-id>",
)

Limitations

• Нельзя использовать более 50 агентов в одной системе руководителей.
• Подагенты индекса поиска ИИ поддерживают только индексы Delta Sync. См. статью "Создание конечных точек поиска ИИ" и индексов.

• Собственный веб-поиск не поддерживается. Однако вы можете добавить сервер MCP для поиска в Интернете, например You.com из Azure Databricks Marketplace, как внешнее средство MCP.

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

Длительные задачи агента-супервизора