Skip to content

forcedotcom/sf-skills / plugins/builder/agentforce-adlc/skills/agentforce-d360-analyze

agentforce-d360-analyze

Verified

Data Cloud 360° view of a single Agentforce session. TRIGGER when user asks to trace, inspect, summarize, or describe a specific Agentforce session by session id (Agent Session UUID `019d…` or MessagingSession id `0Mw…`). Also triggers on session discovery — find/list/search sessions by time, agent, channel, outcome, or conversation text — when the user has no session id yet. DO NOT TRIGGER for design-time architecture questions (use agentforce-architecture-analyze instead) or for runtime perf/latency/SLO questions that require platform telemetry beyond Data Cloud.

FileKindSize
README.mdmarkdown6.2 KB
SKILL.mdskill md13.2 KB
assets/dc/app_generation.sqlother1.9 KB
assets/dc/content_category.sqlother1.5 KB
assets/dc/content_quality.sqlother1.3 KB
assets/dc/discover_sessions.sqlother2.3 KB
assets/dc/feedback.sqlother1.5 KB
assets/dc/feedback_details.sqlother1.3 KB
assets/dc/gateway_records.sqlother1.6 KB
assets/dc/gateway_request_llm.sqlother1.6 KB
assets/dc/gateway_request_metadata.sqlother1.5 KB
assets/dc/gateway_request_tags.sqlother1.4 KB
assets/dc/gateway_requests.sqlother3.4 KB
assets/dc/gateway_responses.sqlother1.7 KB
assets/dc/generations.sqlother1.9 KB
assets/dc/interactions.sqlother2.0 KB
assets/dc/messages.sqlother2.1 KB
assets/dc/messaging_session.sqlother1.7 KB
assets/dc/moment_interactions.sqlother1.4 KB
assets/dc/moments.sqlother1.5 KB
assets/dc/participants.sqlother1.8 KB
assets/dc/sessions.sqlother3.0 KB
assets/dc/steps.sqlother2.6 KB
assets/dc/tag_associations.sqlother1.7 KB
assets/dc/tag_definition_associations.sqlother1.4 KB
assets/dc/tag_definitions.sqlother1.8 KB
assets/dc/tags.sqlother1.3 KB
assets/dc/telemetry_spans.sqlother2.1 KB
references/artifacts.mdmarkdown2.7 KB
references/dc_dmo_fields.mdmarkdown42.1 KB
references/dc_pipeline_contract.mdmarkdown26.3 KB
scripts/_shared/__init__.pyscript122 B
scripts/_shared/cli_override.pyscript3.3 KB
scripts/_shared/fs_guard.pyexecutablescript13.2 KB
scripts/_shared/paths.pyscript5.8 KB
scripts/_shared/runtime.pyscript2.0 KB
scripts/_shared/sql.pyscript548 B
scripts/assemble_dc.pyscript69.6 KB
scripts/config.pyscript1.8 KB
scripts/dc.pyscript13.8 KB
scripts/discover_sessions.pyscript21.1 KB
scripts/fetch_dc.pyscript45.1 KB
scripts/render_dc.pyscript69.7 KB
scripts/resolve_session.pyscript10.8 KB
scripts/storage.pyscript3.1 KB
scripts/tests/__init__.pyscript0 B
scripts/tests/_bootstrap.pyscript483 B
scripts/tests/fixtures/__init__.pyscript0 B
scripts/tests/fixtures/synthetic_session.pyscript14.6 KB
scripts/tests/test_assemble_dc_bootstrap_and_mode.pyscript4.2 KB
scripts/tests/test_assemble_dc_gateway_direct.pyscript8.3 KB
scripts/tests/test_assemble_dc_gateway_direct_integration.pyscript6.4 KB
scripts/tests/test_assemble_dc_helpers.pyscript10.0 KB
scripts/tests/test_assemble_dc_integration.pyscript9.3 KB
scripts/tests/test_dc_and_resolve_session.pyscript26.7 KB
scripts/tests/test_default_target_org.pyscript18.8 KB
scripts/tests/test_discover_sessions.pyscript19.0 KB
scripts/tests/test_discover_sessions_grep_ci.pyscript8.2 KB
scripts/tests/test_fetch_dc_helpers.pyscript10.6 KB
scripts/tests/test_fetch_dc_identity.pyscript22.0 KB
scripts/tests/test_fetch_dc_main.pyscript9.4 KB
scripts/tests/test_fetch_dc_waterfall.pyscript8.6 KB
scripts/tests/test_fetch_dc_waterfall_full.pyscript11.2 KB
scripts/tests/test_identity_coherence.pyscript13.8 KB
scripts/tests/test_render_dc_branches.pyscript9.9 KB
scripts/tests/test_render_dc_gateway_direct.pyscript5.1 KB
scripts/tests/test_render_dc_helpers.pyscript10.5 KB
scripts/tests/test_render_dc_integration.pyscript7.7 KB
scripts/tests/test_render_dc_planner_llm_calls.pyscript11.8 KB
scripts/tests/test_render_dc_show_prompts_gating.pyscript8.7 KB
scripts/tests/test_resolve_from_disk.pyscript4.1 KB
scripts/tests/test_resolve_session_main.pyscript5.2 KB
scripts/tests/test_runtime_override.pyscript4.2 KB
scripts/tests/test_session_shape.pyscript3.5 KB
scripts/tests/test_session_shape_dropped_by_stdm.pyscript3.5 KB
scripts/tests/test_skill_md_prefix_block.pyscript6.8 KB

