This guide explains how to create an audience using the Audience Agent, from describing your goals, through reviewing and refining the agent’s proposal, to saving the finished audience.
\nThe agent panel opens with a message box and a set of starter prompts for common ways to begin, such as “I have a campaign goal, help me define the right audience” and “Show me what data I have to work with.”
\nIn the message box, describe the audience in plain language - either a specific definition (“users who purchased in the last 7 days”) or a goal (“re-engage customers who lapsed after one purchase”). You don’t need to know your event or attribute names.
\nThe agent shows its proposal in two phases: an audience definition card, which you can respond to with additional questions and prompts to refine your audience, and an audience proposal card when you are done refining your audience and are ready to save.
\nThe audience definition card includes the suggested name, a summary of who qualifies, an estimated audience size, and a prompt asking you to confirm the definition or refine it.
\n![\"Audience](\"/images/guides/segmentation/audiences/audience-agent/audience-definition.png\")
\nThe card header shows the audience name and an estimated size. While the agent calculates, the size shows a loading indicator. If the population is too small to estimate reliably, a warning icon appears instead of a number. Hover over it for the reason: “Population is too small to accurately estimate.”
\n![\"Audience](\"/images/guides/segmentation/audiences/audience-agent/name-and-size.png\")
\nThe card lists which inputs the audience draws from, such as “All (2) inputs from current workspace,” and the environment it targets, such as Production.
\n![\"Audience](\"/images/guides/segmentation/audiences/audience-agent/data-source-environment.png\")
\nIf you have more than one workspace, you can change the workspace selected by hovering over “From … workspace” and click Update workspace(s) selection.
\nEach row states the rule in plain language, such as “performed Purchase at least 1 time in the last 7 days.” Event and attribute names appear in color to show they were resolved against real entities in your workspace.
\n![\"Audience](\"/images/guides/segmentation/audiences/audience-agent/audience-criteria.png\")
\nEach rule row shows how many platforms it draws from, such as “From 2 platforms.” Hover over it to see which platforms and feeds are included, and click Update platform(s) or feed selection in that popover to adjust them.
\n![\"Audience](\"/images/guides/segmentation/audiences/audience-agent/platform-coverage.png\")
\nRead the summary to confirm the agent interpreted your intent correctly before moving on.
\nIf the definition is too broad, too narrow, or not quite right, reply conversationally with a follow-up like “make it the last 14 days” or “only users who purchased more than 3 times.” The agent updates the definition and creates a new version.
\nEach definition is tracked as a numbered version in the Size calculation bar at the top of the panel (Audience 1, Audience 2, and so on). Each version shows its own size estimate, and clicking a version jumps back to that definition in the conversation, so you can compare definitions before deciding which one to save.
\n![\"Audience](\"/images/guides/segmentation/audiences/audience-agent/audience-selectors.png\")
\nWhen you are happy with the final definition, the agent will display the audience proposal card summarizing the finalized audience proposal.
\n![\"Audience](\"/images/guides/segmentation/audiences/audience-agent/audience-proposal.png\")
\nNothing is saved until you click Proceed to Save. To return to drafting, click Continue Refining.
\nAfter saving, the audience appears in your Audiences list and behaves like any other audience. To connect and activate it, follow Connect an Audience — the agent does not connect audiences to destinations.
\n\nSeveral controls are available in the agent panel itself to help you manage your conversation:
\nHover the warning for the reason. “Population is too small to accurately estimate” means too few users currently match. Change the definition (for example, broaden it using a longer time window), and the size will recalculate.
\nThe agent only uses signals that exist in your workspace and won’t substitute a weak proxy. If your request needs a metric that isn’t instrumented, it explains the dependency.
\nMulti-node structures, editing existing audiences, scheduled audiences, and audience activation are out of scope for this release. The agent explains the limitation and offers the closest useful next step. For manual control, use the Audience Builder.
","frontmatter":{"title":"Building Audiences with the Agent","order":2,"seoTitle":null,"seoDescription":null},"parent":{"__typename":"File","modifiedTime":"June 15, 2026"}}},"pageContext":{"slug":"/guides/segmentation/audiences/audience-agent/user-guide/"}},"staticQueryHashes":["2950460867"]}