> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anymorph.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 에이전트 (Agent)

> 워크스페이스 데이터를 그대로 읽고 답하는 채팅. 무언가를 바꿀 때는 반드시 먼저 물어봅니다

**Agent**(에이전트)는 내 워크스페이스에 대해 아무거나 물어볼 수 있는 채팅 화면입니다. 가시성, 프롬프트, 인용, 페이지, 유입까지 실제 기록을 읽고 답합니다. 추측이 아니라 이 워크스페이스에 저장된 값을 근거로 답한다는 점이 핵심입니다.

읽기만 하는 게 아니라 일도 합니다. 프롬프트 패널 수정, 페이지 편집과 게시, 브랜드 문서와 생성 규칙 수정, 지식 문서 추가, 가시성 분석 실행까지 요청할 수 있습니다. 다만 무언가를 바꾸는 일은 **실행 전에 반드시 승인 카드로 먼저 물어봅니다.**

사이드바에서 **Agent** 옆에 **Beta** 배지가 붙어 있습니다. 이미 쓸 수 있지만 아직 계속 바뀌고 있다는 뜻입니다.

<Frame>
  <img src="https://mintcdn.com/opactor/ueicEUgPZ5iGb5FG/images/agent/agent-start.png?fit=max&auto=format&n=ueicEUgPZ5iGb5FG&q=85&s=3c161202d9b18fd2a636f153f072e43d" alt="Agent 시작 화면" width="1600" height="1000" data-path="images/agent/agent-start.png" />
</Frame>

1. **New chat** — 새 대화를 시작합니다.
2. **History** — 저장된 내 대화 목록을 엽니다.
3. **시작 질문 칩** — 누르면 그 질문이 바로 전송됩니다.

## 화면 구성

**상단 버튼**

* **New chat**(새 대화) — 빈 대화를 엽니다. 열기만 하고 아무것도 쓰지 않은 대화는 목록에 저장되지 않습니다.
* **History**(기록) — 저장된 대화를 최근 순으로 보여줍니다. 각 대화 이름은 첫 질문에서 자동으로 만들어지고, 이후 바뀌지 않습니다. 이름이 없으면 \*\*"Untitled chat"\*\*으로 표시됩니다. 저장된 대화가 하나도 없으면 버튼이 비활성화됩니다.

**시작 화면**

빈 대화에는 \*\*"What do you want to know?"\*\*라는 문구와 함께 네 개의 시작 질문이 있습니다. 지난 30일 가시성 변화, 가장 자주 지는 프롬프트와 상대, AI 엔진이 인용하는 출처, 가장 큰 커버리지 공백 찾기입니다. 누르면 바로 전송됩니다.

**대화 영역**

내가 보낸 말은 오른쪽 회색 말풍선으로, 에이전트 답변은 왼쪽에 제목·목록·표·링크가 살아 있는 서식으로 나옵니다. 답을 만드는 동안에는 먼저 \*\*"Thinking..."\*\*이 반짝이고, 이어서 에이전트가 무엇을 읽고 있는지 한 줄씩 진행 상태가 표시됩니다.

**입력창**

* 안내 문구는 **"Ask anything about \[워크스페이스 이름]..."** 입니다.
* Enter로 전송, Shift+Enter로 줄바꿈입니다. 한글 입력 중 조합 확정 Enter로는 전송되지 않습니다.
* 답변이 나오는 중에는 전송 버튼이 정지(■) 버튼으로 바뀌고 위에 \*\*"Working..."\*\*이 표시됩니다.
* 답변 중에도 계속 입력하실 수 있습니다. **"Sends when this answer finishes"** 아래에 대기열로 쌓였다가 답이 끝나면 자동으로 전송됩니다. 대기 중인 메시지는 **Edit**(수정)와 **Remove**(삭제)로 손볼 수 있습니다.

## 무엇을 읽고, 무엇을 하나요

