omni-agents-a2a
Взаимодействие с OmniRoute через JSON-RPC 2.0. Включает 6 встроенных навыков: smart-routing, quota-management, provider-discovery, cost-analysis, health-report, list-capabilities. Полезно для интеграции и управления агентами.
AIdiegosouzapw
official
Разработка
★ 73.8k
Что делает навык
Навык обеспечивает взаимодействие с OmniRoute через протокол A2A (JSON-RPC 2.0) для интеграции и управления агентами. Он позволяет выполнять задачи маршрутизации, управления квотами, поиска провайдеров, анализа стоимости, проверки здоровья системы и получения списка доступных возможностей.
Когда применять
- Выбор оптимальной комбинации провайдера и модели на основе входного запроса (smart-routing).
- Проверка доступного баланса квот для конкретного провайдера или аккаунта (quota-management).
- Поиск провайдеров, соответствующих техническим требованиям, таким как поддержка зрения или JSON-режима (provider-discovery).
- Оценка стоимости выполнения запроса заданной структуры (cost-analysis).
- Получение отчета о состоянии системы, включая ошибки и задержки (health-report).
Как работает
- Получить токен аутентификации через POST /api/auth/login или использовать OMNIROUTE_KEY.
- Запросить Agent Card по адресу /.well-known/agent.json для получения информации о доступных навыках и схемах аутентификации.
- Сформировать JSON-RPC 2.0 запрос с методом tasks/send, указав skillId и необходимые параметры в params.
- Отправить POST-запрос на endpoint /a2a с заголовком Authorization: Bearer и телом запроса.
- Обработать ответ, содержащий taskId, статус выполнения и вывод (output) или код ошибки.
- При необходимости проверить доступные методы и схемы данных через 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 и совместимые) подхватывает его по описанию и следует шагам.