Files
buryan-infra/ops/bots/hub/core_api.py
T
buryan-agent d9ec1d25a3 Аналитика графа: шкала времени, кросс-формат, топ персон, блок на панели
Ядро: GET /graph (статистика и JSON узлов/рёбер), /timeline (тема по
десятилетиям), /cross (книги с экранизацией и авторы), /persons (топ персон).

Бот: команды «граф», «время <тема>», «кросс», «персоны режиссёры».
Проверено: science fiction по десятилетиям с фильмами, Dune ↔ Dune (2021),
Frank Herbert → Dune, Дени Вильнёв — 4 фильма.

Панель: раздел «Медиа: граф контента» с числом карточек и связей, таблицей
связей с диаграммами и списком книг-экранизаций. Панель выросла до 10.4 КБ.

Ловушки: /person перехватывал /persons (уточнён маршрут); «персоны режиссёры»
разбиралось как поиск человека по имени «режиссёры» — добавлено распознавание
запросов-списков.
2026-10-20 11:32:23 +03:00

142 lines
3.4 KiB
Python

"""Клиент API ядра для ботов."""
import json
import os
import urllib.error
import urllib.parse
import urllib.request
CORE = os.environ.get("CORE_URL", "http://127.0.0.1:9120")
def _get(path, params=None, timeout=10):
url = f"{CORE}{path}"
if params:
url += "?" + urllib.parse.urlencode(params)
try:
with urllib.request.urlopen(url, timeout=timeout) as r:
return json.loads(r.read() or b"{}"), None
except urllib.error.HTTPError as e:
return None, f"HTTP {e.code}"
except Exception as e:
return None, str(e)[:120]
def _post(path, payload, timeout=15):
req = urllib.request.Request(f"{CORE}{path}", data=json.dumps(payload).encode(),
method="POST", headers={"Content-Type": "application/json"})
try:
with urllib.request.urlopen(req, timeout=timeout) as r:
return json.loads(r.read() or b"{}"), None
except urllib.error.HTTPError as e:
return None, f"HTTP {e.code}"
except Exception as e:
return None, str(e)[:120]
def alive():
data, err = _get("/health", timeout=5)
return bool(data and data.get("ok")), err
def search(q, limit=20):
return _get("/search", {"q": q})
def card(eid):
return _get(f"/entity/{eid}")
def events(limit=30):
return _get("/events")
def stats():
return _get("/health")
def save_data(collection, key, payload, tags=None):
"""Сохранить документ в коллекцию."""
return _post(f"/data/{collection}", {"key": key, "payload": payload, "tags": tags or []})
def get_data(collection, limit=100, tag=None):
params = {"limit": limit}
if tag:
params["tag"] = tag
return _get(f"/data/{collection}", params)
def export_data(collection, fmt="md", filename=None):
"""Выгрузить коллекцию в папку проекта."""
body = {"collection": collection, "format": fmt}
if filename:
body["filename"] = filename
return _post("/export", body)
def services():
return _get("/services")
def service_history(name, limit=30):
return _get(f"/service/{name}", {"limit": limit})
def find_entity(text, kinds=None):
data, err = _get("/search", {"q": text, "limit": 20})
if err:
return None, err
items = (data or {}).get("items") or []
if kinds:
items = [i for i in items if i.get("kind") in kinds]
return (items[0] if items else None), None
def links_of(entity_id):
return _get("/entity/%s" % entity_id)
def entities(kind=None, limit=200):
data, err = _get("/entities", {"limit": limit})
if err:
return [], err
items = (data or {}).get("items") or []
if kind:
items = [i for i in items if i.get("kind") == kind]
return items, None
def similar(entity_id, limit=10):
return _get("/similar", {"id": entity_id, "limit": limit})
def person(query):
return _get("/person", {"q": query})
def pick(genre=None, theme=None, decade=None, limit=10):
params = {"limit": limit}
if genre:
params["genre"] = genre
if theme:
params["theme"] = theme
if decade:
params["decade"] = decade
return _get("/pick", params)
def timeline(query, kind="тема"):
return _get("/timeline", {"q": query, "kind": kind})
def cross_format():
return _get("/cross")
def top_persons(kind="актёр"):
return _get("/persons", {"kind": kind})
def graph_stats():
return _get("/graph")