| 구분                   | 내용                                                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| 물어보지 않고 읽는 것         | 이 워크스페이스의 가시성 수치와 추세, 인용, 유입 요약, 프롬프트와 프롬프트 진단, 페이지와 그 내용·리서치, 상품 정보, 브랜드 문서와 규칙, 지식 문서 검색, 실행 상태                        |
| 물어보지 않지만 시간·비용이 드는 것 | 웹 검색과 웹페이지 읽기, 키워드 데이터, 검색결과 확인, Google Search Console 성과와 URL 점검, 경쟁사 공백 조회 (내부 기록을 먼저 쓰도록 지시돼 있습니다)                    |
| 반드시 **Apply**가 필요한 것 | 프롬프트 패널 수정, 온사이트 페이지 생성·편집·게시·재생성과 상품 연결, 상품 정보 변경, 브랜드 문서·전역 규칙·디자인 가이드 변경, 지식 문서와 리서치 출처 추가, 가시성 분석 시작과 페이지 게시, 이미지 생성 |
| 아예 할 수 없는 것          | 워크스페이스 상태와 도메인 관리, 상품 데이터 영구 삭제, 워크스페이스 범위를 벗어난 색인 작업, 임의 코드 실행                                                          |

## 변경 승인은 이렇게 진행됩니다

<Steps>
  <Step title="바꾸고 싶은 것을 말합니다">
    「○○ 토픽 프롬프트를 다시 잡아줘」, 「이 페이지 게시해줘」처럼 평소 말하듯 요청하시면 됩니다.
  </Step>

  <Step title="승인 카드를 확인합니다">
    에이전트가 실행을 멈추고 **"Review proposed changes"**(변경 사항 검토) 카드를 띄웁니다. 실제로 저장될 값이 항목별로 한 줄씩 적혀 있습니다.
  </Step>

  <Step title="경고 문구를 읽습니다">
    위험한 작업에는 빨간 경고 줄이 붙습니다. 생성 작업을 시작하는 요청에는 "실제로 만들기 시작하며 비용이 들고 몇 분 걸린다"는 경고가, 페이지 게시에는 "공개된 사이트에 그대로 올라간다"는 경고가 영어로 표시됩니다.
  </Step>

  <Step title="Apply 또는 Discard">
    **Apply**(적용)를 누르면 실행하고, 끝난 뒤 기록을 다시 읽어 실제로 무엇이 반영됐는지 알려줍니다. **Discard**(취소)를 누르면 아무 일도 일어나지 않고, 같은 변경을 다시 제안하지 않습니다.
  </Step>
</Steps>

<Warning>
  게시나 분석 실행을 승인하면 채팅 밖에서 실제 작업이 시작되고 몇 분 걸립니다. 결과는 [온사이트](/ko/dashboard/on-site), [AI 가시성](/ko/dashboard/visibility), [성과](/ko/dashboard/performance) 페이지에 나타납니다. 에이전트에게 진행 상황을 물어보셔도 됩니다.
</Warning>

## 이렇게 물어보세요

에이전트는 답을 먼저 말하고 근거를 뒤에 붙이도록, 그리고 항상 기간을 숫자로 밝히도록 지시돼 있습니다. 비교는 표로 정리하고, 데이터가 없으면 지어내지 않고 없다고 말합니다. 한국어로 쓰시면 한국어로 답합니다.

* 「지난 30일 언급률이 어떻게 움직였는지, 토픽별로 표로 보여줘」
* 「우리가 가장 자주 밀리는 프롬프트 10개랑, 대신 언급된 브랜드 알려줘」
* 「ChatGPT가 우리에 대해 인용하는 출처 도메인 상위 10개 보여줘」
* 「지난주에 게시된 온사이트 페이지 목록이랑 각각 색인됐는지 알려줘」
* 「경쟁사 대비 가장 크게 비어 있는 토픽 하나 찾아서, 어떤 페이지를 만들면 좋을지 제안해줘」
* 「브랜드 문서에서 가격 표기 방식을 원화·달러 병기로 바꿔줘」
* 「'무료 체험' 관련 프롬프트를 이 그룹에 5개 추가해줘」
* 「지난달 대비 인용 수가 가장 많이 늘어난 페이지 5개는?」

## 한계

