Why should you care?

Product differentiation beyond copilots — customers buy insights layer on same AgentNest tenancy and audit.

See it live — copy this example

Paste into an ASP.NET Core 8+ / AgentNest project, then run with dotnet run (set your API keys in user-secrets).

// AgentNest.Api/Controllers/AnalyticsPlatformController.cs
[ApiController]
[Route("api/analytics/platform")]
public sealed class AnalyticsPlatformController(AnalyticsSupervisor supervisor) : ControllerBase
{
    [HttpGet("brief/weekly")]
    public Task<DashboardBrief> Weekly([FromQuery] Guid tenantId, [FromQuery] DateOnly week, CancellationToken ct) =>
        supervisor.ProduceAsync(tenantId, week, ct);

    [HttpPost("ask")]
    public Task<string> Ask([FromBody] AnalyticsQuestion q, MetricsNarratorAgent narrator, CancellationToken ct) =>
        narrator.AnswerAdHocAsync(q.TenantId, q.Question, ct);
}

What happened?

• AnalyticsPlatformController serves scheduled weekly briefs and ad-hoc questions via MetricsNarratorAgent with warehouse SQL grounding.
• Follow the steps below — typing the code yourself is the fastest way to learn.

Practice next

1. Provision read-only Synapse or Postgres warehouse connection.
2. Schedule Weekly brief job per tenant CEO timezone.
3. Validate narrative numbers against SQL in post-processor.
4. Add anomaly alert webhook when stats agent flags outlier.
5. Embed brief charts as base64 in API response.

Remember

Analytics platform combines supervisor briefs and ad-hoc Q&A. Ground all numbers in parameterized warehouse SQL. Schedule weekly briefs per tenant timezone.

Executive Monday brief

CEO receives AgentNest weekly brief email with narrative and figures.

Outcome: Board prep time drops; figures match Power BI because SQL source is shared.