Iblai Analytics

/iblai-analytics

Add an analytics dashboard with a tabbed layout (AnalyticsLayout): Overview, Courses, Programs, Users, Topics, Financial, Transcripts, Reports. Each tab is a Next.js route under /analytics/.

> Template: the page this skill creates is bundled as > [assets/analytics-page.tsx.j2](assets/analytics-page.tsx.j2). See > [/iblai-scaffold](../iblai-scaffold/SKILL.md) for the {{ }} contract.

Do NOT add custom styles to ibl.ai SDK components. Do NOT implement dark mode unless asked. Follow the component hierarchy: ibl.ai SDK (@iblai/iblai-js) first, then shadcn/ui (npx shadcn@latest add).

Prerequisites

• Auth set up (/iblai-auth)
• MCP server + skills configured (@iblai/mcp in .mcp.json)
• iblai.env populated with PLATFORM, DOMAIN, TOKEN. If missing:

curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env

Create the Page

Render [assets/analytics-page.tsx.j2](assets/analytics-page.tsx.j2) into app/(app)/analytics/page.tsx (overview only). You create the layout and sub-pages manually (below).

Layout

Wrap pages with AnalyticsLayout + AnalyticsSettingsProvider. The SDK layout uses bg-[#f5f7fb] internally — wrap it in a white card so it pops against the page background.

// app/(app)/analytics/layout.tsx
"use client";

import { AnalyticsLayout, AnalyticsSettingsProvider } from "@iblai/iblai-js/web-containers";
import { usePathname, useRouter } from "next/navigation";

export default function AnalyticsLayoutWrapper({ children }: { children: React.ReactNode }) {
  const pathname = usePathname();
  const router = useRouter();
  const basePath = "/analytics";

  return (
    
      
        
           router.push(tab ? `${basePath}/${tab}` : basePath)}
          >
            {children}
          
        
      
    
  );
}

Sub-pages

All components import from @iblai/iblai-js/web-containers. Pattern:

"use client";
import { useEffect, useState } from "react";
import { AnalyticsCourses } from "@iblai/iblai-js/web-containers";
import { resolveAppTenant } from "@/lib/iblai/tenant";

export default function CoursesPage() {
  const [tenantKey, setTenantKey] = useState("");
  useEffect(() => { setTenantKey(resolveAppTenant()); }, []);
  if (!tenantKey) return null;
  return ;
}

| Route | Component | basePath? | |-------|-----------|-------------| | /analytics | AnalyticsOverview | — | | /analytics/courses | AnalyticsCourses | ✓ | | /analytics/programs | AnalyticsPrograms | ✓ | | /analytics/users | AnalyticsUsersStats | — | | /analytics/topics | AnalyticsTopicsStats | — | | /analytics/financial | AnalyticsFinancialStats | — (does NOT accept basePath) | | /analytics/transcripts | AnalyticsTranscriptsStats | — | | /analytics/reports | AnalyticsReports | — |

All accept tenantKey (required) and mentorId="" ("" = org-wide, not undefined). Use MCP for full props: get_component_info("AnalyticsOverview"), etc.

Verify

pnpm build && pnpm test
pnpm dev &
npx playwright screenshot http://localhost:3000/analytics /tmp/analytics.png

Notes

• Redux store must include mentorReducer and mentorMiddleware.
• initializeDataLayer() takes 5 args (data-layer v1.2+).
• @reduxjs/toolkit deduped via webpack aliases in next.config.ts.
• To override the SDK gray background to white, in globals.css:

