Source: https://docs.pageloop.ai/guides/ask-pageloop

# Ask Pageloop

# Ask Pageloop

Use Ask to find and understand your workspace's documentation, explain an Inbox suggestion, or get help using Pageloop. Keep a chat beside the page you are reviewing, or open the Ask page for a full-page conversation.

> [!NOTE]
>
> Ask in the Pageloop app is available to admins and editors. Contributors do not have Ask. Slack has separate access rules, described below.

## Ask a question

1. Select **Ask** in the sidebar to open the Ask page.
2. Type a question in **Ask Pageloop**. Name the article, topic or Inbox item you want help with, and say what you need to know.
3. Choose an [Answer depth](#choose-an-answer-depth), or leave **Standard** selected.
4. Select **Send**, or press Enter.
5. Read the answer and any linked sources. Ask a follow-up in the same chat to clarify the answer or narrow the task. If Ask needs information from you, answer its questions before continuing.

### Ask beside a page

Select **Ask** in the page header to open the side panel without leaving the page. Use the panel when you want help with an article, an Inbox item or the settings you are looking at. Ask receives context about the page, so you can ask questions such as “Summarise this article” or “Why was this suggested?”

- Select **Expand to full page** in the panel header to continue the same chat on the Ask page.
- Select **Close** to hide the panel.
- Select **New chat** (the plus button in the panel header) to start a separate conversation. The Ask page also has a **New chat** button. Use a separate chat when you switch to an unrelated topic.
- Select **Chat history** to return to an earlier conversation.

![Ask beside a knowledge base article, with Suggested prompts and panel controls](/images/uploads/screenshot-f9a3b6fb.png)

### Use suggested prompts

An empty chat offers prompts you can select to send a question immediately. On the Ask page, prompts include **Review my Inbox**, **Find outdated articles** and **How do I invite an editor?**

In the panel, the **Suggested** list changes with the page. An article offers **Summarise this article** and **Which pages link here?** An Inbox item offers questions about why the change was suggested and which articles it edits. Use these prompts as starting points, then ask a follow-up with the details you need.

## Choose an Answer depth

Select the depth control beside **Attach** in the composer before sending your question. The control shows the selected option: **Fast**, **Standard** or **Deep**. Pageloop remembers your selection in that browser.

| Option       | When to use it                                                                                    | What changes in the response                                              |
| ------------ | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| **Fast**     | Try it for a straightforward lookup, a short summary or a question about where to find a setting. | Uses a quicker model if one is set up; otherwise uses the default model.  |
| **Standard** | Use it for everyday questions about your docs, Inbox and Pageloop. It is the default selection.   | Uses the default model.                                                   |
| **Deep**     | Try it for a complex question that compares articles or needs careful reasoning.                  | Uses a stronger model if one is set up; otherwise uses the default model. |

Answer depth selects the model used to answer; it does not select a different set of sources or tools. **Deep** does not guarantee a longer answer or a wider search, and **Fast** does not guarantee a shorter answer. Tell Ask explicitly if you want a brief summary, a detailed explanation or a comparison table. If separate models have not been set up, all three options use the default model.

![The Ask page with the Answer depth menu showing Fast, Standard and Deep](/images/uploads/screenshot-6d77a4e8.png)

## Useful questions to ask

Ask helps with Pageloop and your workspace's documentation, rather than unrelated general-purpose questions. Give Ask a topic, page title or desired outcome so the answer has a clear scope.

| Goal                    | Example question                                                                 |
| ----------------------- | -------------------------------------------------------------------------------- |
| Find documentation      | “Which articles explain SSO setup?”                                              |
| Understand a page       | “Summarise this article for someone setting up the product for the first time.”  |
| Compare coverage        | “Compare our SSO setup articles. Where do they repeat the same instructions?”    |
| Improve wording         | “Rewrite this paragraph in plain language without changing the steps or limits.” |
| Understand a suggestion | “Why was this suggested, and which articles does it edit?”                       |
| Prioritise review       | “What should I review first in my Inbox?”                                        |
| Learn Pageloop          | “How do I invite an editor?”                                                     |
| Understand your setup   | “Which integrations are connected, and what would Linear add?”                   |

## Turn a conversation into a docs run

When you explicitly ask Ask to write or update documentation for a product change, Ask can start a docs run automatically as its answer ends. The chat shows a link to the run. This also applies when you ask for documentation in a Slack conversation.

Give Ask the product change, the affected articles and any important steps, permissions or limits. For example: “Our CSV export includes only rows matching the selected filters. Update the export guide to explain this.”

Some tasks appear as proposals with a **Start** button instead. For example, Ask waits for **Start** before reworking an Inbox item's existing proposal. If someone answers a web-chat question through Slack and Ask then proposes a docs run, the original asker must press **Start** in the Pageloop chat. Review the proposed task first: these runs only start when you press **Start**.

A docs run produces proposed changes for review in the **Inbox**. Starting a run does not publish the changes. Review the result in Pageloop before publishing.

## Ask from Slack

Use Ask in a Slack workspace connected to your Pageloop workspace. An admin manages the connection from **Integrations**. Run questions from work started outside Slack need a configured Slack notification channel.

> [!NOTE]
>
> Full members of the connected Slack workspace can ask and answer questions, even without a Pageloop account. Guests and people outside that Slack workspace cannot. This includes Slack members whose Pageloop app role is Contributor. Choose the connected workspace and notification channel with this access in mind: questions posted to the channel are visible to its members.

### Start and continue a conversation

1. Mention **@Pageloop**, or start a message with “pageloop”, followed by your question. For example: “@Pageloop Which articles explain SSO setup?”
2. Read Ask's answer in the Slack thread. Ask can use the earlier messages in that thread as context.
3. Reply in the same thread to continue. You do not need to mention Pageloop again in a thread where Ask is already answering. A reply addressed to another person, a group or the channel is left alone.

If Ask asks a conversational follow-up in the thread, reply there. For a paused docs run's questions, use the form described below instead of a plain thread reply.

You can also ask Pageloop to document a change discussed in the thread. The thread receives the run link and the outcome; review the proposed documentation in Pageloop before publishing.

### Answer the agent's run questions

When a docs run pauses for your input, Pageloop posts its questions to the run's Slack thread. If the run did not start in Slack, the questions go to the configured notification channel. Help center runs are included.

1. Select **Answer questions** on the Slack message.
2. Complete the questions in the **Pageloop questions** form. Choose the requested options or type an answer, and add details where the form allows them.
3. Select **Send answers** to submit the whole round. The run continues with your answers.

The message shows who answered. If someone answers in Pageloop instead, the Slack message changes to **Answered in Pageloop**. Use **Open in Pageloop** to review the run or answer there.

### Answer a question from a Pageloop chat

Ask can also send an unanswered question from a web chat to the Slack notification channel after about 10 minutes. The post is titled **A question from Ask in Pageloop** and has **Answer questions** and **Open in Pageloop** buttons.

Use **Answer questions** to submit the answer form. Your answers become the next message in the original chat, with your Slack name attached. Ask continues in Pageloop, not as a separate Slack conversation. The Slack post says who answered and that the chat is continuing in Pageloop. If the chat has already moved on, the old question no longer needs an answer.

### If Slack does not answer

- If the Slack connection shows **Needs reconnecting**, ask an admin to reconnect it in **Integrations**.
- A Slack workspace connected to more than one Pageloop workspace cannot use Ask or receive run posts. Ask an admin to keep a single Pageloop connection for that Slack workspace.

For documentation page structure and navigation conventions, see [Writing docs](/guides/writing-docs).
