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_assemble_dc_gateway_direct.py

View on GitHub
"""Tests for ``assemble_dc._assemble_gateway_direct``.

Exercises the ``interactions_not_materialized_yet`` path: session row
resolved, gateway_requests populated, interactions/steps empty. Builds a
minimal rows-dict fixture and calls the private assembler directly — the
function is pure over (sid, rows, manifest, parse_warnings), so no disk
fixtures are needed.

Scope:
  - ``_source == "gateway_direct"`` sentinel
  - ``session.interactions == []`` (downstream consumers no-op)
  - ``session.gateway_chain`` length == fixture's gateway_requests
  - each gateway_chain entry has a populated ``response.timestamp``
  - finish_reason is lifted out of the HTML-escaped parameters JSON
  - model / provider / prompt_template_dev_name / token counts populated
"""
from __future__ import annotations

import unittest

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

from assemble_dc import _assemble_gateway_direct  # type: ignore


_SID = "01912345-0000-7000-8000-000000000001"


def _gw_request(req_id: str, ts: str, model: str, tokens: tuple) -> dict:
    """Shape mirrors GenAIGatewayRequest__dlm rows as fetched."""
    prompt_tok, completion_tok, total_tok = tokens
    return {
        "gatewayRequestId__c": req_id,
        "sf__Id": f"sf-{req_id}",
        "sessionId__c": f'"{_SID}"',
        "timestamp__c": ts,
        "model__c": model,
        "provider__c": "openai",
        "promptTemplateDevName__c": "AiCopilot__ReactTopicPrompt",
        "feature__c": "plannerservice",
        "promptTokens__c": prompt_tok,
        "completionTokens__c": completion_tok,
        "totalTokens__c": total_tok,
        "prompt__c": f"This is the prompt body for {req_id}.",
    }