.bg-\[\#f5f7fb\] { background-color: #fff !important; }

---

Analytics REST API

> Base URL: ${dmUrl}/api/ai-analytics/ and ${dmUrl}/api/analytics/ > — dmUrl is the first arg passed to initializeDataLayer() (sourced > from NEXT_PUBLIC_API_BASE_URL). > Auth: Authorization: Token > Live OpenAPI:

Two namespaces: /api/ai-analytics/ (AI/agent analytics — chat, costs, sentiment, topics, traces, audience/engagement/performance dashboards) and /api/analytics/ (LMS analytics — content, financial, ratings, sessions, time, users). Most endpoints scope to {org} (the platform/tenant key).

Prefer SDK RTK Query hooks over hand-rolled fetch. Use get_api_query_info("") in MCP to find the relevant hook before writing custom UI.

{user_id} in /api/ai-analytics/orgs/{org}/users/{user_id}/... is the requesting admin's user id (RBAC + audit), not the user being queried — pass that via filter_user_id.

Common query parameters

| Parameter | Description | |-----------|-------------| | start_date, end_date | ISO 8601. Default range: last 7 days | | date_filter | today \| 7d \| 30d \| 90d \| all_time \| custom | | granularity | hour \| day \| week \| month | | department_id (with department_mode=1) | Scope to a department | | include_main_platform | Include main platform data. Default: true | | mentor_unique_id | Filter to one mentor/agent | | usergroup_ids[] | Filter to user groups | | platform_key | Filter to a platform | | page, page_size (or limit ≤ 100) | Pagination |

Audience — /api/ai-analytics/audience/orgs/{org}/

| Path | Returns | |------|---------| | active-users/over-time | Daily active users with vs-prior-period delta | | active-users/per-course | Active users per course | | active-users/users | List of active users | | enrollments/over-time | Daily enrollments | | enrollments/per-course | Enrollments per course | | enrollments/courses/{course_id}/over-time | Trend for one course | | enrollments/courses/{course_id}/users | Enrolled learners | | registered-users/, registered-users/over-time, registered-users/per-course | Registered user count, trend, per-course |

Engagement — /api/ai-analytics/engagement/orgs/{org}/

| Path | Returns | |------|---------| | activity | Activity heatmap | | course_completion/over-time, course_completion/per-course | Completion trend, per-course rate | | time/over-time, time/per-course, time/average-perlearner-percourse, time/average-with-over-time | Org-wide time aggregates | | videos/, videos/over-time | Org-wide video stats | | courses/{course_id}/time/{average,detail,over-time,users} | Course time metrics | | courses/{course_id}/time/users/{user_id}/{detail,over-time} | Per-learner time inside a course | | courses/{course_id}/videos/, courses/{course_id}/videos/{over-time,summary,users} | Course video metrics |

Overview — /api/ai-analytics/overview/orgs/{org}/

active-users, average-grade, courses/completions, learners, most-active-courses, registered-users — top-level dashboard cards.

Performance — /api/ai-analytics/performance/orgs/{org}/

| Path | Returns | |------|---------| | grading/average, grading/per-course | Org-wide grade aggregates | | courses/{course_id}/grading/{average,average-with-cutoff,detail,per-learner,summary} | Per-course grade metrics |

Per-Learner — /api/ai-analytics/perlearner/orgs/{org}/

| Path | Returns | |------|---------| | learners, users | Learner roster (alternate routes) | | users/{user_id}/{activity,info,last-access} | Profile + activity | | users/{user_id}/grades/per-course | Grades per course | | users/{user_id}/overview/{engagement-index,grades/average,performance-index,time/over-time} | Score cards | | users/{user_id}/videos/{over-time,per-course} | Video stats | | users/{user_id}/courses/{course_id}/overview/{engagement-index,grade,performance-index,time/over-time} | Per-course score cards | | users/{user_id}/courses/{course_id}/grading/{cutoffs,detail,summary} | Per-course grading | | users/{user_id}/courses/{course_id}/videos, .../videos/over-time | Per-course videos |

AI Mentor / User — /api/ai-analytics/orgs/{org}/users/{user_id}/

Chat history

| Method | Path | |--------|------| | GET POST | chat-history/ (filter by start_date, end_date, mentor, sentiment, topics, filter_user_id, page) | | GET PUT PATCH DELETE | chat-history/{id}/ | | GET | chat-history-filter/ | | GET | conversation/, conversation-summary/ | | GET | my-chat-history/, my-chat-history/{id}/, my-chat-history-filter/ | | GET POST | my-chat-history-report/ (export task) | | GET | my-chat-history-report/{task_id}/, my-chat-history-report/{task_id}/download/ |

Mentors, costs, topics, sentiment, usage

| Group | Paths | |-------|-------| | Mentors | mentor-detail/, mentor-summary/, total-users-by-mentor/, mentors/{mentor_unique_id}/cost/ | | Costs | costs/{model,permentor,peruser}/, tenant-cost/, user-cost/ | | Topics | most-discussed-topics/, topic-overview/, topic-statistics/, topics/summary/ | | Sentiment / feedback | sentiment-count/, user-sentiment/, rating-summary/, user-feedback/ | | Usage | average-messages-per-session/, usage-summary/, overview-summary/, top-students-by-chat-messages/, user-cohorts-over-time/, user-metrics/, user-metrics-pie-chart/, registered-users-trend/ | | Observations / traces / transcripts | observations/, observations/{id}/, traces/, traces/{id}/, transcripts/ |

Misc

| Path | Returns | |------|---------| | /api/ai-analytics/costs/pertenant/ | Cost grouped by tenant | | /api/ai-analytics/departments/orgs/{org}/ | Departments | | /api/ai-analytics/user-groups/orgs/{org}/ | User groups |

LMS Analytics — /api/analytics/

Accepts date_filter, granularity, metric, mentor_unique_id, platform_key, usergroup_ids, page, limit ≤ 100.

| Method | Path | Returns | |--------|------|---------| | GET | content/ | Catalog content (metric=course\|program\|pathway\|skill) | | GET | content/details/{content_id}/ | Per-item detail | | GET | conversations/ | Conversations | | GET | financial/, financial/details/, financial/invoice/ | Financial | | GET | learners/, learners/list/, learner/details | Learners | | GET | messages/, messages/details/ | Messages | | GET | ratings/, sessions/, time/, time-spent/user/, topics/, topics/details/, users/, users/details/ | Other | | POST | orgs/{org}/time/update/ | Push time-on-platform |

RBAC

Ibl.Analytics/Core/read (viewer) or Ibl.* (tenant admin). Per-learner and chat-history endpoints also require platform admin.

Example

curl "${dmUrl}/api/ai-analytics/audience/orgs/main/active-users/over-time?date_filter=30d" \
  -H "Authorization: Token ${TOKEN}"

curl "${dmUrl}/api/analytics/content/?metric=courses&date_filter=7d&include_overtime=true" \
  -H "Authorization: Token ${TOKEN}"

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: iblai
• Source: iblai/vibe
• License: MIT
• Homepage: https://ibl.ai/join

Install and usage instructions live in the source repository linked above.