Интеграция с AegisAI / AgentOps¶

AgentBI работает автономно или совместно с AegisAI и AgentOps. В режиме интеграции он потребляет данные из этих систем для более глубокой бизнес-аналитики.

Проект	Фокус	Что передаёт в AgentBI
AegisAI	Безопасность	Агенты, политики, аномалии, журналы аудита
AgentOps	Оркестрация	Задачи, цепочки, расписания, учёт затрат
AgentBI	Бизнес-ценность	ROI, ценность, сэкономленное время, сравнение

Что интегрируется¶

Источник	Данные	Бизнес-результат в AgentBI
AegisAI	Агенты, политики, аномалии, журналы аудита	ROI с контекстом безопасности; стоимость инцидентов через бизнес-события
AgentOps	Задачи, цепочки, расписания, учёт затрат	ROI с контекстом оркестрации; эффективность цепочек

Способы интеграции¶

1. API (основной)¶

Настройте в .env:

```bash AEGISAI_API_URL=https://aegisai.example/api/v1 AEGISAI_API_KEY=your_aegisai_key

AGENTOPS_API_URL=https://agentops.example/api/v1 AGENTOPS_API_KEY=your_agentops_key ```

Синхронизация агентов из AegisAI:

bash python scripts/migrate_aegisai_data.py

Скрипт:

Читает AEGISAI_API_URL / AEGISAI_API_KEY
Получает список агентов из upstream
Создаёт / обновляет строки в agents AgentBI
Сохраняет external_refs.aegisai_id

Рекомендуемый hourly cron:

bash 0 * * * * cd /opt/agentbi && .venv/bin/python scripts/migrate_aegisai_data.py >> logs/sync.log 2>&1

2. Webhook (в реальном времени)¶

AegisAI / AgentOps могут отправлять события в AgentBI:

http POST /api/v1/ingest/webhook X-API-Key: abi_... Content-Type: application/json

Пример payload (схема AgentBI):

json { "agent_id": "support-triage", "event_type": "task_completed", "duration_ms": 1500, "cost_usd": 0.05, "business_value": 10.0, "time_saved_minutes": 15, "metadata": { "source": "agentops", "task_id": "task-9981", "chain_id": "chain-sales-q3" } }

Пример конфигурации upstream webhook:

yaml webhooks: - url: https://your-agentbi.example/api/v1/ingest/webhook headers: X-API-Key: abi_your_key events: - agent.registered - agent.action - task.completed - cost.updated

Рекомендуемое сопоставление событий:

Upstream-событие	AgentBI `event_type`	Поля
`task.completed`	`task_completed`	`cost_usd`, `business_value`, `time_saved_minutes`
`cost.updated`	`cost_updated`	`cost_usd`
`agent.action` + anomaly	`error`	`metadata.severity`
`agent.registered`	—	создать через `/api/v1/agents` или авто-регистрация при первом событии

3. SDK (напрямую из агентов)¶

Агенты могут отправлять бизнес-метрики без промежуточного слоя:

```python

sdk/agentbi.py¶

from agentbi import AgentBI

client = AgentBI( base_url="https://your-agentbi.example", api_key="abi_...", )

client.track( agent_id="agent-001", event_type="task_completed", duration_ms=1500, cost_usd=0.05, business_value=100.00, time_saved_minutes=15, metadata={ "description": "Sales deal closed", "source": "agent_runtime", }, )

client.track_batch([ { "agent_id": "agent-001", "event_type": "task_completed", "cost_usd": 0.04, "business_value": 12.0, "time_saved_minutes": 8, }, { "agent_id": "agent-001", "event_type": "task_completed", "cost_usd": 0.06, "business_value": 20.0, "time_saved_minutes": 12, }, ]) ```

Пример ценности интеграции¶

Без AgentBI:

AegisAI: «Агент выполнил 1000 действий, 3 аномалии»
AgentOps: «Агент завершил 50 задач, стоимость $45»

С AgentBI:

Агент Support Triage обработал 1000 запросов, сэкономил 87 часов, создал ценность $1,250 (включая экономию на труде), стоимость $45.80, ROI 2,629%.

Связь систем:

Runtime Agent │ ├─► AegisAI (policy / audit) ├─► AgentOps (orchestration / cost) └─► AgentBI (business value / ROI) ← CEO/CFO view

Безопасность интеграции¶

Используйте отдельные API-ключи для каждого upstream (AegisAI sync, AgentOps webhook, Prod agents).
Никогда не коммитьте ключи — только .env.
Ограничьте CORS и экспозицию Traefik в production.
Для on-prem развёртываний держите AgentBI в той же частной сети, что AegisAI / AgentOps.

Устранение неполадок интеграции¶

`migrate_aegisai_data.py` ничего не делает¶

text AEGISAI_API_URL not set — nothing to migrate.

Задайте переменные в .env или экспортируйте их в shell.

Webhook 401¶

Проверьте X-API-Key — ключ должен быть создан через /api/v1/auth/api-keys и is_active=true.

Агенты есть в AegisAI, но ROI = 0¶

Синхронизация агентов не создаёт бизнес-события. Всё равно нужны ingest-события с cost_usd / business_value / time_saved_minutes.

Дорожная карта интеграции¶

[ ] Плановая выгрузка audit-log из AegisAI
[ ] Импорт cost-stream из AgentOps
[ ] Единый граф идентичности агентов (aegisai_id + agentops_id + agentbi_id)
[ ] Дашборд «Стоимость инцидентов для безопасности» (аномалии AegisAI × $ impact)

См. также: Главная · Руководство CEO/CFO

Поле	Тип	Обязательно	Значение
`agent_id`	string	да	Идентификатор агента
`event_type`	string	да	`task_completed` / `error` / …
`cost_usd`	float	да	Стоимость вызова / задачи
`business_value`	float	рекомендуется	Прямая бизнес-ценность ($)
`time_saved_minutes`	int	рекомендуется	Сэкономленное время сотрудника
`duration_ms`	int	нет	Длительность
`metadata`	object	нет	Контекст (deal_id, ticket_id, …)