AI-generated descriptions

이 페이지는 아직 귀하의 언어로 번역되지 않았습니다. 현재 작업 중이므로 곧 다시 확인해 주십시오.

On paid plans, Amplitude generates suggested descriptions for events, event properties, and user properties. Suggestions appear in the description area of the details panel. Amplitude doesn't save a suggestion to the description automatically, and any existing description stays visible until you act on the suggestion.

To write descriptions yourself, refer to Edit event and property details.

Where descriptions come from

Amplitude draws from two sources:

  • Uploaded files: Files you upload to a project under Settings > AI Controls, such as a data dictionary or a product spec. Amplitude treats these as the most authoritative source and prefers them over everything else. Refer to file uploads for details.
  • Project data: The project's own Amplitude data, including the event or property name, any existing description, how it's used across the project, and the values it takes.

Amplitude only suggests a description it can trace back to one of these sources. An event or property with thin usage and no matching file gets no suggestion, because an empty description is more useful than a vague one.

Only files scoped to a project describe that project's events and properties. Organization-level files support other Amplitude AI features but don't feed event or property descriptions. After you upload a file to a project, descriptions for that project refresh within a few minutes.

Upload a data dictionary

For the best results, upload a data dictionary to your project. A data dictionary is a document that lays out the project's taxonomy: its events, the properties on those events, and what each means. Amplitude relies on it more heavily than on anything it can infer from usage data alone, so projects with a data dictionary get noticeably better suggestions than ones without.

Amplitude matches files to events and properties by name. A data dictionary row for Order Placed describes that event. For properties, type also matters. A row documenting a user property doesn't apply to an event property with the same name.

Where suggestions appear

Suggestions appear in two places:

  • In Data: Go to Events or Properties and select an event or property. The suggestion appears in the Description field in the details panel. Suggestions never appear in the Events or Properties tables, only in the details panel.
  • In chart dropdowns: When you pick an event or property for a chart, the suggestion appears in the details panel next to the list. Some dropdowns are read-only. In those cases, accept or decline the suggestion from Data.

Identify a suggestion

A suggestion looks different from a manually written description:

  • Suggestions have a dotted underline. A description someone wrote doesn't.
  • Hovering over the underlined text opens a tooltip naming the source: the uploaded file it came from (all files, if more than one contributed), or "Amplitude charts, dashboards, and product metadata" when it came from the project's Amplitude data alone.
  • The appearance depends on what's already in the description field. With no existing description, the suggested text appears on its own. When the existing description is incomplete, Amplitude suggests text that fills the gap and keeps the original, adding the new part as a second paragraph. When Amplitude suggests a full replacement, it strikes through the current text and shows the replacement after it.

Act on a suggestion

To review a suggestion:

  1. Select the suggestion to open an editor holding the suggested text.
  2. Do one of the following:
    • Select Apply to accept the text as-is.
    • Edit the text, then select Apply to accept a modified version.
    • Select Revert to decline the suggestion and keep the original description.
    • Select Cancel to leave everything as-is for now.

Once you accept or decline a suggestion, it doesn't come back. Amplitude already uses the suggested text for search and other AI features before anyone reviews it, so accepting confirms it rather than turns it on.

What Amplitude doesn't suggest

Amplitude doesn't generate suggestions for events and properties it defines itself, for custom events, or for transformations. If an event property has an override on a specific event, Amplitude only suggests a description when that override has no description yet. Accepting writes the override, not the shared property description.

이 내용이 도움이 되었나요?

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.

이 페이지에서