def _gw_response(req_id: str, resp_id: str, ts: str, finish: str) -> dict:
    """Shape mirrors GenAIGatewayResponse__dlm rows as fetched.

    parameters__c is HTML-escaped JSON with the finish_reason value
    wrapped in escaped quotes — the exact on-wire shape the live fetcher
    produces. Mirrors the fixture used elsewhere in the test suite.
    """
    # Build the raw JSON first, then HTML-escape the quotes the same way
    # the gateway serializer does.
    raw = '{"finish_reason":"\\"' + finish + '\\""}'
    escaped = raw.replace('"', """)
    return {
        "generationResponseId__c": resp_id,
        "generationRequestId__c": req_id,
        "parameters__c": escaped,
        "timestamp__c": ts,
    }


def _tag(req_id: str, key: str, value: str) -> dict:
    return {
        "id__c": f"tag-{req_id}-{key}",
        "parent__c": req_id,
        "tag__c": key,
        "tagValue__c": value,
    }


def _md(req_id: str, mtype: str, payload: str) -> dict:
    return {
        "id__c": f"md-{req_id}",
        "parent__c": req_id,
        "metadataType__c": mtype,
        "metadata__c": payload,
    }


def _make_rows() -> dict:
    session_row = {
        "ssot__Id__c": _SID,
        "ssot__StartTimestamp__c": "2026-05-03T10:00:00.000Z",
        "ssot__EndTimestamp__c": None,
        "ssot__AiAgentChannelType__c": "EmbeddedMessaging",
        "ssot__AiAgentSessionEndType__c": None,
    }
    return {
        "sessions": [session_row],
        "participants": [],
        "messages": [],
        "moments": [],
        "interactions": [],
        "steps": [],
        "generations": [],
        "gateway_requests": [
            _gw_request("gw-1", "2026-05-03T10:00:01.000Z", "gpt-4o", (100, 50, 150)),
            _gw_request("gw-2", "2026-05-03T10:00:05.000Z", "gpt-4o", (200, 80, 280)),
            _gw_request("gw-3", "2026-05-03T10:00:10.000Z", "gpt-4o-mini", (50, 30, 80)),
        ],
        "gateway_responses": [
            _gw_response("gw-1", "resp-1", "2026-05-03T10:00:02.500Z", "stop"),
            _gw_response("gw-2", "resp-2", "2026-05-03T10:00:06.000Z", "tool_calls"),
            _gw_response("gw-3", "resp-3", "2026-05-03T10:00:11.000Z", "stop"),
        ],
        "gateway_request_tags": [
            _tag("gw-1", "bot_id", "0Xx000000000001"),
            _tag("gw-2", "feature", "plannerservice"),
        ],
        "gateway_request_metadata": [
            _md("gw-2", "ToolCall", '{"tool":"apex"}'),
        ],
        "gateway_request_llm": [],
        "content_quality": [],
        "content_category": [],
        "feedback": [],
        "feedback_details": [],
        "gateway_records": [],
        "tag_associations": [],
        "tag_definitions": [],
        "tag_definition_associations": [],
        "tags": [],
        "app_generation": [],
        "telemetry_spans": [],
        "moment_interactions": [],
    }


def _make_manifest() -> dict:
    return {
        "session_id": _SID,
        "org_alias": "test-org",
        "instance_url": "https://example.my.salesforce.com",
        "org_id_15": "00DXX0000000001",
        "agent_api_name": "My_Agent",
        "agent_version": "v1",
        "session_shape": "interactions_not_materialized_yet",
        "queries": [],
    }


class AssembleGatewayDirectTests(unittest.TestCase):

    def setUp(self):
        self.rows = _make_rows()
        self.manifest = _make_manifest()
        self.tree = _assemble_gateway_direct(
            _SID, self.rows, self.manifest, parse_warnings=[])

    def test_source_sentinel(self):
        """The render layer keys off this exact string."""
        self.assertEqual(self.tree["_source"], "gateway_direct")

    def test_interactions_is_explicit_empty_list(self):
        """Downstream consumers walk session.interactions — must exist + be empty."""
        self.assertEqual(self.tree["session"]["interactions"], [])

    def test_gateway_chain_length_matches_input(self):
        self.assertEqual(len(self.tree["session"]["gateway_chain"]), 3)

    def test_each_chain_entry_has_response_timestamp(self):
        """Join via generationRequestId__c must populate response.timestamp on each."""
        for call in self.tree["session"]["gateway_chain"]:
            with self.subTest(req_id=call.get("gateway_request_id")):
                self.assertIsNotNone(call.get("response"))
                self.assertIsNotNone(call["response"].get("timestamp"))

    def test_finish_reason_parsed(self):
        """HTML-escaped, quote-wrapped finish_reason must decode to bare string."""
        reasons = [c["response"]["finish_reason"]
                   for c in self.tree["session"]["gateway_chain"]]
        self.assertEqual(reasons, ["stop", "tool_calls", "stop"])

    def test_chain_sorted_by_timestamp(self):
        """Deterministic ordering — required for byte-identical output across runs."""
        timestamps = [c["timestamp"] for c in self.tree["session"]["gateway_chain"]]
        self.assertEqual(timestamps, sorted(timestamps))

    def test_model_and_tokens_harvested(self):
        first = self.tree["session"]["gateway_chain"][0]
        self.assertEqual(first["model"], "gpt-4o")
        self.assertEqual(first["provider"], "openai")
        self.assertEqual(first["prompt_template_dev_name"],
                         "AiCopilot__ReactTopicPrompt")
        self.assertEqual(first["prompt_tokens"], 100)
        self.assertEqual(first["total_tokens"], 150)

    def test_prompt_text_untruncated_on_disk(self):
        """Assembler stores the full prompt — the 64 KB cap is render-only."""
        for call in self.tree["session"]["gateway_chain"]:
            self.assertIn("This is the prompt body for",
                          call.get("prompt_text") or "")

    def test_identity_block_present(self):
        """Top-level identity must carry (org_id_15, agent_api_name, agent_version)."""
        self.assertEqual(self.tree["identity"]["org_id_15"], "00DXX0000000001")
        self.assertEqual(self.tree["identity"]["agent_api_name"], "My_Agent")
        self.assertEqual(self.tree["identity"]["agent_version"], "v1")

    def test_stdm_lag_note_on_session(self):
        note = self.tree["session"].get("_stdm_lag_note") or ""
        self.assertIn("materialize on a separate cadence", note)

    def test_counts_reflect_input_rows(self):
        counts = self.tree["session"]["counts"]
        self.assertEqual(counts["gateway_requests"], 3)
        self.assertEqual(counts["gateway_responses"], 3)
        self.assertEqual(counts["interactions_total"], 0)
        self.assertEqual(counts["steps_total"], 0)
        self.assertEqual(counts["session_shape"],
                         "interactions_not_materialized_yet")


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