> For the complete documentation index, see [llms.txt](https://kakaowork.gitbook.io/kakao-work/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kakaowork.gitbook.io/kakao-work/basic/user/search.md).

# 통합검색

## 검색하기 <a href="#search" id="search"></a>

<img src="https://t1.kakaocdn.net/service_kep_docpublish/git/kakaowork/user/%EA%B2%80%EC%83%89_PC_icon.png" alt="" data-size="line"> 아이콘으로 워크스페이스 내의 멤버/채팅방/메시지/파일을 한 번에 검색할 수 있습니다.

{% tabs %}
{% tab title="PC/Mobile" %} <img src="https://t1.kakaocdn.net/service_kep_docpublish/git/kakaowork/user/%EA%B2%80%EC%83%89_PC_icon.png" alt="" data-size="line"> 아이콘을 클릭하면 최근 검색어 10개가 자동 표시되며, 개별 삭제 또는 전체 삭제가 가능합니다.

* 검색어 입력 시, 해당 키워드를 포함하는 채팅방 및 멤버가 자동으로 추천됩니다.
  {% endtab %}
  {% endtabs %}

{% hint style="info" %}
**안내**\
최근 검색어는 사용자 디바이스 간에 동기화됩니다.
{% endhint %}

## 검색결과 보기 <a href="#result" id="result"></a>

### 전체 탭 <a href="#total" id="total"></a>

**전체** 탭에서는 멤버/조직, 채팅방, 메시지, 파일에 대한 검색 결과를 한번에 볼 수 있습니다. 이때 사용자와 관련도가 높은 멤버들이 상위에 표시됩니다.

* 검색어를 큰 따옴표(" ") 안에 작성하여 검색 시, 100% 일치하는 검색 결과를 제공합니다.

<figure><img src="/files/DPll6M9AMwJ4fqW1Jfxg" alt=""><figcaption></figcaption></figure>

* 스페이스(공백)로 구분하여 입력 시, 여러 검색어를 모두 포함한 검색 결과를 제공합니다.

<figure><img src="/files/TZoZ90cqFhOJ6zjVDDWB" alt=""><figcaption></figcaption></figure>

### 멤버 탭 <a href="#member" id="member"></a>

**멤버** 탭에서는 멤버/조직에 대한 검색 결과를 확인할 수 있습니다.

* **검색 옵션 > 내 스페이스 멤버만 보기**에 체크 시, 해당 스페이스에 포함된 멤버만 표시됩니다.

![멤버 탭](https://t1.kakaocdn.net/service_kep_docpublish/git/kakaowork/user/%EB%A9%A4%EB%B2%84%20%ED%83%AD.png)

### 채팅방 탭 <a href="#chat" id="chat"></a>

**채팅방** 탭에서는 채팅방의 제목과 참여 멤버를 검색하여 채팅방을 찾을 수 있습니다.

![채팅방 탭](https://t1.kakaocdn.net/service_kep_docpublish/git/kakaowork/user/%EC%B1%84%ED%8C%85%EB%B0%A9%20%ED%83%AD.png)

### 메시지 탭 <a href="#message" id="message"></a>

**메시지** 탭에서는 참여 중인 채팅방의 메시지를 검색할 수 있습니다. 메시지를 클릭하면, 해당 메시지 원본으로 이동할 수 있습니다. 단, Free 플랜에서 노출 기간 90일을 초과한 메시지는 원본 메시지로 이동할 수 없습니다.

* 필터 기능을 활용하여 멤버/채팅방/기간별로 특정 메시지를 검색할 수 있습니다.

![메시지 탭](https://t1.kakaocdn.net/service_kep_docpublish/git/kakaowork/user/%EB%A9%94%EC%8B%9C%EC%A7%80%20%ED%83%AD.png)

{% hint style="info" %}
Free 플랜에서는 최근 90일 이내의 메시지만 확인할 수 있습니다. 90일이 지난 메시지는 검색 결과에 표시되더라도 원본 메시지로 이동할 수 없습니다.
{% endhint %}

### 파일 탭 <a href="#file" id="file"></a>

**파일** 탭에서는 파일 제목을 검색하여 채팅방에 첨부된 파일을 찾을 수 있습니다. 단, Free 플랜에서 노출 기간 90일을 초과한 파일은 원본 메시지 확인이 제한될 수 있습니다.

* 필터 기능을 활용하여 멤버/채팅방/기간별로 특정 파일을 검색할 수 있습니다.

![파일 탭](https://t1.kakaocdn.net/service_kep_docpublish/git/kakaowork/user/%ED%8C%8C%EC%9D%BC%20%ED%83%AD.png)

### 이미지 탭 (이미지 검색) <a href="#file" id="file"></a>

{% hint style="info" %}
**사용 전제** - 미니 요금제 이상 · 이미지 검색(AI) 활성화(슈퍼관리자)&#x20;

카카오워크AI ⟩ 이미지 검색 옵션 활성화는 관리자 가이드의 **카카오워크AI 설정**을 참고하세요.
{% endhint %}

**이미지** 탭에서는 이미지 파일에 포함된 텍스트나 내용 기반으로 생성된 태그를 검색하여 채팅방에 첨부된 파일을 찾을 수 있습니다.&#x20;

* 필터 기능을 활용하여 멤버/채팅방/기간별로 특정 파일을 검색할 수 있습니다.

<figure><img src="/files/Eesa56BqB7NlOqvFoPzt" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://kakaowork.gitbook.io/kakao-work/basic/user/search.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