scripts/tests/test_render_dc_integration.py

View on GitHub
"""End-to-end integration tests for ``render_dc.render``.

Drives the full renderer against the synthetic session fixture (assembled
through ``assemble_dc.assemble`` first). Asserts on section presence,
substring content of identity / transcript / hierarchical-trace / id-ref
sections, and graceful degradation paths (no session_dir, gateway-direct
shape, minimal tree).
"""
from __future__ import annotations

import json
import unittest
from pathlib import Path
from tempfile import TemporaryDirectory
from unittest import mock

from . import _bootstrap  # noqa: F401  — sys.path setup

import assemble_dc  # type: ignore
import render_dc  # type: ignore
from config import paths  # type: ignore
from .fixtures.synthetic_session import (  # type: ignore
    IDS, write_to_disk,
)


class _RenderHarness:
    """Materialize fixture, assemble, render."""

    def __init__(self, *, with_session_dir: bool = True,
                 mutate_files=None):
        self.with_session_dir = with_session_dir
        self.mutate_files = mutate_files

    def __enter__(self):
        self._tmp = TemporaryDirectory()
        self._tmpdir = Path(self._tmp.name)
        sdir = write_to_disk(self._tmpdir)
        if self.mutate_files:
            self.mutate_files(sdir)
        self._patch = mock.patch.object(paths, "DATA_ROOT", self._tmpdir)
        self._patch.start()
        self.tree, self.sdir = assemble_dc.assemble(IDS.SID)
        self.manifest = json.loads(
            (self.sdir / "dc._session_manifest.json").read_text()
        )
        self.md = render_dc.render(
            self.tree,
            manifest=self.manifest,
            session_dir=self.sdir if self.with_session_dir else None,
        )
        return self

    def __exit__(self, *exc):
        self._patch.stop()
        self._tmp.cleanup()


# -----------------------------------------------------------------------------
# Top-level shape — sections present
# -----------------------------------------------------------------------------


class RenderSectionsPresentTests(unittest.TestCase):

    def test_renders_session_identity_section(self):
        with _RenderHarness() as h:
            self.assertIn("## Session identity", h.md)

    def test_renders_id_reference_section(self):
        with _RenderHarness() as h:
            self.assertIn("## ID reference", h.md)

    def test_renders_hierarchical_trace_section(self):
        with _RenderHarness() as h:
            self.assertIn("## Complete hierarchical trace", h.md)

    def test_renders_per_turn_summary_section(self):
        with _RenderHarness() as h:
            self.assertIn("## Per-turn summary", h.md)

    def test_renders_transcript_section(self):
        with _RenderHarness() as h:
            self.assertIn("## Transcript", h.md)


# -----------------------------------------------------------------------------
# Identity content
# -----------------------------------------------------------------------------


