Agentic SaaS Operations

// Published at https://agents.acme.com/.well-known/agent-card.json
{
  "name": "GASP Retention Analyst",
  "description": "Diagnoses retention trends using the GASP Standard knowledge graph. Traces NRR, GRR, churn and expansion through upstream drivers to root causes.",
  "version": "1.0.0",
  "provider": {
    "organization": "Acme SaaS",
    "url": "https://acme.com"
  },
  "capabilities": {
    "streaming": true,
    "pushNotifications": false
  },
  "defaultInputModes": ["text/plain", "application/json"],
  "defaultOutputModes": ["text/plain", "application/json"],
  "skills": [
    {
      "id": "nrr_diagnostic",
      "name": "NRR Diagnostic",
      "description": "Trace an NRR change to its root cause using the GASP relationship graph and adapter mapping.",
      "tags": ["retention", "nrr", "churn", "gasp"],
      "examples": [
        "Why did NRR drop from 115% to 108% this quarter?",
        "Which cohort is driving the contraction increase?"
      ]
    },
    {
      "id": "churn_cohort_analysis",
      "name": "Churn Cohort Analysis",
      "description": "Segment churned customers by acquisition cohort and correlate with product usage metrics.",
      "tags": ["churn", "cohort", "product-usage", "gasp"],
      "examples": [
        "Compare churn rates across Q1 and Q2 acquisition cohorts"
      ]
    },
    {
      "id": "revenue_quality",
      "name": "Revenue Quality Assessment",
      "description": "Compute Adjusted NRR using CEL change_nature to separate permanent movements from temporary ones.",
      "tags": ["nrr", "revenue-quality", "change-nature", "gasp"],
      "examples": [
        "What is our Adjusted NRR excluding temporary upgrades?"
      ]
    }
  ],
  "supportedInterfaces": [
    {
      "url": "https://agents.acme.com/retention",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "0.3"
    }
  ]
}

// Coordinator → Retention Analyst (POST /message:send)
{
  "jsonrpc": "2.0",
  "id": "req-001",
  "method": "SendMessage",
  "params": {
    "message": {
      "messageId": "msg-coord-001",
      "role": "user",
      "parts": [
        {
          "text": "NRR dropped from 115% to 108% in Q1. Diagnose the root cause. Use the GASP relationship graph to trace upstream drivers and generate SQL from the adapter."
        }
      ]
    },
    "configuration": {
      "acceptedOutputModes": ["application/json"],
      "blocking": true
    }
  }
}

// Response
{
  "jsonrpc": "2.0",
  "id": "req-001",
  "result": {
    "id": "task-ret-001",
    "status": { "state": "completed" },
    "artifacts": [
      {
        "name": "nrr_diagnostic",
        "parts": [{
          "data": {
            "finding": "Contraction concentrated in mid-market segment",
            "driver": "Feature Adoption dropped 30% in 90 days before contraction",
            "metrics_traced": ["nrr", "contraction_mrr", "health_score", "feature_adoption"],
            "metric_owner": "Finance (jane@acme.com)",
            "sql_generated": true,
            "adapter_fields_used": ["account_id", "mrr_start", "mrr_end", "usage_score"]
          },
          "mediaType": "application/json"
        }]
      }
    ]
  }
}

# gasp-retention-analyst.ossa.yaml
apiVersion: ossa/v0.5.0
kind: Agent
metadata:
  name: gasp-retention-analyst
  version: 1.0.0
  description: >
    Diagnoses retention trends using the GASP Standard knowledge
    graph. Traces NRR through upstream drivers to root causes
    and generates warehouse-specific SQL via the adapter.
  labels:
    domain: saas-metrics
    team: finance
  identity:
    namespace: acme/analytics
    agent_id: retention-analyst-v1
    publisher:
      name: Acme SaaS
      email: data-team@acme.com

spec:
  role: |
    You are a SaaS retention analyst. You use the GASP Standard
    to diagnose retention trends. Always trace metrics through
    the relationship graph before generating SQL. Reference
    canonical definitions, not inferred ones.
  llm:
    provider: anthropic
    model: claude-sonnet-4-20250514
    temperature: 0.2
    profile: deep
  tools:
    - type: mcp
      name: gasp-standard
      description: GASP Standard metrics, relationships, formulas

protocols:
  mcp:
    version: "1.0.0"
    role: client
    servers:
      - name: gasp-standard
        transport: stdio
        command: npx
        args: ["-y", "gasp-standard-mcp"]
        capabilities:
          tools: true
          resources: false
  a2a:
    version: "0.3"
    endpoint: https://agents.acme.com/retention
    agent_card:
      name: GASP Retention Analyst
      description: NRR diagnostics powered by the GASP Standard
      skills:
        - id: nrr_diagnostic
          name: NRR Diagnostic
          tags: [retention, nrr, churn, gasp]
        - id: churn_cohort_analysis
          name: Churn Cohort Analysis
          tags: [churn, cohort, gasp]
        - id: revenue_quality
          name: Revenue Quality Assessment
          tags: [nrr, revenue-quality, gasp]
    capabilities:
      streaming: true

security:
  tier: tier_1_read
  data_classification: internal
  capabilities:
    required:
      - network    # call MCP server
      - database   # read-only warehouse access
  audit:
    log_tool_calls: true
    retention_days: 90

governance:
  compliance:
    frameworks: [SOC2]
    audit_logging_required: true
  authorization:
    tool_permissions:
      - tool: generate_query
        access: read
      - tool: validate_adapter
        access: read