* 한 번의 답변은 내부 단계 **80개**까지만 진행합니다. 너무 광범위한 요청은 다 끝내지 못하고 멈출 수 있으니 나눠서 물어보세요.
* 답변이 실제 데이터 여러 개를 순서대로 읽어야 하면 수십 초가 걸릴 수 있습니다. 단순 조회는 빠릅니다.
* 지금 들어와 있는 **한 워크스페이스만** 읽고 바꿀 수 있습니다.
* **History**에는 최근 **30개** 대화까지 표시됩니다.

## 상태 표시

| 표시                           | 뜻                                                  |
| ---------------------------- | -------------------------------------------------- |
| **Thinking...**              | 답변이 시작됐고 아직 아무것도 쓰지 않은 상태                          |
| **Working... / \[n] queued** | 답변이 나오는 중이고, 대기 중인 내 메시지가 n개                       |
| **Reconnecting...**          | 연결이 끊겨 자동으로 다시 붙는 중                                |
| 빨간 연결 오류 줄                   | 재시도가 모두 실패했습니다. 메시지를 하나 더 보내면 이어서 진행됩니다            |
| **Stopped**                  | 내가 정지 버튼을 눌러 중간에 끊었습니다. 오류가 아니며, 쓰다 만 답변은 그대로 남습니다 |

## 자주 묻는 질문

<AccordionGroup>
  <Accordion title="팀원이 제 대화를 볼 수 있나요?">
    아니요. 대화는 같은 워크스페이스 안에서도 로그인한 사람 개인에게만 저장됩니다. 팀원의 대화를 열 수도, 내 대화를 팀원이 열 수도 없습니다.
  </Accordion>

  <Accordion title="제 허락 없이 뭔가 바꾸지는 않나요?">
    바꾸지 않습니다. 모든 변경은 승인 카드로 먼저 제안되고, **Apply**를 누르셔야 실행됩니다.
  </Accordion>

  <Accordion title="그 변경이 정확히 뭘 하는지 어떻게 알 수 있나요?">
    승인 카드에 저장될 값이 항목별로 적혀 있습니다. 비용이 들거나 실제 사이트에 게시되는 작업에는 별도의 빨간 경고 줄이 붙습니다.
  </Accordion>

  <Accordion title="Discard를 누르면 어떻게 되나요?">
    아무 일도 일어나지 않습니다. 에이전트는 같은 변경을 다시 제안하지 않고, 대신 어떻게 바꾸면 좋을지 되묻습니다.
  </Accordion>

  <Accordion title="작업 중에 탭을 닫아도 되나요?">
    됩니다. 답변은 계속 진행되고, 나중에 그 대화를 다시 열면 진행 중인 상태에 그대로 이어 붙습니다.
  </Accordion>

  <Accordion title="답변 중에 계속 입력해도 되나요?">
    됩니다. 입력한 메시지는 대기열에 쌓였다가 답변이 끝나면 자동 전송됩니다. 전송 전까지 **Edit** 또는 **Remove**로 고치거나 지울 수 있습니다.
  </Accordion>

  <Accordion title="한국어로 답하나요?">
    네. 쓰신 언어 그대로 답합니다.
  </Accordion>

  <Accordion title="다른 브랜드 워크스페이스도 볼 수 있나요?">
    아니요. 지금 들어와 있는 워크스페이스로 제한됩니다.
  </Accordion>
</AccordionGroup>

## 함께 보면 좋은 페이지

<CardGroup cols={2}>
  <Card title="개요" href="/ko/dashboard/overview">
    워크스페이스 한눈에 보기. 에이전트는 그 옆에서 아무거나 물어보는 곳입니다.
  </Card>

  <Card title="프롬프트 수정하기" href="/ko/guides/editing-prompts">
    채팅으로 프롬프트를 고치는 방법과 주의점.
  </Card>

  <Card title="지식 문서" href="/ko/dashboard/knowledge">
    브랜드 문서와 콘텐츠 가이드라인을 직접 확인합니다.
  </Card>

  <Card title="콘텐츠 리뷰하기" href="/ko/guides/reviewing-content">
    초안을 어떤 기준으로 볼지 정리했습니다.
  </Card>
</CardGroup>
