# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Thehiveryiq Com R7 Spectral API
  version: 1.0.0
extends: openapi/thehiveryiq-com-r7-spectral-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/v1/spectral/policy'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the spectral monitoring policy
      effect: read
      questions:
      - What thresholds does spectral behaviour monitoring use to flag agents?
      - Which policy governs spectral anomaly alerts?
      instructions:
      - text: Show me the spectral policy.
      - text: Get the current spectral monitoring rules.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/spectral/stats'].get
  update:
    x-apievangelist-phrasing:
      intent: Get spectral monitoring statistics
      effect: read
      questions:
      - How many agents and observations is spectral monitoring tracking?
      - Are there overall stats for spectral alerts?
      instructions:
      - text: Get spectral monitoring stats.
      - text: Summarize spectral observation and alert totals.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/spectral/observe'].post
  update:
    x-apievangelist-phrasing:
      intent: Record an agent behaviour observation
      effect: write
      questions:
      - How do I log what an agent just did so its behaviour baseline updates?
      - Can I record spend, latency and counterparty for each agent call?
      instructions:
      - text: Record an observation for agent {agent_did}.
        slots:
          agent_did: requestBody.agent_did
      - text: Log that {agent_did} called {endpoint} spending {spend_usd} USD with {counterparty_did}.
        slots:
          agent_did: requestBody.agent_did
          endpoint: requestBody.endpoint
          spend_usd: requestBody.spend_usd
          counterparty_did: requestBody.counterparty_did
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/spectral/evaluate'].post
  update:
    x-apievangelist-phrasing:
      intent: Score whether an agent action looks anomalous
      effect: read
      questions:
      - Is this agent call unusual compared with its normal behaviour?
      - Can I evaluate an action for anomalies without saving it as an observation?
      instructions:
      - text: Evaluate whether a call by {agent_did} to {endpoint} for {spend_usd} USD is anomalous.
        slots:
          agent_did: requestBody.agent_did
          endpoint: requestBody.endpoint
          spend_usd: requestBody.spend_usd
      - text: Score agent {agent_did}'s action against its fingerprint and set persist to {persist_observation}.
        slots:
          agent_did: requestBody.agent_did
          persist_observation: requestBody.persist_observation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/spectral/{agent_did}/observations'].get
  update:
    x-apievangelist-phrasing:
      intent: List an agent's recorded observations
      effect: read
      questions:
      - What recent activity has been recorded for a specific agent?
      - Can I limit how many observations I pull for an agent?
      instructions:
      - text: List observations for agent {agent_did}.
        slots:
          agent_did: path.agent_did
      - text: Show the last {limit} observations recorded for {agent_did}.
        slots:
          limit: query.limit
          agent_did: path.agent_did
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/spectral/{agent_did}/alerts'].get
  update:
    x-apievangelist-phrasing:
      intent: List anomaly alerts for an agent
      effect: read
      questions:
      - Has a particular agent triggered any behaviour anomaly alerts?
      - How do I see the latest spectral alerts for one agent?
      instructions:
      - text: List spectral alerts for {agent_did}.
        slots:
          agent_did: path.agent_did
      - text: Show the {limit} most recent anomaly alerts for agent {agent_did}.
        slots:
          limit: query.limit
          agent_did: path.agent_did
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/spectral/{agent_did}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an agent's behaviour fingerprint
      effect: read
      questions:
      - What does an agent's normal behaviour profile look like?
      - How do I fetch the spectral fingerprint of an agent?
      instructions:
      - text: Get the spectral fingerprint for agent {agent_did}.
        slots:
          agent_did: path.agent_did
      - text: Show me {agent_did}'s behavioural baseline.
        slots:
          agent_did: path.agent_did
      method: generated
      generated: '2026-09-26'