Doc: Equipe de IA (doc/clipador/EQUIPE-IA.md) e contrato por papel em doc/ia.md
- EQUIPE-IA.md: papéis e configuração (judge.roles, migração), juiz de contexto e as regras de decisão pelo código, linha do tempo JSON + mosaico, medição (ai_calls, owner_label, GET /v1/judge/report) e o medido no corte 291 (analista −45%, varredura −38%, editor −20%; ≈ −29% por hora já com o juiz; 1 chamada real do juiz no Codex: 9.624 tokens de entrada). - doc/ia.md: reserva por papel, codex exec --json e leitura de uso por CLI. - README do Clipador: rotas /v1/judge e /v1/judge/report. - judge.describe: uma checagem por provedor para todas as cadeias (o painel lê o status a cada poucos segundos); sem analista, o editor recebe as imagens no modo escolhido. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
26c9afa13a
commit
76b722c499
+2
-1
@@ -441,7 +441,8 @@ chave `clipper-<sessão>-<bloco>`; num banco novo as sessões recomeçam do 1 e
|
||||
|---|---|
|
||||
| `GET /health` | sem chave |
|
||||
| `GET /v1/status` | ferramentas, voz, juiz, gravações ativas |
|
||||
| `GET/PUT /v1/judge` | provedor, modelos (editor/analista), nota mínima, varredura, visão, câmera (+ lista de modelos) |
|
||||
| `GET/PUT /v1/judge` | Equipe de IA (`roles`: varredura, analista, editor, juiz — provedor, modelo, esforço, liga/desliga, instruções do administrador; `roleDefaults` = instruções padrão), nota mínima, varredura, visão, câmera, `timelineJson` (+ lista de modelos) — doc/clipador/EQUIPE-IA.md |
|
||||
| `GET /v1/judge/report?days=&session=` | medição: chamadas e tokens por papel/IA por hora de live, aprovação, decisões do juiz de contexto, concordância juiz × dono |
|
||||
| `GET/PUT /v1/channels/{id}/settings` · `GET/PUT /v1/sessions/{id}/settings` | configuração do corte: `own`, `effective`, `defaults` (com `format`, `duration` e `hook`), `modes`, `fonts`, `fontFiles` (`{família: "assets/fonts/…ttf"}` das empacotadas, relativo à raiz do repositório), `hookStyles`, `hookAnims`, `aspects`, `frames` (`{vertical, horizontal: {width, height, canvasWidth, canvasHeight}}`, para o painel desenhar a prévia) e `captureQualities` (`[{id, label, maxHeight, gbPerHour, gbPerHourMax, hint}]`) |
|
||||
| `GET /v1/sessions/{id}/frame?t=` · `POST …/preview` · `POST …/detect-cam[?ai=true]` | quadro para o editor, prévia do layout, achar webcam (local primeiro) |
|
||||
| `GET /v1/sessions/{id}/face?from=&to=` · `POST …/face/reset` | série por segundo do rosto (cx/cy/size no quadro inteiro, expressões, `signal`) e picos; refazer o rastreio |
|
||||
|
||||
+14
-11
@@ -1233,13 +1233,13 @@ class Judge:
|
||||
elif self.roles["analyst"]["model"] and provider != self.roles["analyst"]["provider"]:
|
||||
self.roles["analyst"]["model"] = ""
|
||||
|
||||
def roles_view(self) -> dict:
|
||||
"""Papéis para o painel: a configuração + instruções padrão (só leitura) e a cadeia de reserva de cada um."""
|
||||
def roles_view(self, skip: dict[str, str | None] | None = None) -> dict:
|
||||
"""Papéis para o painel: a configuração + o modelo efetivo e a cadeia de reserva de cada um."""
|
||||
out = {}
|
||||
for name in roles_module.ROLES:
|
||||
conf = dict(self.roles[name])
|
||||
conf["resolvedModel"] = self.role_model(name)
|
||||
conf["chain"] = self.fallback_chain(conf["provider"]) if self.enabled else []
|
||||
conf["chain"] = self.fallback_chain(conf["provider"], skip) if self.enabled else []
|
||||
out[name] = conf
|
||||
return out
|
||||
|
||||
@@ -1299,11 +1299,12 @@ class Judge:
|
||||
return "modo chave de API sem chave no cofre"
|
||||
return None
|
||||
|
||||
def fallback_chain(self, primary: str | None = None) -> list[str]:
|
||||
def fallback_chain(self, primary: str | None = None, skip: dict[str, str | None] | None = None) -> list[str]:
|
||||
"""Ordem em que `ask` tenta as IAs: a do papel (`primary`; padrão = a do editor) primeiro, depois a `order`
|
||||
do painel, só as ligadas, com CLI e (no modo chave) com chave; as em pausa são puladas e as perto do limite
|
||||
de uso vão para o fim. Reserva desligada: só a escolhida.
|
||||
Se TODAS as prontas estiverem em pausa, elas voltam como último recurso (melhor tentar do que parar)."""
|
||||
Se TODAS as prontas estiverem em pausa, elas voltam como último recurso (melhor tentar do que parar).
|
||||
`skip` = `_skip_reason` já calculado por provedor (o `describe` monta a cadeia de cada papel de uma vez)."""
|
||||
if not self.enabled:
|
||||
return []
|
||||
primary = primary if primary in AI_ENABLED else self.provider
|
||||
@@ -1311,7 +1312,8 @@ class Judge:
|
||||
candidates = [primary]
|
||||
if settings["fallback"]["enabled"]:
|
||||
candidates += [p for p in settings["order"] if p != primary and p in AI_ENABLED]
|
||||
ready = [p for p in candidates if self._skip_reason(p, settings) is None]
|
||||
ready = [p for p in candidates
|
||||
if (skip[p] if skip is not None and p in skip else self._skip_reason(p, settings)) is None]
|
||||
if not settings["fallback"]["enabled"]:
|
||||
return ready
|
||||
paused = self.pauses()
|
||||
@@ -1323,7 +1325,9 @@ class Judge:
|
||||
def describe(self) -> dict:
|
||||
cmd = self.command() if self.enabled else None
|
||||
settings = self.ai.settings()
|
||||
primary_skip = self._skip_reason(self.provider, settings) if self.enabled else None
|
||||
# Uma checagem por provedor (CLI no PATH, ligada, chave) para todas as cadeias: o painel lê isto a cada poucos s.
|
||||
skip = {p: self._skip_reason(p, settings) for p in AI_ENABLED}
|
||||
primary_skip = skip.get(self.provider) if self.enabled else None
|
||||
return {"provider": self.provider, "model": self.model if self.enabled else None,
|
||||
"analystModel": self.role_model("analyst") if self.enabled else None,
|
||||
"available": bool(cmd) if self.enabled else None, "path": cmd[-1] if cmd else None,
|
||||
@@ -1332,13 +1336,12 @@ class Judge:
|
||||
"authMode": settings["providers"].get(self.provider, {}).get("authMode") if self.enabled else None,
|
||||
"fallback": {"enabled": settings["fallback"]["enabled"],
|
||||
"cooldownMin": settings["fallback"]["cooldownMin"],
|
||||
"chain": self.fallback_chain()},
|
||||
"chain": self.fallback_chain(skip=skip)},
|
||||
"pauses": [{"provider": p, "until": datetime.fromtimestamp(until, timezone.utc).isoformat(timespec="seconds"),
|
||||
"reason": reason} for p, (until, reason) in sorted(self.pauses().items())],
|
||||
# Equipe de IA: cada papel com a sua IA (doc/clipador/EQUIPE-IA.md).
|
||||
"roles": self.roles_view(),
|
||||
"providers": {p: {"ready": self._skip_reason(p, settings) is None,
|
||||
"reason": self._skip_reason(p, settings),
|
||||
"roles": self.roles_view(skip),
|
||||
"providers": {p: {"ready": skip[p] is None, "reason": skip[p],
|
||||
"enabled": bool((settings["providers"].get(p) or {}).get("enabled"))}
|
||||
for p in AI_ENABLED}}
|
||||
|
||||
|
||||
@@ -940,8 +940,8 @@ class Engine:
|
||||
# Linha do tempo JSON (novo) ou transcrição + chat + frames soltos (antigo, `timelineJson` desligado).
|
||||
use_timeline = bool(self.intel.opts.get("timelineJson", True))
|
||||
analyst_on = self.judge.role_enabled("analyst")
|
||||
image_mode = (self.judge.roles["analyst"].get("images", "mosaic") if analyst_on else "frames") \
|
||||
if use_timeline else "frames"
|
||||
# Imagens como escolhido no analista (sem analista, o editor recebe as mesmas); formato antigo = soltos.
|
||||
image_mode = self.judge.roles["analyst"].get("images", "mosaic") if use_timeline else "frames"
|
||||
# Quadros espalhados de um pouco antes do candidato até o fim da reação: o analista vê a sequência.
|
||||
# 6 quadros; 8 quando o trecho passa de 80 s (cortes de 60–90 s), para não ficar > 20 s entre quadros.
|
||||
f_lo = max(lo, clip["start_s"] - 20)
|
||||
|
||||
Reference in New Issue
Block a user