adding: OUTPUT_FILENAME_PATTERN

.env.example

@@ -44,6 +44,8 @@ AGENTS_CONFIG_PATH=configs/judge/agents.yaml
 TRACE_PROMPT_PATH=configs/judge/trace_metrics.yaml
 SESSION_PROMPT_PATH=configs/judge/session_metrics.yaml
 OUTPUT_DIR=output
+# Available placeholders: {agent_id}, {run_id}, {timestamp} (YYYYMMDD_HHMMSS)
+OUTPUT_FILENAME_PATTERN=AGENTE_{agent_id}_LLM_JUDGE_{timestamp}.TXT.GZ
 BATCH_SIZE=50
 MAX_ATTEMPTS=3
 CONTEXT_TURN_LIMIT=6
@@ -58,4 +60,3 @@ GOOGLE_APPLICATION_CREDENTIALS=configs/GCP_ACCESS_KEY.json
 # Langfuse credentials are declared in one external YAML file.
 # In production, mount it from a Kubernetes Secret.
 LANGFUSE_CREDENTIALS_CONFIG_PATH=configs/langfuse/langfuse_credentials.yaml
-

README.en-US.md

@@ -688,7 +688,16 @@ GOOGLE_APPLICATION_CREDENTIALS=/path/GCP_ACCESS_KEY.json
 
 ## 12. Output file
 
-Pattern:
+The name is configured directly in `.env`:
+
+```env
+OUTPUT_FILENAME_PATTERN=AGENTE_{agent_id}_LLM_JUDGE_{timestamp}.TXT.GZ
+```
+
+Available placeholders are `{agent_id}`, `{run_id}`, and `{timestamp}`. The
+`timestamp` uses the `YYYYMMDD_HHMMSS` format in the São Paulo time zone.
+
+Resulting default pattern:
 
 ```text
 AGENTE_{agentId}_LLM_JUDGE_{YYYYMMDD}_{HHMMSS}.TXT.GZ
@@ -1463,6 +1472,7 @@ python -m evaluator.cli progress <RUN_ID> --events 100
 | `JUDGE_GCS_BUCKET` | bucket override |
 | `GOOGLE_APPLICATION_CREDENTIALS` | GCP credentials |
 | `OUTPUT_DIR` | temporary export directory |
+| `OUTPUT_FILENAME_PATTERN` | configurable output filename template |
 
 ---
 

README.md

@@ -688,7 +688,16 @@ GOOGLE_APPLICATION_CREDENTIALS=/path/GCP_ACCESS_KEY.json
 
 ## 12. Arquivo de saída
 
-Padrão:
+O nome é configurado diretamente no `.env`:
+
+```env
+OUTPUT_FILENAME_PATTERN=AGENTE_{agent_id}_LLM_JUDGE_{timestamp}.TXT.GZ
+```
+
+Os placeholders disponíveis são `{agent_id}`, `{run_id}` e `{timestamp}`. O
+`timestamp` é gerado no formato `YYYYMMDD_HHMMSS`, no fuso de São Paulo.
+
+Padrão resultante:
 
 ```text
 AGENTE_{agentId}_LLM_JUDGE_{YYYYMMDD}_{HHMMSS}.TXT.GZ
@@ -1478,6 +1487,7 @@ Abra `http://localhost:8080/ui`. Em Kubernetes, prefira `kubectl port-forward sv
 | `JUDGE_GCS_BUCKET` | override de bucket |
 | `GOOGLE_APPLICATION_CREDENTIALS` | credencial GCP |
 | `OUTPUT_DIR` | diretório temporário de export |
+| `OUTPUT_FILENAME_PATTERN` | template configurável do nome do arquivo de saída |
 
 ---
 

deploy/env/evaluator.env.example

@@ -17,6 +17,7 @@ ENABLE_GCS_UPLOAD=true
 JUDGE_GCS_BUCKET=
 STORAGE_CONFIG_PATH=configs/judge/storage.yaml
 GOOGLE_APPLICATION_CREDENTIALS=/var/secrets/google/GCP_ACCESS_KEY.json
+OUTPUT_FILENAME_PATTERN=AGENTE_{agent_id}_LLM_JUDGE_{timestamp}.TXT.GZ
 
 # Langfuse per-agent credentials are supplied by the mounted YAML file, not env names.
 LANGFUSE_CREDENTIALS_CONFIG_PATH=/var/secrets/langfuse/langfuse_credentials.yaml

deploy/k8s/base/configmap.yaml

@@ -20,6 +20,7 @@ data:
   BATCH_SIZE: "50"
   MAX_ATTEMPTS: "3"
   ENABLE_GCS_UPLOAD: "true"
+  OUTPUT_FILENAME_PATTERN: "AGENTE_{agent_id}_LLM_JUDGE_{timestamp}.TXT.GZ"
   STORAGE_CONFIG_PATH: "configs/judge/storage.yaml"
   ADB_TABLE_PREFIX: "AGENTFW"
   ADB_WALLET_LOCATION: "/opt/oracle/wallet"

evaluator/config/settings.py

@@ -71,6 +71,10 @@ class Settings(BaseSettings):
     trace_prompt_path: str = Field(default="configs/judge/trace_metrics.yaml", validation_alias="TRACE_PROMPT_PATH")
     session_prompt_path: str = Field(default="configs/judge/session_metrics.yaml", validation_alias="SESSION_PROMPT_PATH")
     output_dir: str = Field(default="output", validation_alias="OUTPUT_DIR")
+    output_filename_pattern: str = Field(
+        default="AGENTE_{agent_id}_LLM_JUDGE_{timestamp}.TXT.GZ",
+        validation_alias="OUTPUT_FILENAME_PATTERN",
+    )
     batch_size: int = Field(default=50, validation_alias="BATCH_SIZE")
     max_attempts: int = Field(default=3, validation_alias="MAX_ATTEMPTS")
     context_turn_limit: int = Field(default=6, validation_alias="CONTEXT_TURN_LIMIT")

evaluator/output/legacy_exporter.py

@@ -106,11 +106,36 @@ def _session_loop_map(rows) -> dict[str, int]:
     return {sid: max_consecutive_intent_streak(items) for sid, items in grouped.items()}
 
 
+def build_output_filename(
+    agent_id: str,
+    run_id: str,
+    now_brt: datetime,
+    pattern: str | None = None,
+) -> str:
+    """Build the export filename from the environment-configurable template."""
+    template = pattern or settings.output_filename_pattern
+    try:
+        filename = template.format(
+            agent_id=agent_id,
+            run_id=run_id,
+            timestamp=now_brt.strftime("%Y%m%d_%H%M%S"),
+        )
+    except KeyError as exc:
+        raise ValueError(
+            f"Unknown placeholder {exc} in OUTPUT_FILENAME_PATTERN. "
+            "Supported placeholders: {agent_id}, {run_id}, {timestamp}."
+        ) from exc
+
+    if not filename or Path(filename).name != filename or filename in {".", ".."}:
+        raise ValueError("OUTPUT_FILENAME_PATTERN must produce a filename without directories")
+    return filename
+
+
 def export_legacy_txt_gz(repo: EvaluationRepository, run_id: str, agent_id: str) -> Path:
     output_dir = settings.path(settings.output_dir)
     output_dir.mkdir(parents=True, exist_ok=True)
     now_brt = datetime.now(ZoneInfo("America/Sao_Paulo"))
-    path = output_dir / f"AGENTE_{agent_id}_LLM_JUDGE_{now_brt.strftime('%Y%m%d_%H%M%S')}.TXT.GZ"
+    path = output_dir / build_output_filename(agent_id, run_id, now_brt)
 
     with repo.store.connect() as conn:
         cur = conn.cursor()