Skip to content

🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.

feat(trace): inspect transcript on trace via three dots (#18691)

Nimar3d1c4ff36e08
diff --git a/web/src/features/traces/components/TraceDetailActions.tsx b/web/src/features/traces/components/TraceDetailActions.tsx
index 04d8096801..b9ef040949 100644
--- a/web/src/features/traces/components/TraceDetailActions.tsx
+++ b/web/src/features/traces/components/TraceDetailActions.tsx
@@ -1,4 +1,10 @@
-import { Download, Loader2, MoreVertical, TrashIcon } from "lucide-react";
+import {
+ Download,
+ FileText,
+ Loader2,
+ MoreVertical,
+ TrashIcon,
+} from "lucide-react";
import { HeaderActionButton } from "@/src/components/HeaderActionButton";
import {
@@ -10,8 +16,10 @@ import {
type DropdownMenuItemDefinition,
} from "@/src/components/design-system/DropdownMenu/DropdownMenu";
import { useShareMenuItems } from "@/src/components/useShareMenuItems";
+import { InternalFeatureBadge } from "@/src/features/feature-flags";
import { ConnectedDetailHeaderActionsMenuController } from "@/src/features/traces/components/DetailHeaderActionsMenuController";
import { DeleteTraceDialogController } from "@/src/features/traces/components/DeleteTraceDialogController";
+import { TraceTranscriptDialogController } from "@/src/features/traces/components/TraceTranscriptDialogController";
import { staleProps } from "@/src/features/traces/fns/staleProps";
import { useDownloadTraceAsJson } from "@/src/features/traces/hooks/useDownloadTraceAsJson";
import { type useTraceDetailData } from "@/src/features/traces/hooks/useTraceDetailData";
@@ -62,13 +70,22 @@ export function TraceDetailActions({
remountOnStale: true,
});
return (
- <LoadedTraceDetailActions
+ <TraceTranscriptDialogController
key={key}
- trace={trace}
- layout={layout}
- stale={stale}
- {...props}
- />
+ projectId={trace.projectId}
+ traceId={trace.id}
+ timestamp={trace.timestamp}
+ >
+ {({ openDialog }) => (
+ <LoadedTraceDetailActions
+ trace={trace}
+ layout={layout}
+ stale={stale}
+ onShowTranscript={openDialog}
+ {...props}
+ />
+ )}
+ </TraceTranscriptDialogController>
);
}
@@ -112,10 +129,12 @@ function LoadedTraceDetailActions({
onAfterDelete,
layout,
stale,
+ onShowTranscript,
}: Omit<TraceDetailActionsProps, "trace" | "layout" | "isPlaceholderData"> & {
trace: TraceDetailData;
layout: TraceDetailActionsLayout;
stale: Omit<ReturnType<typeof staleProps>, "key">;
+ onShowTranscript?: () => void;
}) {
const shareItems = useShareMenuItems({
kind: "trace",
@@ -158,6 +177,18 @@ function LoadedTraceDetailActions({
const items: DropdownMenuItemDefinition[] = [
...shareItems,
...copyItems,
+ ...(onShowTranscript
+ ? [
+ {
+ type: "item" as const,
+ id: "show-trace-transcript",
+ title: "Show trace transcript",
+ icon: FileText,
+ badge: <InternalFeatureBadge />,
+ onClick: onShowTranscript,
+ },
+ ]
+ : []),
{ id: "delete-separator", type: "separator" },
{
type: "item",
diff --git a/web/src/features/traces/components/TraceTranscriptDialogController.tsx b/web/src/features/traces/components/TraceTranscriptDialogController.tsx
new file mode 100644
index 0000000000..f3efc17039
--- /dev/null
+++ b/web/src/features/traces/components/TraceTranscriptDialogController.tsx
@@ -0,0 +1,81 @@
+import { useSession } from "next-auth/react";
+import { type ReactNode } from "react";
+
+import { Alert } from "@/src/components/design-system/Alert/Alert";
+import { Dialog } from "@/src/components/design-system/Dialog/Dialog";
+import { DialogController } from "@/src/components/design-system/DialogController/DialogController";
+import { JSONView } from "@/src/components/ui/CodeJsonViewer";
+import { api } from "@/src/utils/api";
+
+type TraceTranscriptSource = {
+ projectId: string;
+ traceId: string;
+ timestamp: Date;
+};
+
+export function TraceTranscriptDialogController({
+ children,
+ ...source
+}: TraceTranscriptSource & {
+ children: (control: { openDialog: (() => void) | undefined }) => ReactNode;
+}) {
+ const { data: session } = useSession();
+ if (session?.user?.admin !== true) {
+ return children({ openDialog: undefined });
+ }
+
+ return (
+ <DialogController<TraceTranscriptSource>
+ renderDialog={({ state }) => (
+ <Dialog title="Trace transcript" size="lg" closeOnInteractionOutside>
+ <Dialog.Body>
+ <div className="ph-no-capture flex flex-col gap-4">
+ <TraceTranscriptInspector {...state} />
+ </div>
+ </Dialog.Body>
+ </Dialog>
+ )}
+ >
+ {({ openDialog }) => children({ openDialog: () => openDialog(source) })}
+ </DialogController>
+ );
+}
+
+function TraceTranscriptInspector(source: TraceTranscriptSource) {
+ const query = api.events.transcriptByTraceId.useQuery(source);
+
+ if (query.error) {
+ return (
+ <Alert variant="destructive" size="sm">
+ <Alert.Description>
+ <p className="break-words">{query.error.message}</p>
+ </Alert.Description>
+ </Alert>
+ );
+ }
+ if (!query.data) return <p className="text-xs">Loading transcript…</p>;
+
+ return (
+ <>
+ {query.data.cutoff && (
+ <Alert variant="warning" size="sm">
+ <Alert.Description>
+ This transcript is incomplete because the trace exceeds the
+ observation limit.
+ </Alert.Description>
+ </Alert>
+ )}
+ {query.data.transcript ? (
+ <JSONView
+ title="Transcript"
+ json={query.data.transcript}
+ preserveStrings
+ />
+ ) : (
+ <p className="text-muted-foreground text-xs">
+ No transcript available for this trace.
+ </p>
+ )}
+ </>
+ );
+}