class RenderIdentityTests(unittest.TestCase):

    def test_identity_shows_session_id(self):
        with _RenderHarness() as h:
            self.assertIn(IDS.SID, h.md)

    def test_identity_shows_messaging_session_id(self):
        with _RenderHarness() as h:
            self.assertIn("0MwTESTMSG12345AAA", h.md)

    def test_identity_shows_total_duration_in_human_form(self):
        with _RenderHarness() as h:
            # Session is 90 seconds → "1m 30.000s"
            self.assertIn("1m 30.000s", h.md)

    def test_identity_shows_channel_and_end_type(self):
        with _RenderHarness() as h:
            self.assertIn("SCRT2 - EmbeddedMessaging", h.md)
            self.assertIn("USER_ENDED", h.md)

    def test_identity_marks_session_end_as_materialized(self):
        with _RenderHarness() as h:
            self.assertIn("✓ materialized", h.md)


# -----------------------------------------------------------------------------
# ID reference
# -----------------------------------------------------------------------------


class RenderIdReferenceTests(unittest.TestCase):

    def test_id_ref_lists_all_three_interactions(self):
        with _RenderHarness() as h:
            self.assertIn(IDS.IXN_START, h.md)
            self.assertIn(IDS.IXN_TURN, h.md)
            self.assertIn(IDS.IXN_END, h.md)

    def test_id_ref_lists_both_participants_with_roles(self):
        with _RenderHarness() as h:
            self.assertIn(IDS.PART_AGENT, h.md)
            self.assertIn(IDS.PART_USER, h.md)
            self.assertIn("role=AGENT", h.md)
            self.assertIn("role=USER", h.md)

    def test_id_ref_lists_all_three_steps(self):
        with _RenderHarness() as h:
            self.assertIn("TopicSelection", h.md)
            self.assertIn("PrimaryAction", h.md)
            self.assertIn("FinalGuard", h.md)

    def test_id_ref_lists_both_gateway_requests_with_binding_method(self):
        with _RenderHarness() as h:
            self.assertIn(IDS.GW_REQ_DECLARED, h.md)
            self.assertIn(IDS.GW_REQ_WINDOW, h.md)
            self.assertIn("binding=declared", h.md)
            self.assertIn("binding=timestamp_window", h.md)

    def test_id_ref_includes_extracted_trace_id(self):
        with _RenderHarness() as h:
            # Trace_id was pulled from HTML-escaped AttributeText; once
            # decoded it must appear verbatim in the id-ref section.
            self.assertIn(IDS.TRACE_ID, h.md)


# -----------------------------------------------------------------------------
# Transcript
# -----------------------------------------------------------------------------


class RenderTranscriptTests(unittest.TestCase):

    def test_transcript_includes_user_message(self):
        with _RenderHarness() as h:
            self.assertIn("How do I refund my order?", h.md)

    def test_transcript_includes_agent_message(self):
        with _RenderHarness() as h:
            self.assertIn("I'll help you with the refund process.", h.md)


# -----------------------------------------------------------------------------
# Graceful degradation paths
# -----------------------------------------------------------------------------


class RenderDegradationTests(unittest.TestCase):

    def test_renders_without_session_dir(self):
        # No session_dir → no latency-rollup section, but the rest of
        # the render should succeed and contain the standard sections.
        with _RenderHarness(with_session_dir=False) as h:
            self.assertIn("## Session identity", h.md)
            self.assertIn("## Complete hierarchical trace", h.md)

    def test_minimal_tree_short_circuits_to_short_markdown(self):
        def empty_sessions(sdir: Path) -> None:
            (sdir / "dc.sessions.json").write_text("[]")

        with _RenderHarness(mutate_files=empty_sessions) as h:
            # session_not_found minimal tree still produces something
            # readable that contains the SID.
            self.assertIn(IDS.SID, h.md)
            # Doesn't produce the full 9-section layout — verify by
            # absence of a section that requires interactions.
            self.assertNotIn("## Complete hierarchical trace", h.md)


# -----------------------------------------------------------------------------
# Output is non-empty markdown
# -----------------------------------------------------------------------------


class RenderOutputBasicsTests(unittest.TestCase):

    def test_output_starts_with_h1_header(self):
        with _RenderHarness() as h:
            first_line = h.md.splitlines()[0]
            self.assertTrue(first_line.startswith("# Session "))

    def test_output_is_substantial(self):
        # A real session produces several KB; a hand-built fixture with
        # 1 turn + 3 steps + 2 gateway calls should produce ≥ 2 KB.
        with _RenderHarness() as h:
            self.assertGreater(len(h.md), 2000)


if __name__ == "__main__":
    unittest.main()
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall