Knowledge Portal · engineering documentation

Skip to content

Federated from workspace · PRD-000 · zaixos-company-platform/docs/technical/ZAIXOS_AGENT_OPERATIONS_CENTER.md Do not edit canonical truth here — update the source repo, then re-run npm run docs:sync.


ZAIXOS Enterprise Agent Operations Center

Repository: PRD-000 (zaixos-company-platform)
Module: Integration
Navigation: Admin → AI Engineering
Authority: ADR-001-agent-operations-center.md

Purpose

Presentation-only engineering control plane for all ZAIXOS AI agents. This is not a runtime, not PL-007, and not a redesign of PL-003/004/005/006.

Pages

#PageAdapter
1OverviewAgentOperationsOverviewAdapter
2AgentsAgentRegistryReadAdapter
3CapabilitiesCapabilityRegistryReadAdapter
4ObservabilityObservabilityReadAdapter
5Learning DatasetAgentLearningDatasetReadContract
6BenchmarkAgentBenchmarkReadContract
7RegressionRegressionReadAdapter
8Acceptance LabAcceptanceLabReadAdapter
9RecommendationsRecommendationsReadAdapter
10Release CenterReleaseCenterReadAdapter
11VersionsVersionsReadAdapter
12GovernanceGovernanceReadAdapter

Access

bash
# Admin panel (requires authenticated user)
open http://localhost/admin

# Optional email allowlist
AGENT_OPS_ALLOWED_EMAILS=engineer@zaixos.com
AGENT_OPS_REQUIRE_AUTH=true

Cross-product data sync (PRD-001 → PRD-000)

Federation uses AgentOperationsFederationReadContract (PL-003 contracts) over versioned JSON bundles:

bash
# PRD-001 — export federation bundle
php artisan ai:agent-ops:export
# Optional: --target=/path/to/share

# PRD-000 — sync into ingest path
php artisan ai:agent-ops:sync --from=/path/to/prd-001/export

Manifest: manifest.json (schema 1.0.0) with benchmark reports + learning export paths.

Environment overrides:

env
# PRD-001
AI_AGENT_OPS_EXPORT_PATH=/path/to/agent-ops-federation/prd-001

# PRD-000
AGENT_OPS_FEDERATION_PATH=storage/agent-ops/federation
AGENT_OPS_PRD001_EXPORT_PATH=/path/to/prd-001/export
AGENT_OPS_BENCHMARK_PATH=/path/to/benchmark/reports   # legacy fallback
AGENT_OPS_LEARNING_EXPORT=/path/to/learning/export.json

Security

  • Filament: authenticated session required.
  • Internal API: auth middleware on /internal/ai-observability/*.
  • Read-only by default; approval actions deferred to future phase.

Architecture tests

bash
php artisan test app/Modules/Integration/Tests/Unit/AgentOperationsCenterTest.php

ZAIXOS Knowledge Portal — public engineering docs at /docs · Staff operations at /admin