Docs

Help desk / Teach the agent / Knowledge

Playground

Ask a question and see which articles and indexes Risotto's agent finds and how it answers, optionally as a specific user or department

The Playground tests Risotto's knowledge with your own questions. It searches your organization's current articles and indexes the way the agent does for a ticket, shows each step of the search, and then shows the answer. When it searches Slack indexes, it includes public channels only.

You find it in Knowledge > Playground. The Playground tab shows for Org Admins and Org Managers, and for anyone who manages the settings of at least one department, such as a Department Supervisor.

Using the Playground

  1. Open the Playground

    Click Knowledge in the sidebar, then the Playground tab.

  2. Optionally, pick a user

    Click the person icon on the left of the query box, search for a user, and pick them. Their name shows next to the icon, and Risotto searches with their profile, so profile filters on your indexes apply as they would for that user. To go back to searching without a user, pick Clear.

    Without a user, profile filters don't limit the search.

  3. Optionally, pick a department

    Pick a department in the select on the right of the query box. Risotto searches organization-wide content plus that department's. The General department, marked (default), is selected if you have it; otherwise your first department is.

  4. Ask your question

    Type a question, such as "How do I connect to the VPN?", and click Search. The button reads Searching... until the answer is ready.

Reading the response

The Response card first shows the steps of the search, in order:

  1. Searching for '…': the question as you typed it.
  2. Executing search: Risotto searches your articles and indexes.
  3. Optimizing query: shows only when the first results are weak, and Risotto searches again with rewritten queries.
  4. Found N potential sources: how many distinct documents matched.
  5. Reranking N sources by relevance: Risotto orders the matches by how well they answer the question.
  6. Generating answer from N sources: the sources the answer is written from, each linked by its title. A Slack source shows as Slack thread.
  7. Refining answer: Risotto checks the answer against its sources.

Below the steps is the answer. Each claim ends with a numbered link to the source it comes from. If Risotto finds nothing relevant, the answer reads "Risotto is unable to find an answer and would escalate for help.", which is when the agent would escalate the ticket to your team.

Indexes whose Audience is Assistant only are not searched, because requesters don't get answers from them.

Something wrong or missing? Report an issue · View as Markdown