Skip to content
Ishvana Ishvana Docs

Get Comprehensive Collaboration Metrics

GET
/api/analytics/collaboration/metrics

Retrieve complete collaboration analytics with consultations and success rates

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
hours
Hours

Time window in hours

integer
default: 24 >= 1 <= 168

Time window in hours

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

CollaborationMetrics

Aggregated collaboration metrics for analysis.

Provides summary statistics for agent collaboration patterns including consultation rates, response times, and success rates for collaboration analytics and performance optimization.

Fields:

  • total_events: Total number of collaboration events (non-negative integer)
  • consultation_count: Number of consultation events (non-negative integer)
  • handoff_count: Number of agent handoff events (non-negative integer)
  • collaboration_count: Number of multi-agent collaboration events (non-negative integer)
  • average_response_time: Average response time for consultations in seconds (non-negative)
  • success_rate: Overall collaboration success rate (0.0-1.0)
  • most_active_agents: Most frequently collaborating agents (list of agent IDs)
  • collaboration_pairs: Common agent collaboration pairs with counts (dict mapping pair to count)
  • timestamp: When metrics were calculated (ISO 8601 datetime)

Usage: Used in ODIComprehensiveReport to provide collaboration metrics for pattern analysis and synergy assessment.

JSON Example:

{
  "totalEvents": 150,
  "consultationCount": 100,
  "handoffCount": 30,
  "collaborationCount": 20,
  "averageResponseTime": 2.5,
  "successRate": 0.95,
  "mostActiveAgents": ["HAWKEN", "LAGAN", "ORCHESTRATOR"],
  "collaborationPairs": {
    "HAWKEN-LAGAN": 45,
    "LAGAN-ORCHESTRATOR": 30,
    "HAWKEN-ORCHESTRATOR": 25
  },
  "timestamp": "2025-01-30T10:00:00Z"
}
object
totalEvents
required
Totalevents

Total number of collaboration events

integer
consultationCount
required
Consultationcount

Number of consultation events

integer
handoffCount
required
Handoffcount

Number of agent handoff events

integer
collaborationCount
required
Collaborationcount

Number of multi-agent collaboration events

integer
averageResponseTime
required
Averageresponsetime

Average response time for consultations in seconds

number
successRate
required
Successrate

Overall collaboration success rate (0.0-1.0)

number
<= 1
mostActiveAgents
Mostactiveagents

Most frequently collaborating agents

Array<string>
collaborationPairs
Collaborationpairs

Common agent collaboration pairs with counts

object
key
additional properties
integer
timestamp
Timestamp

When metrics were calculated

string format: date-time

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object