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.
Agent Analytics built-in signals
このページはまだあなたの言語に翻訳されていません。 現在取り組んでいますので、後でもう一度確認してください。
Built-in signals are the quality checks Amplitude runs on every closed agent session, with no setup. Each signal answers one question about the session, such as whether the agent completed the task. Its result lands as a property on the session's [Agent] Session Record event, so you can chart, filter, and build cohorts on it right away.
Use built-in signals for questions every agent shares. For checks specific to your product, such as whether the agent quoted the right policy, add a custom evaluator instead. Refer to Set up custom evaluators.
Signals at a glance
| Signal | Question it answers | Result property | Also writes |
|---|---|---|---|
| Task Completed | Did the agent complete the user's request? | [Agent] Task Completed | Rationale, evidence |
| Response Quality | Was the response accurate, clear, and well-structured? | [Agent] Response Quality | Rationale, evidence |
| Session Safety | Was this legitimate usage, or adversarial or off-topic? | [Agent] Session Safety | Rationale |
| User Intent | What type of request was the user making? | [Agent] User Intent | Rationale |
| User Friction | Did the conversation show patterns of a rough experience? | [Agent] Has User Friction | Rationale, detected patterns |
| Has Negative Feedback | Did the user explicitly express dissatisfaction with the agent? | [Agent] Has Negative Feedback | Rationale, detected phrases |
| Data Quality Issues | Did responses or tool calls have mechanical problems? | [Agent] Has Data Quality Issues | Rationale, evidence, detected issues |
Every signal writes a rationale: a short explanation of why the session got its result. Where a signal writes evidence, it points to the part of the session that supports the result. Signals are directional indicators, not ground truth. Read the rationale before you act on a single session, and trend signals across many sessions.
Task Completed
Did the agent complete the user's request by the end of the session? Task Completed credits recovery: a session where early tool calls fail but the agent then delivers what the user asked for counts as completed. It doesn't judge tone, formatting, or writing style.
| Value | Meaning |
|---|---|
True | The agent addressed and resolved the user's request. |
False | The user's request wasn't fulfilled. |
Properties: [Agent] Task Completed, [Agent] Task Completed Rationale, [Agent] Task Completed Evidence.
Response Quality
Were the agent's responses accurate, clear, and well-structured? Response Quality judges the response text independent of whether the task got done, which Task Completed measures. A brief, clear answer that addresses the user counts as high quality.
| Value | Meaning |
|---|---|
True | The response is accurate, clear, and adds value. |
False | The response is incorrect, incoherent, incomplete, or unhelpful. |
Properties: [Agent] Response Quality, [Agent] Response Quality Rationale, [Agent] Response Quality Evidence.
Session Safety
Was the conversation legitimate usage, or adversarial or off-topic? Session Safety assigns one label per session.
| Value | Meaning |
|---|---|
Normal | Legitimate usage. The user is trying to accomplish a task. |
Off Topic | Unrelated to the agent's purpose. |
Prompt Injection | The user tried to override instructions, bypass guardrails, or remove constraints. |
Abuse | Hostile, offensive, threatening, or spam content. |
Probing | The user tested the agent's boundaries or capabilities without a real task. |
Unsafe Output | The agent produced harmful, toxic, or policy-violating content. |
Data Leak | The agent exposed sensitive data, such as PII, credentials, or internal information. |
Properties: [Agent] Session Safety, [Agent] Session Safety Rationale.
User Intent
What type of request was the user making? User Intent classifies the user's request, not the agent's response. When a conversation evolves, it uses the dominant intent across the session, and a greeting that leads into a task counts as the task.
| Value | Meaning |
|---|---|
Information Request | The user wants facts, data, lookups, or existing knowledge. |
Analysis & Synthesis | The user wants information compared, summarized, explained, or analyzed. |
Task Execution | The user wants the agent to perform an action, solve a problem, or run a task. |
Content Creation | The user wants content generated, written, edited, or translated. |
Advice & Recommendation | The user wants opinions, suggestions, or subjective guidance. |
Off-Topic / Social | Greetings, questions about the agent itself, or requests outside its scope. |
Properties: [Agent] User Intent, [Agent] User Intent Rationale.
User Friction
Did the conversation show patterns that suggest a rough experience? Examples include the user repeating the same request, long clarification loops, consecutive tool failures, early abandonment, and the agent losing earlier context. User Friction reads behavior, so it can flag a session even when the user never complains.
| Value | Meaning |
|---|---|
True | One or more friction patterns appear in the session. |
False | No friction patterns appear. |
Properties: [Agent] Has User Friction, [Agent] User Friction Rationale, and [Agent] Detected User Friction, which lists the patterns found.
Has Negative Feedback
Did the user explicitly express dissatisfaction with the agent? Examples include saying an answer is wrong, frustration aimed at the agent, rejecting an answer as a complaint, giving up or asking for a human, and a low rating. Normal iteration, such as rephrasing a request or asking a follow-up, doesn't count. Behavioral patterns without a complaint belong to User Friction.
A thumbs down or low rating that your app sends as an [Agent] Score also counts. Refer to Collect user feedback.
| Value | Meaning |
|---|---|
True | The user explicitly expressed dissatisfaction with the agent. |
False | The user expressed no explicit dissatisfaction. |
Properties: [Agent] Has Negative Feedback, [Agent] Negative Feedback Rationale, and [Agent] Detected Negative Feedback, which lists what the user said.
Data Quality Issues
Did the agent's responses or tool calls have mechanical problems? Response problems include empty responses, errors shown to the user, truncated output, repeated content, and refusals. Tool problems include failed or malformed calls, timeouts, rate limits, and provider errors.
| Value | Meaning |
|---|---|
True | One or more data quality issues appear in the session. |
False | No data quality issues appear. |
Properties: [Agent] Has Data Quality Issues, [Agent] Data Quality Rationale, [Agent] Data Quality Evidence, and [Agent] Detected Data Quality Issues, which lists the issues found.
Signals and privacy modes
Most signals read message text. In metadata_only and customer_enriched, sessions carry no text, so those signal properties are absent from the Session Record rather than reported as failures. Data Quality Issues still reports in every mode. Refer to Agent Analytics privacy modes.
Where to analyze signals
Signal results appear on the Agent Analytics dashboards and on each session in the session viewer. To build your own charts, use the [Agent] Session Record event and its signal properties. Task Completed and Response Quality are true or false, so trend them as the share of sessions where the value is True. For the full Session Record property list, refer to Agent Analytics taxonomy.
Last verified on October 6, 2026.
これは役に立ちましたか?