Intelligence Client

The IntelligenceClient provides access to agent analytics signals, rollups, and AI-generated improvement suggestions.

Python
TypeScript

zaby.intelligence  # → IntelligenceClient

zaby.intelligence; // → IntelligenceClient

Signals

Retrieve timestamped analytics events from agent interactions.

Python
TypeScript

signals = await zaby.intelligence.list_signals({
    "agentId": "a1b2c3d4-...",
    "type": "user_feedback",
    "limit": 100,
})

const signals = await zaby.intelligence.listSignals({
  agentId: "a1b2c3d4-...",
  type: "user_feedback",
  limit: 100,
});

agentId

string

Filter by agent

type

string

Signal type filter

limit

number

Max results

Rollups

Aggregated metrics derived from raw signals.

Python
TypeScript

rollups = await zaby.intelligence.list_rollups({
    "agentId": "a1b2c3d4-...",
    "granularity": "daily",
    "metric": "avg_response_time",
})

const rollups = await zaby.intelligence.listRollups({
  agentId: "a1b2c3d4-...",
  granularity: "daily",
  metric: "avg_response_time",
});

agentId

string

required

Agent to query

granularity

string

One of “hourly”, “daily”, “weekly”, “monthly”

metric

string

Metric name (e.g. “avg_response_time”)

Improvements

AI-generated suggestions for improving agent behavior, based on signal analysis.

List

Python
TypeScript

improvements = await zaby.intelligence.list_improvements({
    "agentId": "a1b2c3d4-...",
})

const improvements = await zaby.intelligence.listImprovements({
  agentId: "a1b2c3d4-...",
});

Approve

candidate_id

string

required

Improvement candidate identifier

Python
TypeScript

await zaby.intelligence.approve_improvement(candidate_id, {
    "status": "IMPLEMENTED",
})

await zaby.intelligence.approveImprovement(candidate_id, {
  status: "IMPLEMENTED",
});

Reject

Python
TypeScript

await zaby.intelligence.reject_improvement(candidate_id, {
    "reason": "Not applicable",
})

await zaby.intelligence.rejectImprovement(candidate_id, {
  reason: "Not applicable",
});

Example

Python
TypeScript

import asyncio
from zaby import Zaby

async def main():
    zaby = Zaby(api_key="zaby_pk_...")

    signals = await zaby.intelligence.list_signals({
        "agentId": "a1b2c3d4-...",
        "type": "user_feedback",
    })

    improvements = await zaby.intelligence.list_improvements({
        "agentId": "a1b2c3d4-...",
    })

    for imp in improvements:
        await zaby.intelligence.approve_improvement(imp["id"], {
            "status": "IMPLEMENTED",
        })

asyncio.run(main())

import { Zaby } from "@zaby-ai/sdk";

async function main() {
  const zaby = new Zaby({ apiKey: "zaby_pk_..." });

  const signals = await zaby.intelligence.listSignals({
    agentId: "a1b2c3d4-...",
    type: "user_feedback",
  });

  const improvements = await zaby.intelligence.listImprovements({
    agentId: "a1b2c3d4-...",
  });

  for (const imp of improvements.items ?? []) {
    await zaby.intelligence.approveImprovement(imp.id, {
      status: "IMPLEMENTED",
    });
  }
}

main();

Getting Started

Clients

Guides

Intelligence Client

Intelligence Client

Signals

Rollups

Improvements

List

Approve

Reject

Example

​Intelligence Client

​Signals

​Rollups

​Improvements

​List

​Approve

​Reject

​Example

Intelligence Client

Signals

Rollups

Improvements

List

Approve

Reject

Example