AIKraft/Skills/omni-agents-a2a

omni-agents-a2a

Взаимодействие с OmniRoute через JSON-RPC 2.0. Включает 6 встроенных навыков: smart-routing, quota-management, provider-discovery, cost-analysis, health-report, list-capabilities. Полезно для интеграции и управления агентами.

diegosouzapw official Разработка ★ 73.8k

Что делает навык

Навык обеспечивает взаимодействие с OmniRoute через протокол A2A (JSON-RPC 2.0) для интеграции и управления агентами. Он позволяет выполнять задачи маршрутизации, управления квотами, поиска провайдеров, анализа стоимости, проверки здоровья системы и получения списка доступных возможностей.

Когда применять

  • Выбор оптимальной комбинации провайдера и модели на основе входного запроса (smart-routing).
  • Проверка доступного баланса квот для конкретного провайдера или аккаунта (quota-management).
  • Поиск провайдеров, соответствующих техническим требованиям, таким как поддержка зрения или JSON-режима (provider-discovery).
  • Оценка стоимости выполнения запроса заданной структуры (cost-analysis).
  • Получение отчета о состоянии системы, включая ошибки и задержки (health-report).

Как работает

  1. Получить токен аутентификации через POST /api/auth/login или использовать OMNIROUTE_KEY.
  2. Запросить Agent Card по адресу /.well-known/agent.json для получения информации о доступных навыках и схемах аутентификации.
  3. Сформировать JSON-RPC 2.0 запрос с методом tasks/send, указав skillId и необходимые параметры в params.
  4. Отправить POST-запрос на endpoint /a2a с заголовком Authorization: Bearer и телом запроса.
  5. Обработать ответ, содержащий taskId, статус выполнения и вывод (output) или код ошибки.
  6. При необходимости проверить доступные методы и схемы данных через OpenAPI спецификацию.

Примеры запросов агенту

Отправить запрос на smart-routing с параметрами prompt_length: 4000, tools: true, vision: false.
Запросить health-report для получения информации о состоянии контуров и задержках.
Использовать provider-discovery для поиска провайдеров с поддержкой инструментов (tools: true).

Что понадобится

  • Переменные окружения OMNIROUTE_URL и OMNIROUTE_KEY.
  • Действующий Bearer token или сессия (получается через /api/auth/login).

Описание составлено по SKILL.md навыка, сверено 08.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «omni-agents-a2a» из репозитория: # https://github.com/diegosouzapw/omniroute
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r omni-agents-a2a/ ~/.claude/skills/omni-agents-a2a/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.