feat(docs): add AI agent setup and usage documentation

[floreks]

• Introduced new sections for AI agent configuration, remote browser setup, and operational workflows.
• Included new images for agent run processes.

TODO

• - regenerate api reference docs after feat(agent-runtime): add support for browser sidecar to agent runtime deployment-operator#648 gets merged
• - add references to updated agent runtime crd to agent ai docs

Plural Flow: docs
Plural Preview: docs

[plural-copilot]

✅ Deploy preview for docs-pr-569 is ready!

Name	Details
⚡ Service	docs-pr-569 (5 / 5 ready)
☁️ Cluster	plural (eks)
Commit sha	ee0aae3
Plural URL	https://console.mgmt.plural.sh/cd/clusters/446acdef-8524-425a-a49f-5336a...
🔍 Logs URL	https://console.mgmt.plural.sh/cd/clusters/446acdef-8524-425a-a49f-5336a...
🌊 Flow URL	https://console.mgmt.plural.sh/flows/08a17af1-8578-449e-9ae1-28ccd97eafc...
Preview Link	Preview

---

You can learn more about preview environments and Plural Flows here

[michaeljguarino]

let's add some docs on how to add network policies to the runtime, and perhaps tune resources.

[floreks]

Do you mean something like that?

apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
  name: agent-runtime-egress
  namespace: plrl-agents
spec:
  podSelector: {}
  policyTypes:
    - Egress
  egress:
    # AI provider (replace with your approved endpoint ranges)
    - to:
        - ipBlock:
            cidr: 104.16.0.0/12
      ports:
        - protocol: TCP
          port: 443

Should it be targeted namespace-wide or based on custom label added to the runtime pod spec?

[michaeljguarino]

yea exactly, and it can be either way, namespace wide is simplest to explain probably

[greptile-apps]

Greptile Overview

Greptile Summary

Added comprehensive AI agent documentation covering setup, configuration, and remote browser testing. The new documentation introduces three main sections: an overview of AI Background Agent capabilities, detailed agent runtime configuration with resource tuning and network policies, and extensive remote browser setup guidance for E2E testing with Playwright, Puppeteer, Selenium, and Cypress.

Key additions:

• New AI agent overview explaining supported providers (Claude Code, OpenCode, Gemini) and use cases
• AgentRuntime configuration examples with resource limits and DinD support
• Remote browser sidecar configuration with multiple browser options
• Practical Docker Compose examples for containerized testing workflows
• API reference updates for BrowserConfig, Browser enum, and ObserverAgentAction
• Three new UI screenshots showing the agent runs workflow

Minor issue found: NetworkPolicy example documentation references ipBlock entries that aren't present in the YAML example.

Confidence Score: 5/5

• This PR is safe to merge - it only adds documentation with one minor inconsistency
• Documentation-only PR with well-structured content, comprehensive examples, and proper cross-references. The single issue found is a minor documentation inconsistency that doesn't affect functionality
• pages/plural-features/plural-ai/ai-agent/configure-agent.md has a minor documentation inconsistency

Important Files Changed

Filename	Overview
pages/plural-features/plural-ai/ai-agent/index.md	New AI agent overview documentation - clear structure, good use cases, proper cross-references
pages/plural-features/plural-ai/ai-agent/configure-agent.md	Agent configuration guide with YAML examples - includes inconsistency in NetworkPolicy documentation
pages/plural-features/plural-ai/ai-agent/remote-browser.md	Comprehensive remote browser setup guide with practical examples for multiple test frameworks
pages/api-reference/kubernetes/agent-api-reference.md	API reference updated with new BrowserConfig and Browser enum documentation

[floreks]

@michaeljguarino PTAL

[greptile-apps]

_{10 files reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}