Обратный вызов

Инструмент

В этом документе подробно описано, как плагины могут обратно вызывать сервисы инструментов (Tool) на платформе Интеллос. Рассматриваются три типа методов вызова инструментов: вызов установленных инструментов (Built-in Tool), вызов Workflow как инструмента (Workflow as Tool) и вызов пользовательских инструментов (Custom Tool). Для каждого метода приведены соответствующие точки входа и описания параметров интерфейса.

Обратный вызов инструмента (Tool) означает, что плагин может вызывать другие плагины типа «инструмент» на платформе Интеллос. Если вы не знакомы с базовыми понятиями обратного вызова, сначала прочитайте Обратный вызов сервисов Интеллос. Рассмотрите следующие сценарии:

Плагин типа «инструмент» реализовал некоторую функцию, но результат не соответствует ожиданиям и требует постобработки данных.
Задаче нужен веб-скрапер, и вы хотите иметь возможность гибко выбирать сервис скрапинга.
Вам нужно объединить результаты нескольких инструментов, но это сложно сделать с помощью приложения Workflow.

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

Вызов установленных инструментов

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

    self.session.tool

Интерфейс

    def invoke_builtin_tool(
        self, provider: str, tool_name: str, parameters: dict[str, Any]
    ) -> Generator[ToolInvokeMessage, None, None]:
        pass

Здесь provider — это ID плагина плюс имя поставщика инструмента в формате langgenius/google/google. tool_name — конкретное имя инструмента, а parameters — аргументы, передаваемые инструменту.

Вызов Workflow как инструмента

Подробнее о Workflow как инструменте см. документацию по плагину-инструменту. Точка входа

    self.session.tool

Интерфейс

    def invoke_workflow_tool(
        self, provider: str, tool_name: str, parameters: dict[str, Any]
    ) -> Generator[ToolInvokeMessage, None, None]:
        pass

В этом случае provider — это ID данного инструмента, а tool_name задаётся при создании инструмента.

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

Точка входа

    self.session.tool

Интерфейс

    def invoke_api_tool(
        self, provider: str, tool_name: str, parameters: dict[str, Any]
    ) -> Generator[ToolInvokeMessage, None, None]:
        pass

Здесь provider — это ID данного инструмента, а tool_name — это operation_id из спецификации OpenAPI. Если его нет, используется tool_name, автоматически сгенерированный Интеллос, который можно найти на странице управления инструментом.

Связанные ресурсы

Обратный вызов сервисов Интеллос — изучите основные понятия обратного вызова
Обратный вызов приложения — узнайте, как вызывать приложения на платформе
Обратный вызов модели — узнайте, как вызывать возможности моделей на платформе
Руководство по разработке плагина-инструмента — узнайте, как разрабатывать плагины-инструменты
Продвинутые плагины-инструменты — узнайте о продвинутых возможностях, таких как Workflow как инструмент

Edit this page | Report an issue

Начало работы

Возможности и спецификации

Руководства и примеры разработки

Инструмент

Вызов установленных инструментов

Вызов Workflow как инструмента

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

Связанные ресурсы

​Вызов установленных инструментов

​Вызов Workflow как инструмента

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

​Связанные ресурсы

Вызов установленных инструментов

Вызов Workflow как инструмента

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

Связанные ресурсы