FAQ

Overview

Frequently asked questions about Zof Console, 59 questions organized by topic. For operational issues, see Troubleshooting.

General

What is Zof Console?

The web control plane for autonomous reliability infrastructure: tests, agents, runs, governance, and remediation under enterprise policy.

How is Console different from Zof Studio?

Console operates reliability workflows; Studio governs code authoring sessions and organizational development standards.

Do I need agents to use Console?

No for basic project setup and generation. Agents are required for fleet and endpoint execution at scale.

What browsers are supported?

Modern Chromium, WebKit, and Firefox releases. Verify your organization QA matrix for supported versions.

Is there an on-premise Console?

Dedicated enterprise deployment options are available, contact your account team for architecture and compliance documentation.

Is Zof only for QA teams?

No. QA, SRE, platform engineering, release management, and engineering leadership all use persona-aligned Console surfaces.

Getting started

How do I create an account?

Sign up with corporate email or SSO. Complete email verification if required by your organization.

How do I get started after login?

Use the onboarding wizard or Getting Started documentation to create your first project and run validation.

What is the onboarding wizard?

A guided multi-step setup covering organization, applications, integrations, and your first run.

Can I skip onboarding?

Yes. Steps are skippable where policy allows; you can create projects manually from Console Home.

What is Demo Mode?

Internal authorized users can view sample tenant data without affecting production tenant records.

How long does first setup take?

Most teams complete account, project, requirements upload, review, and first run in 30-60 minutes using Quickstart.

Console

What is Console Home?

Persona-based operational landing with metrics, quick actions, and role-aware navigation emphasis.

What is the command palette?

Keyboard-driven navigation (⌘K / Ctrl+K) to jump to Console surfaces, projects, and actions quickly.

Where did Results go?

Results are integrated into Runs as a tab and run detail view for unified execution triage.

What is Test Health?

Failure analysis, flakiness detection, and quarantine workflows, formerly branded Signal Quality.

What is Topology?

The Console System Graph view of service dependencies, change impact, and coverage context.

Projects and applications

What is a project?

The primary container for scenarios, cases, runs, and results organizing a reliability initiative.

How is an application different from a project?

The application is the system under test; the project organizes tests and runs for that initiative.

Can one application have multiple projects?

Yes. Link multiple projects to the same application for different release trains or teams.

What file types can I upload?

PDF, DOC, DOCX, PNG, and JPG within documented size limits (typically 10MB on project create).

What is a specification?

A versioned requirements document in the Specifications module driving generation and traceability.

Test generation

How are tests generated?

AI-assisted generation from requirements and selected test types, with human review before release-critical use.

How long does generation take?

Variable by document size and categories selected; progress appears in the project wizard and generation views.

Should I trust generated tests?

Always human-review before release-critical reliance. Generated output is a starting point, not a substitute for QA judgment.

Can I edit generated tests?

Yes, in the project wizard and test library before and after execution.

How do I regenerate?

Trigger regeneration from test types or generation workflows after updating requirements or scope.

Test scenarios and cases

What is a test scenario?

A workflow-level behavior to validate, linked to test types and requirements.

What is a test case?

Executable steps with expected outcomes, priority, and platform metadata.

What is a test suite?

An ordered collection of cases for batch execution, regression, or scheduled validation.

What platforms are supported?

Platform metadata on cases includes web, API, desktop, and agent-specific targets, verify enum values in your tenant.

Test execution

How do I run a test?

From Runs, project wizard, schedules, or Agent Console launch depending on application type.

Where do tests execute?

Console-orchestrated runs via cloud agents, endpoint agents, or environment-specific runners per policy.

Does Zof use Playwright for my app?

Customer validation paths vary by agent and application type. Playwright is used for Console QA, not necessarily your runner path.

How do I schedule runs?

Operate → Schedules with cron expressions targeting suites or case sets.

Can I cancel a run?

Yes when status allows, via run detail or Runs API cancel operation.

Agents

What are AI testing agents?

Specialized catalog agents for validation categories, accessibility, API, security, E2E, and more.

What is Agent Console?

Operational surface for cloud and endpoint execution fleets, not the Zof Console product name.

Cloud vs endpoint agents?

Cloud agents run in Zof-managed runtime; endpoint agents run on customer-controlled infrastructure.

How are agents targeted?

Via policy, labels, capabilities, environment, and application availability.

How many agents ship with Zof?

Extensive catalog spanning testing, remediation, and orchestration agents, enable per organization policy.

Results and reports

Where are results?

Runs → Results tab and run detail with per-case outcomes and artifacts.

What artifacts are stored?

Logs, screenshots, traces, and exports, availability varies by execution path and agent type.

How do reports differ from runs?

Reports aggregate metrics and trends across runs for stakeholder and release review.

Remediation

What is governed remediation?

AI-proposed fixes with policy constraints, human approval, verification, and audit trails.

Can remediation auto-apply without approval?

Policy-dependent; public documentation assumes human authorization before apply.

Where do I approve fixes?

Governance → Remediation → Approvals queue for authorized approvers.

System Graph

What is the System Graph?

Graph of assets, dependencies, and change for impact analysis and coverage planning.

Is Topology live data?

Depends on deployment configuration, verify with your account team if graph is wired to your CMDB.

Zof Studio

What is Zof Studio?

Governed development environment with web workspace and optional desktop surfaces.

Do I need desktop Studio?

Optional; web workspace covers many authoring workflows under organizational policy packs.

Security

How does authentication work?

Better Auth sessions with OAuth providers and email OTP; CLI uses device authorization.

Is data isolated per organization?

Yes, tenant-scoped isolation with RBAC managed in Admin Center.

Where are uploads stored?

Encrypted object storage with organization-scoped access controls.

Integrations

Which integrations are available?

GitHub, GitLab, Jira, Slack, Linear, Azure DevOps, and more, verify connect flow status per provider in your tenant.

GitHub OAuth for login or integration?

Both, login via Better Auth; repository integration is a separate Admin Center connection.

Billing

How do credits work?

Usage credits and ledger entries apply to generation and execution, see billing settings with your billing admin.

Where do I manage subscription?

Plans and billing settings in Admin Center for authorized billing administrators.

Troubleshooting

Why is generation stuck?

Check requirements attachment, test types selection, and retry after delay; contact support with project ID if persistent.

Why are agents offline?

Verify endpoint connectivity, agent process health, and Agent Console telemetry.

Who do I contact for support?

In-app support, your organization admin, and published support channels at zof.ai/support.