Skip to content

Commit 66bed35

Browse files
committed
docs(search): add customer guides and sourced examples
1 parent a9d5dc8 commit 66bed35

15 files changed

Lines changed: 401 additions & 12 deletions

‎apps/docs/content/docs/meta.json‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,12 +5,13 @@
55
"./introduction/index",
66
"./getting-started/index",
77
"./desktop/index",
8+
"---Sim Search---",
9+
"search",
810
"---Build---",
911
"chat",
1012
"workflows",
1113
"agents",
1214
"---Workspace---",
13-
"search",
1415
"knowledgebase",
1516
"tables",
1617
"files",

‎apps/docs/content/docs/search/ask-questions.mdx‎

Lines changed: 38 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Your organization must enable Search and make a source available to you. [Connec
1212
## Ask your first question
1313

1414
1. Open **Home** in the organization sidebar. From a workspace, open the workspace menu and select **Back to organization** first.
15-
2. If the conversation mode picker is shown, choose **Search** before sending your first message.
15+
2. Choose **Search** in the conversation-mode menu before sending your first message.
1616
3. Ask a specific question and press **Enter**.
1717

1818
For example:
@@ -32,7 +32,7 @@ Include the project, topic, or timeframe that matters. If you know where the ans
3232

3333
> Find our launch plan in Confluence. Summarize the scope and the launch date, with sources.
3434
35-
Search mode finds and reads information. Use **Build** in a new conversation when you want Sim to take actions or change resources.
35+
Search mode finds and reads information. You can also ask it to [draft content from the findings](/search/create-content); the draft stays in the conversation until you choose where to use it.
3636

3737
## Check the sources
3838

@@ -56,14 +56,50 @@ You don't need to repeat the original question. Ask for the next useful detail:
5656
5757
Review the cited material for each answer. A summary can miss context, and an unavailable source can leave a gap. Sim can only retrieve content allowed by your account and the organization's source settings.
5858

59+
## Summarize and compare
60+
61+
Specify what you want extracted, rather than just “summarize this.”
62+
63+
| Task | Example prompt |
64+
| --- | --- |
65+
| Compare options | “Compare the two onboarding proposals in a table: scope, effort, risks, and dependencies. Cite each source.” |
66+
| Catch up on a project | “What decisions were recorded for Atlas this month? Separate agreed decisions from suggestions.” |
67+
| Find an owner | “Who owns the launch checklist? Cite the document that assigns responsibility.” |
68+
| Resolve a disagreement | “These documents give different dates. Compare their context and identify what is confirmed.” |
69+
70+
If the sources don't assign an owner or confirm a date, ask Sim to say so. Include the timeframe you care about, and distinguish a document's update date from the event it describes. A live search is still subject to provider freshness and retrieval limits.
71+
72+
## Prepare for a meeting
73+
74+
Connect Google Calendar and the apps that hold your team's documents, such as Confluence and Google Drive. Then ask Sim to bring the meeting details and relevant project context together:
75+
76+
> Find the Atlas readiness review on November 16, 2026 in my calendar. Use the Atlas project pages in Confluence and the readiness update and pilot feedback in Google Drive to prepare a brief: meeting time, decisions needed, open questions, and what I should read beforehand. Cite the sources.
77+
78+
Use your own meeting name and date. Naming the meeting and its related documents helps Sim find the right context. If you need a particular time zone, include it in the request.
79+
80+
Follow up with “Turn the open questions into a proposed agenda” or “Which items need an update from each owner?” Check the event citation for scheduling details and the document citations for project facts. The proposed agenda is a draft; it doesn't change the calendar event.
81+
82+
<Image
83+
src="/static/search/atlas-readiness-brief.webp"
84+
alt="Atlas readiness brief showing the November 16 meeting at 10:00–10:30 AM Pacific with a Google Calendar citation"
85+
width={1470}
86+
height={470}
87+
variant="result"
88+
background="ridges"
89+
/>
90+
5991
## Start from a document
6092

6193
If you already found the right document in **Search**, open its **…** menu and select **Summarize**. Sim starts a conversation focused on that result. Continue with questions about its decisions, dates, or next steps.
6294

95+
You can also paste a relevant excerpt or attach an image to add context. Search conversations accept images; retrieve PDF or spreadsheet content through connected sources.
96+
6397
Your conversations remain private to you. Copying a source link does not give someone else access to the original document.
6498

6599
## Related docs
66100

101+
- [Create content](/search/create-content): Draft and refine useful text from your findings.
102+
- [Use cases and example prompts](/search/use-cases): Apply Search to everyday work.
67103
- [Find content](/search/find-content): Search directly, filter results, and reopen recent sources.
68104
- [Connect your account](/search/connect-your-account): Check source connections and recover access.
69105
- [Use Sim Search in Slack](/search/slack#use-sim-search-in-slack): Ask questions from Slack when your organization has enabled it.

‎apps/docs/content/docs/search/connect-your-account.mdx‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,8 @@ title: Connect your account
33
description: Authorize your provider accounts and manage their Search connections
44
---
55

6+
import { Image } from '@/components/ui/image'
7+
68
After your admin adds a source in **Settings → Sources**, connect your own account in **Integrations**. This applies to admins too. A service source usually still requires your personal connection.
79

810
## Connect and verify
@@ -12,6 +14,17 @@ After your admin adds a source in **Settings → Sources**, connect your own acc
1214
3. Complete authorization in the new tab. If the popup is blocked, allow it and select **Connect** again.
1315
4. Return to **Search** or **Home** and search for content your account can open. Read a result and follow its source link.
1416

17+
<Image
18+
src="/static/search/connect-confluence.webp"
19+
alt="Confluence in Integrations with the Connect button before an account has been authorized"
20+
width={1340}
21+
height={180}
22+
variant="detail"
23+
background="architecture"
24+
/>
25+
26+
Once an account is connected, **Add account** lets you authorize another account for that provider.
27+
1528
The connection is usable when authorization completes; no initial indexing run is required. If a provider is missing, ask an admin to add it in **Sources**. `Not configured` means its app or deployment setup needs an admin's attention.
1629

1730
You do not choose repositories, channels, labels, or an indexing method during personal authorization. Member mode uses your provider access; service mode further restricts results with the admin's source settings.
Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
title: Create content from company knowledge
3+
description: Turn sourced answers into briefs, updates, emails, and other drafts in the conversation.
4+
---
5+
6+
import { Image } from '@/components/ui/image'
7+
8+
On **Home**, use **Search** conversation mode. Once you've found the right information, ask Sim to turn it into something you can use. Draft a customer response, a meeting brief, an internal announcement, or an FAQ in the conversation.
9+
10+
<Image
11+
src="/static/search/launch-update-draft.webp"
12+
alt="A refined Atlas launch update with links to the Google Drive launch brief and readiness update beside the supporting claims"
13+
width={1470}
14+
height={1000}
15+
variant="result"
16+
background="architecture"
17+
/>
18+
19+
## Start with the evidence
20+
21+
For work that depends on company facts, first identify the sources:
22+
23+
> Find the Atlas launch brief and the latest rollout decision. Summarize the approved scope, intended audience, and confirmed dates with sources.
24+
25+
Review the answer, then ask for a draft:
26+
27+
> Using those findings, draft an internal launch announcement for customer success. Keep it under 200 words. Include what is changing, who it affects, and what the team needs to do. Mark any unconfirmed details as questions.
28+
29+
You can combine both requests in one prompt when the scope is clear.
30+
31+
## Specify the output
32+
33+
Include four details: **source material, audience, format, and constraints**.
34+
35+
| Detail | Example |
36+
| --- | --- |
37+
| Source material | “Use the approved onboarding guide and these account notes.” |
38+
| Audience | “Write for a new customer who hasn't used the product.” |
39+
| Format | “A welcome email with three next steps.” |
40+
| Constraints | “Under 150 words, friendly and direct. Don't invent dates or commitments.” |
41+
42+
The draft appears in the conversation. You can copy it into the document or communication tool where you want to use it.
43+
44+
## Choose a useful format
45+
46+
### Briefs and updates
47+
48+
> Turn the Atlas findings into a one-page project brief: goal, current status, decisions, risks, and unanswered questions. Keep source references next to factual claims.
49+
50+
### Emails and customer responses
51+
52+
> Using our implementation guide, draft a response explaining the customer's next onboarding steps. Keep internal discussion out of the customer-facing text and list supporting sources separately for my review.
53+
54+
### FAQs and onboarding material
55+
56+
> Create a new-hire FAQ from the onboarding guide. Include questions about access, equipment, and getting help. Flag questions the guide doesn't answer.
57+
58+
### Meeting preparation
59+
60+
> Use the available Acme account notes to draft a meeting brief with context, open questions, and a proposed agenda. Distinguish documented customer requests from suggested discussion topics.
61+
62+
### Presentation outlines
63+
64+
> Turn these findings into a six-slide outline for a team update. For each slide, give a title, three key points, and the sources supporting them.
65+
66+
## Refine the draft
67+
68+
Continue with specific changes:
69+
70+
- “Cut this to half the length without losing the action items.”
71+
- “Use the tone of this example: [paste an approved example].”
72+
- “Move the recommendation to the opening paragraph.”
73+
- “Make the terminology consistent with the product guide.”
74+
- “Separate confirmed facts from proposed next steps.”
75+
76+
Provide a style example or brand guidance when consistency matters. Don't assume Sim already knows a team's preferred tone.
77+
78+
## Review and use it
79+
80+
Check names, numbers, dates, links, and commitments against the sources. For an external audience, also check that the draft includes only information intended for that audience.
81+
82+
Copy the reviewed draft into the app where you want to use it. Sim Search creates the text in your conversation; you choose when and where to share it.
83+
84+
[Explore more example prompts](/search/use-cases).

‎apps/docs/content/docs/search/find-content.mdx‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,15 @@ Your organization must enable Search and make a source available to you. [Connec
1717

1818
Read the title and excerpt to find the relevant result. Each result shows its source, with an author and date when available. Select the title to open the original.
1919

20+
<Image
21+
src="/static/search/atlas-document-results.webp"
22+
alt="Search results for the Atlas onboarding checklist in Confluence, with the organization sidebar and document excerpts"
23+
width={2660}
24+
height={900}
25+
variant="overview"
26+
background="san-francisco"
27+
/>
28+
2029
## Narrow the results
2130

2231
Use the filters beneath the search field:

‎apps/docs/content/docs/search/index.mdx‎

Lines changed: 17 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,27 @@
11
---
2-
title: Search
3-
description: Find content in connected sources with your current account access
2+
title: Sim Search
3+
description: Find company knowledge, get answers with citations, and draft from connected sources.
44
---
55

6-
Search queries your connected sources when you ask. Results reflect your account's current access and your organization's source settings. Search does not copy documents into a Sim vector index or wait for a background sync.
7-
8-
Use **Search** to find documents directly, or ask Sim on **Home** for an answer with sources. [Sim Search in Slack](/search/slack) and [Search MCP](/search/mcp) use the same retrieval and access rules. Search mode can search and read sources; it does not expose arbitrary integration actions.
6+
Sim Search helps you find and use information from your company's connected apps. Look up a document, ask a question across sources, catch up on a project, or turn what you find into a brief, update, or draft.
97

108
## Use Search
119

12-
- [Find content](/search/find-content): Search for a document, narrow the results, and open the original.
13-
- [Ask questions](/search/ask-questions): Get an answer with sources and explore it in a conversation.
10+
| You want to… | Start here |
11+
| --- | --- |
12+
| Find and browse documents | [Find content](/search/find-content): open **Search** in the organization sidebar. |
13+
| Get an explanation or compare sources | [Ask questions](/search/ask-questions): open **Home** and choose **Search** conversation mode. |
14+
| Understand a particular result | Open the result's **… → Summarize** menu, then ask follow-up questions. |
15+
| Create a draft from your findings | [Create content](/search/create-content): ask for an update, email, FAQ, or presentation outline in the conversation. |
16+
| Prepare for a meeting | [Combine Calendar and project sources](/search/ask-questions#prepare-for-a-meeting) into a brief with decisions and reading material. |
17+
18+
For example, ask “Why did the Atlas launch date change? Use the project documents in Confluence and Google Drive, and cite the sources.” Open the citations to check the evidence, then continue with “What does each owner need to do before launch?”
19+
20+
Search mode retrieves and reads information and drafts text in your conversation. It does not send the draft or change source records. You choose where to use the reviewed result.
21+
22+
Start with [Get started](/search/quickstart) or browse [use cases and example prompts](/search/use-cases). [Connect your account](/search/connect-your-account) if your source requires a personal connection. The source setup below is for organization admins.
1423

15-
Already invited to Sim? Start with either guide and [connect your account](/search/connect-your-account) when your source requires it. The setup below is for organization admins adding sources.
24+
When enabled by your organization, [Sim Search in Slack](/search/slack#use-sim-search-in-slack) and [Search MCP](/search/mcp) let you search from other tools using the same retrieval and access rules.
1625

1726
## Add your first source
1827

‎apps/docs/content/docs/search/meta.json‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,13 @@
11
{
2-
"title": "Search",
2+
"title": "Sim Search",
33
"pages": [
44
"---User guides---",
5+
"quickstart",
56
"find-content",
67
"ask-questions",
8+
"create-content",
9+
"use-cases",
10+
"troubleshooting",
711
"---Connect sources---",
812
"connect-your-account",
913
"coda",
Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
---
2+
title: Get started
3+
description: Connect an app, find a document, and turn it into a useful answer.
4+
---
5+
6+
Use this walkthrough to go from a question to a useful answer. Choose a topic you know a little about, such as your team's onboarding guide or a current project.
7+
8+
## 1. Connect your apps
9+
10+
Open your organization's Sim home and select **Integrations** in the sidebar. Find an app you use and select **Connect**. Complete authorization with the work account that can open the content you need.
11+
12+
Your admin must enable the source first. If you don't see it, ask them to check **Settings → Sources**. Some organization-managed sources have a different connection process; see [Connect your account](/search/connect-your-account).
13+
14+
Once authorization finishes, you can search. You don't need to wait for a Sim indexing run.
15+
16+
## 2. Find a document
17+
18+
Select **Search** in the organization sidebar. Enter a few distinctive words and submit:
19+
20+
> customer onboarding checklist
21+
22+
Scan the titles and matching passages. Select a result to read it. If the results aren't what you expected, change the words or choose a source from **All sources**.
23+
24+
You can also search with a question:
25+
26+
> Where are the instructions for onboarding a new customer?
27+
28+
## 3. Summarize what you found
29+
30+
Open a result's **…** menu and choose **Summarize**. Sim opens a conversation on Home and uses that document as the starting point.
31+
32+
Read the summary and follow its citations to check the source. Then ask:
33+
34+
> Turn the onboarding steps in this document into a checklist. Keep the source references.
35+
36+
## 4. Ask a broader question
37+
38+
For a question across documents, open **Home** and select **Search** in the conversation-mode menu. Ask:
39+
40+
> What does a new account owner need to know about customer onboarding? Find the relevant guides, summarize the key steps, and cite the sources.
41+
42+
You can continue in the same conversation:
43+
44+
> Which steps require help from another team?
45+
46+
## 5. Make the answer useful
47+
48+
Ask for the output you need:
49+
50+
> Turn those findings into a short welcome email I can review and send to a new teammate.
51+
52+
The draft appears in the conversation. Review names, dates, commitments, and supporting sources before using it.
53+
54+
## Make your next request specific
55+
56+
Include a topic, a scope, and a desired result:
57+
58+
> Summarize **Atlas launch decisions** from **the past two weeks** as **five bullets with sources and open questions**.
59+
60+
Replace the example names with your own projects and teams. For more ideas, see [Use cases and example prompts](/search/use-cases).

0 commit comments

Comments
 (0)