A2A
Взаимодействие с внешними агентами, совместимыми с A2A
Протокол A2A (Agent-to-Agent) позволяет AACFlow взаимодействовать с внешними AI-агентами и системами, которые реализуют совместимые с A2A API. С помощью A2A вы можете подключить автоматизацию и рабочие процессы AACFlow к удаленным агентам — таким как боты на основе LLM, микросервисы и другие инструменты на основе искусственного интеллекта — используя стандартизированный формат обмена сообщениями.
Используя инструменты A2A в AACFlow, вы можете:
- Отправлять сообщения внешним агентам: Общаться напрямую с удаленными агентами, предоставляя промпты, команды или данные.
- Получать и стримить ответы: Получать структурированные ответы, артефакты или обновления в реальном времени от агента по мере выполнения задачи.
- Продолжать диалоги или задачи: Вести многоходовые диалоги или рабочие процессы, ссылаясь на идентификаторы задач и контекста.
- Интегрировать сторонний ИИ и автоматизацию: Использовать внешние сервисы, совместимые с A2A, как часть ваших рабочих процессов AACFlow.
Эти функции позволяют создавать продвинутые рабочие процессы, которые сочетают встроенные возможности AACFlow с интеллектом и автоматизацией внешних ИИ или пользовательских агентов. Для использования интеграций A2A вам понадобится URL-адрес конечной точки внешнего агента и, если требуется, API-ключ или учетные данные.
Используйте протокол A2A (Agent-to-Agent) для взаимодействия с внешними AI-агентами.
Отправить сообщение внешнему агенту, совместимому с A2A.
| Параметр | Тип | Обязательный | Описание |
|---|
agentUrl | string | Да | URL-адрес конечной точки агента A2A |
message | string | Да | Сообщение для отправки агенту |
taskId | string | Нет | Идентификатор задачи для продолжения существующей задачи |
contextId | string | Нет | Идентификатор контекста для непрерывности диалога |
data | string | Нет | Структурированные данные для включения в сообщение (строка JSON) |
files | array | Нет | Файлы для включения в сообщение |
apiKey | string | Нет | API-ключ для аутентификации |
| Параметр | Тип | Описание |
|---|
content | string | Текстовое содержимое ответа от агента |
taskId | string | Уникальный идентификатор задачи |
contextId | string | Группирует связанные задачи/сообщения |
state | string | Текущее состояние жизненного цикла (working, completed, failed, canceled, rejected, input_required, auth_required) |
artifacts | array | Артефакты вывода задачи |
history | array | История диалога (массив Message) |
Запросить статус существующей задачи A2A.
| Параметр | Тип | Обязательный | Описание |
|---|
agentUrl | string | Да | URL-адрес конечной точки агента A2A |
taskId | string | Да | Идентификатор задачи для запроса |
apiKey | string | Нет | API-ключ для аутентификации |
historyLength | number | Нет | Количество сообщений истории для включения |
| Параметр | Тип | Описание |
|---|
taskId | string | Уникальный идентификатор задачи |
contextId | string | Группирует связанные задачи/сообщения |
state | string | Текущее состояние жизненного цикла (working, completed, failed, canceled, rejected, input_required, auth_required) |
artifacts | array | Артефакты вывода задачи |
history | array | История диалога (массив Message) |
Отменить выполняющуюся задачу A2A.
| Параметр | Тип | Обязательный | Описание |
|---|
agentUrl | string | Да | URL-адрес конечной точки агента A2A |
taskId | string | Да | Идентификатор задачи для отмены |
apiKey | string | Нет | API-ключ для аутентификации |
| Параметр | Тип | Описание |
|---|
cancelled | boolean | Успешно ли выполнена отмена |
state | string | Текущее состояние жизненного цикла (working, completed, failed, canceled, rejected, input_required, auth_required) |
Получить карточку агента (документ обнаружения) для агента A2A.
| Параметр | Тип | Обязательный | Описание |
|---|
agentUrl | string | Да | URL-адрес конечной точки агента A2A |
apiKey | string | Нет | API-ключ для аутентификации (если требуется) |
| Параметр | Тип | Описание |
|---|
name | string | Отображаемое имя агента |
description | string | Назначение/возможности агента |
url | string | URL-адрес конечной точки сервиса |
provider | object | Детали организации-создателя |
capabilities | object | Матрица поддержки функций |
skills | array | Доступные операции |
version | string | Версия протокола A2A, поддерживаемая агентом |
defaultInputModes | array | Типы содержимого ввода по умолчанию, принимаемые агентом |
defaultOutputModes | array | Типы содержимого вывода по умолчанию, создаваемые агентом |
Переподключиться к потоку выполняющейся задачи A2A после разрыва соединения.
| Параметр | Тип | Обязательный | Описание |
|---|
agentUrl | string | Да | URL-адрес конечной точки агента A2A |
taskId | string | Да | Идентификатор задачи для повторной подписки |
apiKey | string | Нет | API-ключ для аутентификации |
| Параметр | Тип | Описание |
|---|
taskId | string | Уникальный идентификатор задачи |
contextId | string | Группирует связанные задачи/сообщения |
state | string | Текущее состояние жизненного цикла (working, completed, failed, canceled, rejected, input_required, auth_required) |
isRunning | boolean | Выполняется ли задача |
artifacts | array | Артефакты вывода задачи |
history | array | История диалога (массив Message) |
Настроить вебхук для получения уведомлений об обновлениях задач.
| Параметр | Тип | Обязательный | Описание |
|---|
agentUrl | string | Да | URL-адрес конечной точки агента A2A |
taskId | string | Да | Идентификатор задачи для настройки уведомлений |
webhookUrl | string | Да | URL-адрес HTTPS вебхука для получения уведомлений |
token | string | Нет | Токен для проверки вебхука |
apiKey | string | Нет | API-ключ для аутентификации |
| Параметр | Тип | Описание |
|---|
url | string | URL-адрес HTTPS вебхука для уведомлений |
token | string | Токен аутентификации для проверки вебхука |
success | boolean | Успешно ли выполнена операция |
Получить конфигурацию вебхука push-уведомлений для задачи.
| Параметр | Тип | Обязательный | Описание |
| --------- | ---- | -----патч | ----------- |
| agentUrl | string | Да | URL-адрес конечной точки агента A2A |
| taskId | string | Да | Идентификатор задачи для получения конфигурации уведомлений |
| apiKey | string | Нет | API-ключ для аутентификации |
| Параметр | Тип | Описание |
|---|
token | string | Токен аутентификации для проверки вебхука |
exists | boolean | Существует ли ресурс |
Удалить конфигурацию вебхука push-уведомлений для задачи.
| Параметр | Тип | Обязательный | Описание |
|---|
agentUrl | string | Да | URL-адрес конечной точки агента A2A |
taskId | string | Да | Идентификатор задачи для удаления конфигурации уведомлений |
pushNotificationConfigId | string | Нет | Идентификатор конфигурации push-уведомлений для удаления (необязательно - сервер может вывести из taskId) |
apiKey | string | Нет | API-ключ для аутентификации |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешно ли выполнена операция |
