🔬 Research & Report Pipeline

using System.ComponentModel;
using Azure.AI.OpenAI;
using Azure.Identity;
using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;

// ── Tool functions (deterministic data retrieval — no LLM needed) ──

string SearchWeb(
    [Description("The search query to find sources about")] string query)
    => $"""
        Search results for "{query}":
        [1] Nature.com: "Quantum entanglement enables instant correlation across arbitrary distances..."
        [2] PhysicsToday: "2023 Nobel Prize awarded for entanglement experiments confirming Bell inequalities..."
        [3] ArXiv preprint: "Practical quantum key distribution using entangled photon pairs..."
        """;

string FetchArticle(
    [Description("The article title or URL to fetch")] string source)
    => $"""
        Article content from {source}:
        Quantum entanglement is a phenomenon where two particles become correlated such that the
        quantum state of each particle cannot be described independently. Measuring one particle
        instantly affects the other, regardless of distance. Einstein called this 'spooky action
        at a distance'. The 2022 Nobel Prize confirmed this is a real physical effect.
        """;

string VerifyClaim(
    [Description("The factual claim to verify")] string claim)
    => claim.Contains("Nobel")
        ? $"✅ VERIFIED: The Nobel Prize for quantum entanglement was awarded in 2022 (not 2023). Correction noted."
        : $"✅ VERIFIED: Claim '{claim}' is consistent with peer-reviewed sources.";

// ── Azure OpenAI client ──
var azureClient = new AzureOpenAIClient(
    new Uri(Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT")!),
    new AzureCliCredential());

// ── Stage 1: Research Agent ──
// Sub-agent because: needs to reason about which sources are relevant, synthesise multiple results
AIAgent researchAgent = azureClient
    .GetChatClient("gpt-4o-mini")
    .AsAIAgent(
        instructions: """
            You are a thorough research specialist. Given a topic:
            1. Search for 2-3 relevant sources using your search tool.
            2. Fetch the most promising article.
            3. Synthesise a structured research summary with:
               - Key findings (bullet list)
               - Important dates and figures
               - Notable controversies or open questions
            Output ONLY the research summary — do not write the final article.
            """,
        name: "ResearchAgent",
        description: "Gathers raw research on a topic. Call this first with the topic to investigate.",
        tools:
        [
            AIFunctionFactory.Create(SearchWeb),
            AIFunctionFactory.Create(FetchArticle)
        ]);

// ── Stage 2: Fact Checker Agent ──
// Sub-agent because: needs domain reasoning to identify which claims require verification
AIAgent factCheckerAgent = azureClient
    .GetChatClient("gpt-4o-mini")
    .AsAIAgent(
        instructions: """
            You are a meticulous fact-checker. Given a research summary:
            1. Extract every specific factual claim (dates, names, statistics, attributions).
            2. Verify each claim using your verification tool.
            3. Return a fact-check report listing:
               - Each claim and its verification status (✅ Verified / ❌ Disputed / ⚠️ Uncertain)
               - Any corrections needed
               - An overall confidence score (0-100%)
            Be strict — flag anything that cannot be confirmed.
            """,
        name: "FactCheckerAgent",
        description: "Verifies factual claims in a research summary. Call this after ResearchAgent with the research output.",
        tools:
        [
            AIFunctionFactory.Create(VerifyClaim)
        ]);

// ── Stage 3: Writer Agent ──
// Sub-agent because: creative reasoning, audience targeting, narrative structure — all need LLM judgment
AIAgent writerAgent = azureClient
    .GetChatClient("gpt-4o-mini")
    .AsAIAgent(
        instructions: """
            You are an expert science writer. Given research notes and a fact-check report:
            1. Write a polished, engaging article for a general audience (800-1000 words).
            2. Structure: Compelling headline → Hook paragraph → Key findings → Context → Implications → Conclusion.
            3. Incorporate all fact-checker corrections before writing.
            4. Use clear language — no unexplained jargon.
            5. End with a "Key Takeaways" box (3 bullet points).
            Output ONLY the final article — no commentary about the writing process.
            """,
        name: "WriterAgent",
        description: "Writes a polished article from research notes and fact-check results. Call this last with both previous outputs combined.");

// ── Coordinator — orchestrates the pipeline explicitly ──
// Note: the coordinator passes each stage's output to the next stage as context.
// This gives us control over the pipeline order and allows error handling at each stage.

string topic = "quantum entanglement and its real-world applications";

Console.WriteLine($"📋 Starting research pipeline for: \"{topic}\"");
Console.WriteLine(new string('─', 60));

// Stage 1: Research
Console.WriteLine("\n🔍 Stage 1: Researching...");
string researchNotes = await researchAgent.RunAsync(
    $"Research this topic thoroughly: {topic}");
Console.WriteLine(researchNotes);

// Stage 2: Fact Check — passes Stage 1 output as context
Console.WriteLine("\n✅ Stage 2: Fact checking...");
string factCheckReport = await factCheckerAgent.RunAsync(
    $"Fact-check these research notes:\n\n{researchNotes}");
Console.WriteLine(factCheckReport);

// Stage 3: Write — receives BOTH previous outputs
Console.WriteLine("\n✍️ Stage 3: Writing article...");
string finalArticle = await writerAgent.RunAsync(
    $"""
    Write an article about: {topic}

    Research notes:
    {researchNotes}

    Fact-check report (incorporate all corrections):
    {factCheckReport}
    """);

Console.WriteLine("\n" + new string('═', 60));
Console.WriteLine("📄 FINAL ARTICLE");
Console.WriteLine(new string('═', 60));
Console.WriteLine(finalArticle);