エージェントのアーティファクトをレンダリングする
アーティファクトとは、エージェントがユーザーに表示したビジュアルを記述するために、ツール呼び出しまたは AI レスポンスに添付する小さなバージョン管理された JSON エンベロープです。 Agent Analyticsはエンベロープを検証し、そのビジュアルをセッションビュー内のカードとして再描画するため、レビューアは背後にあるJSONではなく、ユーザーが見たものを確認できます。Amplitudeは、ビューアのテーマに従う組み込みのレンダラーを使用してカードを描画します。このため、UIコードをリリースする必要はなく、Amplitudeがコードを実行することもありません。
エージェントが生成したチャートや提供した選択肢のセットなど、ビジュアルが答えであり、生のペイロードだけではその答えが適切であったかどうかを判断できない場合に、アーティファクトを発行します。分析に基礎となる数値のみが必要な場合は、アーティファクトは必要ありません。ツールのコンテンツは、すでにイベントプロパティとして送信され、チャートやコホートでクエリできます。
Agent Analyticsは、すべての組織に対して有効な$agent_artifactエンベロープを自動的にレンダリングします。
仕組み
- エージェントは、現在と同様に、ユーザー向けにビジュアルを生成します。
- これと併せて、コードはアーティファクトエンベロープを、ツール呼び出しの
inputまたはoutputに、あるいは直接回答の場合はAIレスポンスの添付に付与します。 - エージェント分析は、エンベロープを認識して検証し、会話ビューとトレースパネルの両方にカードをレンダリングします。
- 元のツールのペイロードまたはレスポンステキストは、カードの横に引き続き表示されます。 Amplitudeは、これを置き換えたり隠したりすることはありません。
ペイロードが検証されない場合、エージェント分析はカードの代わりに、未処理出力の横に短い理由の説明を表示します。データに対して推測を行ったり、部分的な結果をレンダリングしたりすることはありません。
コーディングエージェントを使用してアーティファクトをインストルメントする
コーディングエージェントを使用して、アプリケーションがビジュアルを生成する場所にアーティファクトシリアライザーを追加します。 コーディングエージェントでリポジトリを開き、このプロンプトをコピーして実行します。 アプリケーションがまだエージェント分析にセッションを送信していない場合は、まずインストルメンテーションを設定してください。
Add artifact instrumentation to this application's existing Amplitude
Agent Analytics integration.
Read the artifact contract:
https://amplitude.com/docs/amplitude-ai/agent-analytics/render-artifacts
Also read the instrumentation guide for the SDK or ingest path this
repository uses. If you can't access the documentation, ask me for it
before implementing the contract. Identify the existing content-capture
and redaction settings for the installed SDK or exporter. HTTP, OTLP,
and imported data do not inherit AI SDK settings.
1. Find the code that produces charts, summaries, tables, choices, or
static HTML shown to users. Trace each visual to its tool call and
existing instrumentation. Don't infer a displayed visual from arbitrary
JSON. Find the actual data used to render each visual; a chart ID, URL,
or configuration without values isn't a data snapshot. Preserve the
displayed filters, time range, timezone, and transformations. If that
data or an editable emission point is unavailable, report the gap.
Prefer capturing that data where the application produces the visual,
before truncation, then attaching it through existing instrumentation.
Avoid fetching it again just for analytics. If a reference needs a new
read, preserve resource permissions, bound the total work, and disclose
that the snapshot may differ from what the user originally saw.
2. Write reusable serializer functions in the project's language that
return a root-level $agent_artifact envelope with v: 1, the appropriate
type, and its required fields. Prefer chart, summary, table, or options.
If those types would lose meaningful content, implement a static html
fallback when feasible. Examples include choices with descriptions,
tables with semantic highlights, and reports containing several visuals.
Generate self-contained HTML/CSS/inline SVG from the actual source data,
escaping dynamic text. Follow the documented HTML restrictions and
per-type size limits. The result captures what was shown; controls stay
inert. For script-dependent visuals, generate a faithful static snapshot
from their data rather than simply removing scripts. Before skipping a
visual, evaluate both structured types and static html. If neither fits,
explain what content or meaning would be lost or what data is missing.
3. Derive labels, values, units, ordering, and scope from the application
code. Ask me about ambiguous mappings, such as cents versus dollars or
missing values. Don't invent values, silently truncate data, or change
the meaning of the visual to make an envelope validate.
4. Attach the envelope to the corresponding tool output, or tool input
for an input-side artifact such as a choice prompt. For a direct final-answer
visual, use an explicit artifact attachment on the existing AI response.
Follow the existing SDK, HTTP, or OTLP path and its serialization rules. Reuse session,
trace, and tool or message identifiers. Preserve application behavior and existing
payload fields, and avoid recording the same tool call or response twice.
Account for every visual the tool or final answer produces. For multiple visuals, evaluate one
static html report that preserves all meaningful content within the
documented limits. If that isn't feasible and no structured type fits,
explain the limitation and ask me how to proceed. Don't silently select
one visual or invent a multi-artifact envelope. Keep snapshot-only
failures from failing the underlying tool or response. Preserve request
cancellation and existing background persistence; don't add a storage
wait solely to capture data already available at the producer.
5. Preserve content-capture, exclusion, and redaction settings. Don't enable
capture to bypass metadata-only mode. The producer owns the content it
sends, including raw HTML, attributes, CSS, and inline SVG. Select only
source data approved for analytics capture. Use the existing SDK redaction
path without private helpers or an additional redaction pass. For HTTP,
OTLP, and imports, apply the source pipeline's policy before export.
Ordinary string redaction is best-effort; it doesn't interpret rendered
HTML or guarantee detection of values split across markup or encoded in
styles. Don't build a rendered-HTML PII detector, or omit HTML solely
because redaction is enabled. Viewer sanitization protects rendering,
not sensitive data at ingestion. Use synthetic fixtures for tests.
6. Add focused tests for representative inputs, optional or missing
fields, and invalid or oversized data. Validate the artifact envelope
and the complete serialized content field, including sibling fields,
against artifact and transport limits. Report an oversized snapshot
without truncating it or dropping the underlying event. Verify capture
exclusions, configured redaction, and the actual outbound payload.
Redaction can change markup or serialized JSON; check that the resulting
envelope remains parseable and represents the approved content faithfully.
Show the changed files, mapping assumptions, test results, and a
representative emitted envelope. Test slow or failed snapshot work and
cancellation. Record fixed omission reasons, such as missing data,
unsupported representation, size limit, or timeout, using existing span
identifiers. Don't log source content or exception bodies. Distinguish
expected capture exclusions from failures and ordinary nonvisual output.
Explain how to verify the artifact in
an Agent Analytics test session. Distinguish local serializer/contract
checks from live ingestion and visual verification; report which checks
you actually performed. For HTML fallbacks, verify that meaningful
content remains visible under the documented rendering restrictions.
7. Finish with an instrumented / skipped / needs a decision checklist.
For each visual path, name its source and emission point, coverage,
representation, and any limitation or unanswered mapping question. For
skipped visuals, explain why neither a structured type nor static html
works. Don't claim full coverage based on one successful example.
生成された変更とカバレッジチェックリストを使用する前に、特にスキップされたビジュアル、単位、フィールドマッピングを確認してください。 テストを実行した後、テストセッションを送信し、アーティファクトがエージェントに表示されたビジュアルと一致することを確認します。 エージェント分析でアーティファクトがレンダリングされないと報告される場合は、検証理由を確認してシリアライザーを修正してください。
シリアライザを自分で実装するには、エンベロープ、アーティファクト・タイプ、およびツール呼び出しの例を使用してください。
エンベロープ
すべてのアーティファクトは、単一の予約済みキーを持つJSONオブジェクトです。 キーは意図的にベンダーに中立であり、ペイロードの文法にはAmplitudeに固有のものはないため、同じビルダーをこの形状を採用している別のプラットフォームに採用することができます。この形状を採用。変更するのはコードではなく、キーです。
{
"$agent_artifact": {
"v": 1,
"spec": "https://amplitude.com/docs/amplitude-ai/agent-analytics/render-artifacts",
"type": "chart",
"title": "Monthly payouts",
"caption": "August was the highest month.",
"scope": { "label": "Aug 2026" },
"locale": "en-IN",
"payload": {}
}
}
| フィールド | 必須 | メモ |
|---|---|---|
v | はい | 契約バージョン。 常に1。 |
spec | いいえ | このペイロードが準拠するコントラクトのURL。キーはベンダー中立です。そのため、specペイロードが誰の形状であるかを示すためのものです。Amplitudeはレンダリング時にこれを無視します。 |
type | はい | chart、summary、options、table、htmlのいずれか。 |
title | タイプ別 | chart、table、およびhtmlの場合は必須。summaryおよびoptionsの場合はオプション。 |
caption | いいえ | カードの下に表示される1行の説明文。 |
scope | いいえ | { label, dateRange? }、データが対象とする期間または母集団。Amplitudeはそれをタイトルの横にレンダリングするため、1ヶ月分の数値が全期間の数値として読み取られることはありません。 |
locale | いいえ | BCP-47タグ。数値のフォーマットを駆動します。 |
generatedAt, id | いいえ | Provenance。 Amplitudeはこれらの値を保存しますが、レンダリングしません。 |
payload | はい | タイプごとのボディ。 アーティファクトタイプを参照してください。 |
次の2つの規則がすべての場所に適用されます。
unitは表示文字列であり、概念ではありません。"INR"、"%"、"ms"、"req/s"、またはその他の任意のものを送信します。Amplitudeはそれをそのままの値に追加し、解釈しません。 数値の書式設定はlocaleに由来します。- 色はセマンティックなものであり、リテラルではありません。
primary、success、dangerまたはを送信すると、Amplitudeがそれらをライトモードとダークモードで機能し、色覚に特性のある読者でも区別可能なテーマカラーにマッピングします。Hexの値、フォント、サイズはコントラクトの一部ではありません。
エンベロープをツール呼び出しに添付します
アーティファクトは、それを生成したツール呼び出しに付随して移動します。エンベロープはツールのoutputとして渡します。ユーザーに質問した場合など、アーティファクト_が_入力である場合には、inputとして渡します。
const artifact = {
$agent_artifact: {
v: 1,
type: "chart",
title: "Monthly payouts",
payload: {
shape: "categorical",
kind: "bar",
unit: "INR",
items: [
{ label: "Aug 2026", value: 37279.7, color: "danger" },
{ label: "Jul 2026", value: 23925, color: "primary" },
],
},
},
};
session.trackToolCall("render_payouts_chart", latencyMs, true, {
input: JSON.stringify({ range: "last-3-months" }),
output: JSON.stringify(artifact),
});
ツールコンテンツは、inputおよびoutputオプションから取得されます。Amplitudeはエラーなしで他のスペルを無視するため、アーティファクトが届くことはありません。 これにはtoolInputとtoolOutputも含まれ、いずれも結果として生成されるイベントプロパティの名前です。ゼロコードのインストルメンテーションpatch()に依存している場合は、自動抽出されたツール呼び出しには入力も出力も含まれないため、アーティファクトには明示的な定義が必要ですtrackToolCall。SDKリファレンスの追跡ツールの呼び出しを参照してください。
ダイレクトアンサーアーティファクトをAIレスポンスに添付する
アプリケーションでアシスタントの回答にビジュアルを直接表示する場合、そのエンベロープをその既存のAIレスポンスに添付してください。 ツールアーティファクトと同じv: 1エンベロープとアーティファクトタイプを使用してください。 各添付ファイルには、type: "artifact"フィールドとルートレベルの$agent_artifactフィールドが含まれます。
Python SDKは添付ファイルをディクショナリとして受け入れ、シリアル化を処理します。
agent = ai.agent(
"Your agent",
user_id=user_id,
session_id=session_id,
trace_id=trace_id,
)
agent.track_ai_message(
content=response_text,
model=model,
provider=provider,
latency_ms=latency_ms,
message_id=message_id,
attachments=[{
"type": "artifact",
"$agent_artifact": {
"v": 1,
"type": "table",
"title": "Sessions by region",
"payload": {
"columns": ["Region", "Sessions"],
"rows": [["Alpha", 12], ["Beta", 18]],
},
},
}],
)
HTTP取り込みの場合、添付ファイルリストを既存の[Agent] AI Responseイベントの[Agent] Attachmentsイベントプロパティとしてシリアル化します。レスポンステキストとセッション、トレース、メッセージの識別子を保持します。 同じ回答に対して、2番目のレスポンスを発行したり、合成ツール呼び出しを行ったりしないでください。アプリケーションが最終回答を受け入れた後にのみ添付ファイルを追加します。中間下書きは最終回答のスナップショットではありません。
エージェント分析は、テキストのないレスポンスを含め、会話ビューとトレースビューの両方で、アーティファクト添付ファイルをリスト順序でレンダリングします。このチャネルでは、明示的なtype: "artifact"添付のみを認識します。これは、レスポンステキストからビジュアルを推測したり、添付ファイルのURLを取得したりすることはありません。
添付ファイルリストは、他の添付ファイルタイプを含め、最大32個のエントリと256KBのシリアル化されたデータをサポートしています。 各アーティファクトもタイプごとの制限に従います。 SDKまたはingestパスでは、より小さい制限を課すことができます。そのシリアル化された出力をチェックし、大きすぎるスナップショットをトランケートするのではなく、拒否します。 1つのレポートを形成する複数のビジュアルについては、レポート全体を保持する1つの静的アーティファクトを優先します。html
SDKの添付は、SDKのコンテンツキャプチャ設定とスキング(秘匿化)設定に従います。metadata_onlyモードでは添付ファイルの本文が省略されるため、アーティファクトカードは表示されません。Direct HTTPの場合は、添付ファイルリストをエクスポートする前に、ソースパイプラインのプライバシーポリシーを適用します。
任意のインジェストパスから送信
エンベロープはすべてのパスで同じです。 変わるのは、それをどこに配置するかという点だけです。アーティファクトはツール呼び出しの既存のコンテンツフィールドを利用するため、ツールのコンテンツを伝送するパスであれば、どのようなパスでもアーティファクトが伝送されます。
AI SDK
上記の例のように、エンベロープをoutput(またはinput)オプションとして渡します。 Amplitudeは、これを[Agent] Tool Outputプロパティにシリアル化します。
HTTP APIまたは標準のAmplitude SDK
[Agent] Tool Callプロパティを[Agent] Tool Outputイベントに直接設定します。 完全なイベントコントラクトと、すべてのイベントに必要なIDフィールドについては、エージェント分析を設定するを参照してください。
curl -X POST https://api2.amplitude.com/2/httpapi \
-H "Content-Type: application/json" \
-d '{
"api_key": "YOUR_API_KEY",
"events": [{
"event_type": "[Agent] Tool Call",
"user_id": "user-123",
"event_properties": {
"[Agent] Session ID": "ticket-42",
"[Agent] Turn ID": 2,
"[Agent] Trace ID": "trace-abc",
"[Agent] Agent ID": "support-bot",
"[Agent] Tool Name": "render_refund_summary",
"[Agent] Tool Success": true,
"[Agent] Tool Input": "{\"order_id\":\"A-1\"}",
"[Agent] Tool Output": "{\"$agent_artifact\":{\"v\":1,\"type\":\"summary\",\"title\":\"Refund total\",\"payload\":{\"headline\":{\"value\":42.5,\"label\":\"Refunded\",\"unit\":\"USD\"}}}}"
}
}]
}'
どちらのプロパティもJSON文字列を受け取るため、割り当てる前にエンベロープをシリアル化します。
OTLP
エンベロープを、インストルメンテーションがすでにツールスパンで使用している結果属性に配置します。 Amplitudeは、存在する最初のものをこの順序で読み込みます:
| 属性 | 規則 |
|---|---|
gen_ai.output.messages | OpenTelemetry GenAI |
gen_ai.tool.call.result | OpenTelemetry GenAI |
output.value | OpenInference |
ツールの入力もgen_ai.tool.call.arguments同様のパターンinput.valueに従います。ツール名は、gen_ai.tool.nameいずれかtool.nameから取得されます。OTLPエンドポイントとヘッダー用のエージェント分析の設定を参照してください。
アーティファクトタイプ
チャート
チャートは、Amplitudeが検証するデータ形状と、描いた図を想起させる任意の項目を使用して説明しますkind。
shape | ペイロード | 用途 |
|---|---|---|
categorical | items: [{ label, value, color? }] | 棒、縦棒、円、ドーナツ |
series | series: [{ label, color?, points: [{ x, y }] }] | 順序付けられたx軸上の線とエリア |
steps | steps: [{ label, value }] | ファネル、ウォーターフォール |
points | points: [{ x, y, size? }]、ここで、xおよびyは数値です | 散布図、バブル |
matrix | xLabels, yLabels, values: number[][] | ヒートマップ、グリッド |
kindは、自由形式の文字列です:bar、column、pie、donut、line、areaまたはチャートに付けたい任意の名前にします。Amplitudeは、このように独自のレンダラーを持つものを描画します。それ以外のものは、その形状のデフォルト表示で描画され、その旨を示す注記が表示されるため、レビュー担当者は代替表示を見ていることを常に把握できます。専用のレンダラーがまだないシェイプ(steps、points、matrix)はラベル付きのテーブルとしてレンダリングされ、同じ注記が含まれます。
オプションのチャートフィールド:unit、xLabel、yLabel、およびhighlightedIndex(categoricalの場合は、1つの項目を強調します)。
{
"$agent_artifact": {
"v": 1,
"type": "chart",
"title": "Monthly cash flow",
"locale": "en-IN",
"payload": {
"shape": "series",
"kind": "line",
"unit": "INR",
"xLabel": "Month",
"yLabel": "Amount",
"series": [
{
"label": "Cash-in",
"color": "success",
"points": [
{ "x": "Apr 2026", "y": 222389 },
{ "x": "May 2026", "y": 42810 }
]
},
{
"label": "Cash-out",
"color": "danger",
"points": [
{ "x": "Apr 2026", "y": 61453 },
{ "x": "May 2026", "y": 32580 }
]
}
]
}
}
}
概要
必要な密度に合わせて、シンプルな見出し、比較を含む見出し、あるいはサポートメトリクスと事実を含む完全な概要など、1枚の数字カードとして表示できます。headlineを送信します。他のすべてのフィールドはオプションです。
{
"$agent_artifact": {
"v": 1,
"type": "summary",
"title": "Net cash flow",
"scope": { "label": "Sep 2026" },
"payload": {
"headline": {
"value": 25008,
"label": "Net cash flow",
"unit": "SAR",
"tone": "positive"
},
"delta": { "value": 80192, "direction": "up", "comparedTo": "vs August" },
"metrics": [{ "label": "Entries", "value": 41, "tone": "neutral" }],
"facts": [
{ "label": "All-time balance", "value": 918220, "tone": "positive" }
],
"suggestions": ["Show entries for this month"]
}
}
}
toneは、positive、negative、またはneutralです。これは判断ではなく、方向性を示すものです。suggestionsこれらはエージェントが提示したフォローアップであり、セッションビューは会話を継続する場ではなく、何が起きたかの記録であるため、ラベルとしてレンダリングされます。
オプション
ユーザーに提示された選択肢。 セッションを確認する人が誰であれ、その時までにユーザーはすでに回答しているため、選択内容はラベルとしてレンダリングされます。
{
"$agent_artifact": {
"v": 1,
"type": "options",
"payload": {
"question": "Which quarter should I show?",
"options": [
{ "id": "2026-q1", "label": "Jan – Mar 2026" },
{ "id": "2026-q2", "label": "Apr – Jun 2026" }
],
"reason": "too_many_results"
}
}
}
この値をツールのinputに添付します。ここで問われているのは、ツールが何を受け取ったかだからです。reasonは、エージェントがなぜ質問したかを示すあなた自身のショートコードです。分析用に保存されており、レンダリングされません。
テーブル
{
"$agent_artifact": {
"v": 1,
"type": "table",
"title": "Spend by region",
"payload": {
"columns": ["Region", "Sessions", "Spend"],
"rows": [
["EU", 1200, 4517.5],
["US", 880, 91000]
]
}
}
}
セルは文字列または数値です。数値はlocaleで書式設定され、右揃えになります。各行には、1列あたり正確に1つのセルが必要です。 Amplitudeは、パディングを行うとデータが不正確になるため、パディングの代わりに、その他の長さの行を拒否します。
html
他のタイプで表現できないビジュアルの場合は、自己完結型マークアップを送信します。
{
"$agent_artifact": {
"v": 1,
"type": "html",
"title": "Custom SLA gauge",
"payload": {
"html": "<html><head><style>…</style></head><body>…</body></html>"
}
}
}
Amplitudeはこれらのすべてを適用します。
- 静的マークアップのみ:Amplitudeはスクリプトタグを拒否し、レンダリングフレームはスクリプトをまったく実行できません。 インタラクティビティは宣言型に属します。
- 完全に自己完結型:CSSとデータをインライン化します。 Amplitudeは、画像(
data:画像を含む)と、フォント、スタイルシート、APIに対する外部リクエストをブロックします。ビジュアルには、HTML、CSS、またはインラインSVGを使用してください。 - ナビゲーションなし:Amplitudeはリンクの送信先を削除するため、リンクはクリック時にナビゲーションなしでコンテンツとして表示されます。
- 独自のスタイルを使用してください。フレームがドキュメントを分離するため、Amplitudeのテーマがその内部に到達することはありません。
- 最大100,000文字です。
Amplitudeは、htmlアーティファクトを折りたたみにした状態で表示します。レンダリング用ボタンがついており、押すと周囲のページに到達できない密封されたフレームに描画されます。
可能な限り宣言型を優先してください。これらのカードは、ビューアのテーマに従い、スクリーンリーダーと連携し、エクスポートにも表示されます。htmlを使うと、レイアウトの自由度が得られる代わりに、こうした利点はすべて失われます。
制限事項
Agent分析ビューアは、部分的なデータをレンダリングするのではなく、サイズが大きいアーティファクトペイロードを拒否します。SDKまたはExporterは、より小さい制限を課したり、取り込みの前にコンテンツを切り詰めることができます。 エンベロープ、エスケープ、および兄弟フィールドを含む、完全なシリアル化されたコンテンツフィールドを確認してください。スナップショットが制限を超えた場合、障害をレポートし、サイズ超過のスナップショットなしで、基礎となるイベントを保持します。 適合させるためにスナップショットを切り捨てないでください。
| 制限 | 値 |
|---|---|
チャート項目 (categorical) | 12 |
| チャートの系列 | 4、それぞれ最大100ポイント |
| 手順 | 12 |
| 表 | 8列 × 50行 |
| サマリーメトリクス / 事実 / 提案 | 12 / 12 / 8 |
| オプション | 12 |
html | 100,000文字 |
| ペイロード全体 | 256KB |
プライバシー
Amplitudeに送信するアーティファクトコンテンツは、生のHTML、属性、CSS、インラインSVGなど、制御できます。 分析キャプチャ用に承認されたソースデータを選択し、アプリケーションのリソース権限と除外事項を保持します。ビューアを検証しサンドボックス化することで、レンダリングが保護されます。これらの検証とサンドボックス化は、取り込みの前に機密データを削除しません。
AI SDK
アーティファクトエンベロープでは、他のツールのコンテンツやメッセージ添付ファイルと同じコンテンツキャプチャおよびリダクション設定を使用します。既存のトラッキング方法と設定済みのリダクションパイプラインを使用します。 プライベートSDKヘルパーを呼び出したり、2番目のリダクションパスを追加したりしないでください。metadata_onlyおよびcustomer_enrichedなどのモードではコンテンツ本文が省略されるため、アーティファクトはレンダリングされません。
SDKのリダクションは、設定済みのパターンとコールバックを文字列に適用します。これはベストエフォート方式であり、ブラウザのレンダリングを解釈しません。たとえば、HTML要素に分割されたメールや、CSSでエンコードされたメールが、ペイロードに残る場合があります。HTMLアーティファクトを送信しても、そのコンテンツに機密データが含まれていないことは確立されません。リダクション設定は、HTML固有の省略ポリシーを追加しません。
設定済みのリダクターは、マークアップまたはシリアル化されたJSONを変更することもできます。合成フィクスチャを使用して、実際のアウトバウンドエンベロープの構文解析可能性と忠実度を確認します。 通常のSDKのデータ秘匿設定を維持しながら、HTMLを構築する前に、除外されたソース値を選択またはマスクします。アーティファクト固有のHTML準備APIは必要ありません。インストール済みのSDKのトラッキング方法と転送制限を確認してください。
HTTP、OTLP、およびインポート
HTTP、OTLP、Batch、S3、ウェアハウスインポートは、AI SDKのプライバシー設定を継承しません。 データがソースを離れる前に、ソースパイプラインのキャプチャ、除外、およびマスキングポリシーを適用します。SDK以外のプライバシーガイドと連携の手順に従ってください。
| パス | ポリシーの強制ポイント |
|---|---|
| HTTPフォワーダー、標準のAmplitude SDK、Batch、またはS3 | イベントコンテンツを送信またはアップロードする前に |
| ネイティブOTLPまたは保存済みスパンのリプレイ | エクスポータがスパンコンテンツを送信する前に |
| ウェアハウスインポート | ソースビューにおいて、Amplitudeが読み取る前の |
| AI SDK経由で追跡されるゲートウェイまたはローカルモデル | SDKのトラッキングメソッドと、それらの設定済みのコンテンツポリシー |
Raw HTMLでは、すべてのパスで同じプロデューサー所有のコンテンツ境界があります。外部パイプラインには、アーティファクト固有のSDKヘルパーは必要ありません。既存のソースリデクターは引き続き適用されますが、文字列照合の制限は同じです。イベントスキーマまたはアーティファクトの検証チェックが成功しても、ペイロードに機密データが含まれていないことを証明するものではありません。 他の属性やエラーテキストを含む、最終的にエクスポートされたコンテンツに対して、ポリシーを確認します。
トラブルシューティング
| 症状 | 原因 |
|---|---|
| Raw JSON、カードなし | $agent_artifactエンベロープキーが欠落しているか、スペルが間違っています。 エンベロープが、ツール呼び出しのinputまたはoutput、あるいは明示的なAIレスポンスのアーティファクト添付内に存在することを確認します。 |
| 何もない。カードも生コンテンツもない | ツールのコンテンツがAmplitudeに届きません。 input /output を渡していること(toolInput/toolOutput ではないこと)、およびコンテンツモードでツールのコンテンツがキャプチャされていることを確認します。 |
| 理由付きの「アーティファクトがレンダリングされていません」 | Amplitudeはエンベロープを認識しましたが、ペイロードは検証に失敗しました。 reason は、フィールドの名前です。 修正して、再発行してください。 |
| 代替のプレゼンテーションに関する注意事項 | kindまたは shapeにはまだ専用のレンダラーがないため、Amplitudeは最も近い近似値を示しました。データは損なわれていません。 |
壊れているように見えるhtmlカード | このドキュメントは外部からの何かをロードするか、スクリプトに依存します。 データから忠実な静的スナップショットを生成します。 |
これは役に立ちましたか?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.