Intelligence Client
The IntelligenceClient provides access to agent analytics signals, rollups, and AI-generated improvement suggestions.
zaby.intelligence # → IntelligenceClient
zaby.intelligence; // → IntelligenceClient
Signals
Retrieve timestamped analytics events from agent interactions.
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,
});
Rollups
Aggregated metrics derived from raw signals.
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",
});
One of “hourly”, “daily”, “weekly”, “monthly”
Metric name (e.g. “avg_response_time”)
Improvements
AI-generated suggestions for improving agent behavior, based on signal analysis.
List
improvements = await zaby.intelligence.list_improvements({
"agentId": "a1b2c3d4-...",
})
const improvements = await zaby.intelligence.listImprovements({
agentId: "a1b2c3d4-...",
});
Approve
Improvement candidate identifier
await zaby.intelligence.approve_improvement(candidate_id, {
"status": "IMPLEMENTED",
})
await zaby.intelligence.approveImprovement(candidate_id, {
status: "IMPLEMENTED",
});
Reject
await zaby.intelligence.reject_improvement(candidate_id, {
"reason": "Not applicable",
})
await zaby.intelligence.rejectImprovement(candidate_id, {
reason: "Not applicable",
});
Example
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();
