From c06325f8389c622d42751250e80632156a10604c Mon Sep 17 00:00:00 2001 From: Hong Yi Chen Date: Tue, 19 May 2026 15:09:40 -0700 Subject: [PATCH] =?UTF-8?q?docs(audit):=20tier=201=20=E2=80=94=20terminolo?= =?UTF-8?q?gy=20drift=20+=20orchestration=20cross-link?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cleanup after the orchestration-launch + multi-agent merges: * warp-hosting.mdx - drop 'Oz' prefix from description and body; remove 'easily' per style guide. * enterprise/analytics-api.mdx:139 - '(Oz cloud agents)' -> '(cloud agents)'. * reference/cli/artifacts.mdx:4 - 'produced by an Oz agent run' -> 'by an agent run'. * privacy.mdx telemetry table (4x) - 'ambient agent' -> 'cloud agent' in event descriptions. The literal event names in the left column (AmbientAgent.*, CLI.Execute.Agent.RunAmbient) stay as-is since they're emitted by product code. * warp-for-product-managers.mdx - '5 AI agent workflows…' -> '5 agent workflows…' (drop redundant 'AI' prefix). * cloud-agents/overview.mdx - add Multi-agent orchestration bullet to the Learn more list (was missing after PR #84 landed). Validation: 0 broken links / 2577 internal, lint clears all 11 previously-flagged OZ-TERM warnings, 332 pages build clean. Co-Authored-By: Oz --- src/content/docs/agent-platform/cloud-agents/overview.mdx | 1 + .../docs/agent-platform/cloud-agents/warp-hosting.mdx | 4 ++-- .../docs/enterprise/enterprise-features/analytics-api.mdx | 2 +- .../guides/agent-workflows/warp-for-product-managers.mdx | 2 +- src/content/docs/reference/cli/artifacts.mdx | 2 +- .../privacy-and-security/privacy.mdx | 8 ++++---- 6 files changed, 10 insertions(+), 9 deletions(-) diff --git a/src/content/docs/agent-platform/cloud-agents/overview.mdx b/src/content/docs/agent-platform/cloud-agents/overview.mdx index 4c35494b..bea6ae94 100644 --- a/src/content/docs/agent-platform/cloud-agents/overview.mdx +++ b/src/content/docs/agent-platform/cloud-agents/overview.mdx @@ -146,6 +146,7 @@ If your credit balance reaches zero, cloud agent runs will not be able to execut * [Oz Platform](/agent-platform/cloud-agents/platform/) — CLI, Oz API/SDK, orchestration, tasks, environments, hosts, integrations, and more. * [Harnesses](/agent-platform/cloud-agents/harnesses/) — pick between Warp Agent, Claude Code, and Codex for any cloud agent run. * [Agent identities](/agent-platform/cloud-agents/agents/) — team-scoped bot accounts that own and execute cloud agent runs. +* [Multi-agent orchestration](/agent-platform/cloud-agents/orchestration/) — coordinate a parent agent and its child agents across local and cloud runs to build supervisor/worker, fan-out, critic, DAG, and swarm workflows. * [Skills as Agents](/agent-platform/cloud-agents/skills-as-agents/) — run agents based on reusable skill definitions from the CLI, web app, API, or on a schedule. * [Oz CLI](/reference/cli/) — shows how to run agents in non-interactive mode from CI, scripts, or remote machines, including auth and common commands. * [Environments](/agent-platform/cloud-agents/environments/) — explains how environments provide the runtime context (repo, image, startup commands) for agent tasks. diff --git a/src/content/docs/agent-platform/cloud-agents/warp-hosting.mdx b/src/content/docs/agent-platform/cloud-agents/warp-hosting.mdx index ceae7b49..80e02b72 100644 --- a/src/content/docs/agent-platform/cloud-agents/warp-hosting.mdx +++ b/src/content/docs/agent-platform/cloud-agents/warp-hosting.mdx @@ -1,12 +1,12 @@ --- title: Warp-hosted agents description: >- - Run Oz cloud agents on Warp's infrastructure. Warp handles scaling, isolation, and performance for agent execution. + Run cloud agents on Warp's infrastructure. Warp handles scaling, isolation, and performance for agent execution. sidebar: label: "Warp-hosted agents" --- -Warp's managed infrastructure lets your team easily run Oz cloud agent workloads in fast and secure sandboxes. +Warp's managed infrastructure lets your team run cloud agent workloads in fast, secure sandboxes. Use Warp-hosted agents to quickly get started with Oz, without needing to configure compute resources or maintain services. diff --git a/src/content/docs/enterprise/enterprise-features/analytics-api.mdx b/src/content/docs/enterprise/enterprise-features/analytics-api.mdx index efca6a15..36688e05 100644 --- a/src/content/docs/enterprise/enterprise-features/analytics-api.mdx +++ b/src/content/docs/enterprise/enterprise-features/analytics-api.mdx @@ -136,7 +136,7 @@ In the grouped response, every leaf array is the same length as `period_list`, a ### `GET /api/v1/enterprises/analytics/users` -Returns per-user aggregated usage, split into `local` (Warp app) and `cloud` (Oz cloud agents) sections. Results are paginated. +Returns per-user aggregated usage, split into `local` (Warp app) and `cloud` (cloud agents) sections. Results are paginated. **Query parameters:** diff --git a/src/content/docs/guides/agent-workflows/warp-for-product-managers.mdx b/src/content/docs/guides/agent-workflows/warp-for-product-managers.mdx index bac5158b..a919f6ce 100644 --- a/src/content/docs/guides/agent-workflows/warp-for-product-managers.mdx +++ b/src/content/docs/guides/agent-workflows/warp-for-product-managers.mdx @@ -1,5 +1,5 @@ --- -title: "5 AI agent workflows for product managers" +title: "5 agent workflows for product managers" description: >- Five agent workflows that automate status updates, documentation, Slack search, and meeting prep for product managers. diff --git a/src/content/docs/reference/cli/artifacts.mdx b/src/content/docs/reference/cli/artifacts.mdx index b497da97..4a8ada78 100644 --- a/src/content/docs/reference/cli/artifacts.mdx +++ b/src/content/docs/reference/cli/artifacts.mdx @@ -1,7 +1,7 @@ --- title: Artifacts description: >- - Get metadata for and download files produced by an Oz agent run using the + Get metadata for and download files produced by an agent run using the `oz artifact` subcommands. sidebar: label: "Artifacts" diff --git a/src/content/docs/support-and-community/privacy-and-security/privacy.mdx b/src/content/docs/support-and-community/privacy-and-security/privacy.mdx index 72030507..7c4f23f4 100644 --- a/src/content/docs/support-and-community/privacy-and-security/privacy.mdx +++ b/src/content/docs/support-and-community/privacy-and-security/privacy.mdx @@ -114,9 +114,9 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `AgentManagement.ConversationOpened` | User opened a conversation | | `AgentManagement.DetailsPanelContinueLocally` | User clicked Continue locally in the details panel | | `AgentManagement.DetailsViewed` | User clicked View details | -| `AgentManagement.DismissSetupGuide` | User dismissed the ambient agent setup guide | +| `AgentManagement.DismissSetupGuide` | User dismissed the cloud agent setup guide | | `AgentManagement.FilterChanged` | User changed a filter in the management view | -| `AgentManagement.OpenSetupGuide` | User opened the ambient agent setup guide | +| `AgentManagement.OpenSetupGuide` | User opened the cloud agent setup guide | | `AgentManagement.SessionLinkCopied` | User copied a session link | | `AgentManagement.SetupGuideDocsLink` | User clicked a docs URL in the setup guide | | `AgentManagement.SetupGuideStepCopy` | User copied a workflow step from the setup guide | @@ -178,7 +178,7 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `AmbientAgent.ConcurrencyModal.Dismissed` | User dismissed the cloud agent capacity modal | | `AmbientAgent.ConcurrencyModal.Opened` | User opened the cloud agent capacity modal | | `AmbientAgent.ConcurrencyModal.UpgradeClicked` | User clicked the upgrade button in the cloud agent capacity modal | -| `AmbientAgent.DispatchFailed` | Ambient agent failed to dispatch or encountered an error | +| `AmbientAgent.DispatchFailed` | Cloud agent failed to dispatch or encountered an error | | `AmbientAgent.EnvironmentSettings.CreatedEnvironment` | User created a new environment | | `AmbientAgent.EnvironmentSettings.DeletedEnvironment` | User deleted an environment | | `AmbientAgent.EnvironmentSettings.Image.Suggested` | Docker image was suggested for an environment | @@ -214,7 +214,7 @@ If you're a [Team](/knowledge-and-collaboration/teams/) admin, the deletion flow | `CLI.Execute.Agent.List` | Listed agents from the Warp CLI | | `CLI.Execute.Agent.Profile.List` | Listed agent profiles from the Warp CLI | | `CLI.Execute.Agent.Run` | Ran an agent from the Warp CLI | -| `CLI.Execute.Agent.RunAmbient` | Ran an ambient agent from the Warp CLI | +| `CLI.Execute.Agent.RunAmbient` | Ran a cloud agent from the Warp CLI | | `CLI.Execute.Artifact.Download` | Downloaded an artifact from the Warp CLI | | `CLI.Execute.Artifact.Get` | Got artifact metadata from the Warp CLI | | `CLI.Execute.Artifact.Upload` | Uploaded an artifact from the Warp CLI |