practical-guide · 4 min read
Turn agent questions into useful marketing pages
A worked, fictional example of choosing a page, checking its claims, and measuring what changed.
Published · Updated
A missing answer is useful when the question belongs to your product.
An agent asking a scheduling product for available appointment times has a plausible reason to be there. A scanner sending SQL fragments does not give you a content brief. Start by reading the request and its result before adding a topic to the backlog.
The example below is fictional and reports no customer traffic or measured lift.
Work through one request
Suppose an agent asks a booking service, “Can a team member offer two appointment lengths without creating two accounts?” The tool returns a general features page that says the service supports teams. That source does not answer the account question.
Before writing, check the product. Can one team member create two appointment types? Does either require a different plan? Is there a limit on calendars? If the answer depends on configuration, reproduce the workflow in an authorized test account and record the conditions.
| Decision | Evidence needed | Action |
|---|---|---|
| An existing page answers it | Exact passage and working public URL | Repair retrieval or navigation first |
| The feature exists but is undocumented | Reproduced workflow and current limits | Add a focused guide |
| The product cannot do it | Current behavior or product contract | State the limit; do not imply a workaround works |
| The request is unrelated or a probe | Request, result, and surrounding task context | Exclude it from the content opportunity list |
One question can justify a cheap documentation correction. A new category of marketing pages needs more support: related questions, relevant page entries, or repeated difficulty across distinguishable tasks. Repeated calls inside one reliably linked journey are still one journey. If you cannot link them, report calls and leave the number of independent tasks unknown.
If your logs contain only URLs, do not invent the question behind a visit. Use related page traffic to choose a small research hypothesis, inspect existing coverage, and test whether a reader can answer a specific product question. Wait for request or outcome evidence before describing that hypothesis as customer demand.
Write the page around the decision
For this fictional service, the proposed title is “Offer two appointment lengths from one team account.” The page should answer the account requirement first, then show the configuration, plan limits, expected result, and one failure case.
The example earns its space if a reader can finish the setup or decide the service will not work for them. A paragraph about flexible scheduling does neither.
Link the guide from the existing team features page and relevant help pages. Give it a stable public URL, readable HTML, and an accurate title. If your site serves Markdown, check that the same limits and instructions appear there too.
Evaluate the page before publishing
Give a reviewer the page and a fresh task: “I need a short intake call and a longer consultation under one team member. Tell me what to configure and any account limits.” Do not tell the reviewer which draft you prefer.
Ask them to quote the evidence for each instruction. Record missing steps, unsupported promises, and places where they had to guess. Revise those passages. Then use a different task, such as offering a 20-minute intake and a 50-minute consultation from the same account, to find whether the guide explains the model or merely answers the original wording.
This review checks usefulness under the tested tasks. It does not tell you whether the page will attract visitors.
Decide what would count as progress
Before launch, freeze the topic as an explicit set of existing URLs and relevant request categories. Record their reads and first entries. After launch, inspect the new page, its distribution pages, and the combined topic over equal, complete windows. Keep owner tests separate.
Track whether relevant unanswered requests become supported answers. Where a trustworthy link exists, inspect the later signup or completed setup. If it does not exist, report the answer improvement and leave conversion unmeasured.
If the new page gets reads while the old page loses the same amount, additional demand remains unproven. Inspect journey paths before attributing the change to navigation; unrelated traffic changes can produce the same pattern. If both stay quiet, follow the published links in the intended client and check whether the public retrieval path can return the new page. Record those as tests, separately from visitor demand.
The agent-traffic worksheet records the denominator and missing evidence. Use it beside Mudpie when choosing the next page.
