Prompt suggestions

suggest_sleepwalker_visibility_prompts generates prompt ideas for an AI Visibility run.

Use it when the user needs prompt ideas only. It does not query AI platforms and does not save a visibility run.

Tool

suggest_sleepwalker_visibility_prompts

Required scope:

visibility:prompts:suggest

Inputs

Input	Type	Required	Notes
url	string	Yes	URL used for context.
brand_name	string	Yes	Brand or entity the prompts should target.
language	string	No	Defaults to en.
country	string	No	Defaults to US.

Output Shape

The response returns compact prompt suggestions and billing metadata.

{
  "prompt_suggestions": {
    "url": "https://www.sleepwalker.ai",
    "brand_name": "Sleepwalker",
    "prompts": [
      "What are the best AI visibility tools for SEO teams?"
    ],
    "billing": {
      "billable": true,
      "credit_action": "visibility.prompts.suggest",
      "estimated_credits": "1.00"
    }
  }
}

Exact prompt count and wording can vary by page, language, and market.

Credits

Prompt suggestion costs 1 credit when it completes successfully.

Recommended Agent Flow

suggest_sleepwalker_visibility_prompts
  -> user confirms prompts
  -> create_sleepwalker_visibility_run
  -> poll status

Agents should not automatically turn prompt suggestions into a visibility run unless the user asked for a run or confirmed the prompts.

Example Prompts

Suggest AI Visibility prompts for Sleepwalker based on its homepage.

Generate Dutch prompt ideas for this page and brand, but do not run them yet.