> For the complete documentation index, see [llms.txt](https://docs.panther.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.panther.com/ko/alerts/destinations/slack-bot.md).

# Slack 봇 대상

## 개요

대상은 룰, 정책, 시스템 상태 알림, 룰 오류에서 알러트를 수신하는 통합입니다. Panther는 Panther Slack Bot을 알러트를 수신할 대상으로 구성하는 것을 지원합니다.

Panther의 Slack Bot은 하나 이상의 Slack 채널로 알러트를 보낼 수 있는 Slack 애플리케이션입니다.

<figure><img src="/files/c0be88b630c3bd38243e620df4ba0e4dde78abd4" alt="Under a &#x22;Panther&#x22; title is a red dot next to &#x22;High.&#x22; Below is the text, &#x22;User reported a fraudulent Duo 2FA request,&#x22; as well as buttons like &#x22;View in Panther&#x22; and a boomerang icon."><figcaption></figcaption></figure>

다음 사항을 참고하세요:

* 알러트와 상호작용하려면 Slack 사용자 이메일 주소가 Panther에 정의된 사용자 프로필의 이메일 주소와 일치해야 합니다.
  * Slack의 이메일 주소가 Panther Console 이메일 주소와 일치하지 않으면 Panther 지원팀에 문의하여 도움을 받으세요.

### Slack에서 알러트 관리

Slack 내에서 상태 업데이트, 담당자 설정, Boomerang 메시지 전송과 같은 알러트와의 상호작용은 Panther Console로 다시 동기화됩니다. 알러트를 "Resolved"로 표시할 때의 해결 댓글은 Panther 알러트 Activity 섹션으로 동기화됩니다.

알러트 상태, 담당자, 댓글에 대한 양방향 동기화도 활성화할 수 있습니다. 이는 Panther Console(또는 Panther API)에서 알러트의 상태나 담당자가 변경되거나 댓글이 남겨지면 변경 사항이 해당 Slack Bot 알러트로 동기화된다는 뜻입니다. 마찬가지로, Jira와 같은 외부 대상에서 댓글이 추가되면 양방향 댓글 동기화가 활성화된 경우 Slack에도 동기화됩니다. 자세한 내용은 [양방향 댓글 동기화](/ko/alerts/alert-management/slack.md#two-way-comment-syncing).

<figure><img src="/files/31ea3d4d3f997d9866a56fd93e3abac17914d96b" alt="Three toggles are shown: Two-Way Status Syncing, Two-Way Assignee Syncing, and Two-Way Comment Syncing" width="375"><figcaption></figcaption></figure>

Slack에서 알러트 관리에 대한 자세한 내용은 다음을 참조하세요: [Slack에서 알러트 관리](/ko/alerts/alert-management/slack.md).

## Slack Bot 설정 비디오 안내

{% embed url="<https://youtu.be/lmkT3nOQ9bE>" %}
Panther의 Slack Bot 알러트 대상 통합을 설정하는 비디오 안내입니다.
{% endembed %}

{% hint style="info" %}
위 동영상의 Panther Console 내 Slack Bot 설정 화면(3:18-4:40 사이에 표시됨)은 이제 Panther Console에서 보이는 화면과 직접 일치하지 않을 수 있습니다.
{% endhint %}

## Panther에서 Slack Bot 알러트 대상을 설정하는 방법

{% hint style="info" %}
Panther 사용자는 다음 권한을 가져야 합니다 `알러트 보기` 그리고 `알러트 관리` 알러트를 할당하고 알러트 상태를 변경할 수 있어야 합니다.
{% endhint %}

### 1단계: Panther에서 첫 번째 Slack Bot 알러트 대상 만들기

첫 번째 Slack Bot 알러트 대상을 만들려면 새 Slack 애플리케이션을 생성해야 합니다. 초기 대상이 생성되면 추가 Slack Bot 알러트 대상은 자동으로 동일한 Slack 애플리케이션과 해당 자격 증명을 재사용합니다.

1. Panther Console에 로그인하세요.
2. 왼쪽 사이드바에서 다음을 클릭하세요 **알러트 대상**.
3. 클릭하세요 **+첫 번째 대상을 추가하기**.
   * 이미 대상을 만든 경우 다음을 클릭하세요 **새로 만들기** 페이지 오른쪽 상단에서 새 대상을 추가하세요.
4. 클릭하세요 **Slack Bot**.
5. 클릭하세요 **복사** Slack Manifest를 클립보드에 복사하세요. 다음 단계에서 필요합니다.\
   ![In the Panther Console while creating the Slack Bot application, there is a page that contains a text box. In the text box, there is a manifest. There is a "Copy" button in the upper right side of the manifest.](/files/58aae40072a754c4bda1c9313f7dde08465243d6)

다음 단계를 시작하는 동안 이 브라우저 탭을 열어 둔 상태로 유지하세요.

### 2단계: Slack에서 Slack Bot 앱 구성

1. 별도의 브라우저 탭에서 [Slack에 로그인하세요](https://slack.com/signin) 관리자 계정을 사용하여
2. 다음에서 [Slack - Your Apps](https://api.slack.com/apps), 클릭하세요 **새 앱 만들기**.
3. "앱 만들기" 대화상자에서 옵션을 선택하세요 **매니페스트에서**.\
   ![The "Create an app" dialog in Slack displays options for "from scratch" and "from a manifest."](/files/7654ecd49d093747c99104e6ef679a3d970db63e)
4. "앱을 개발할 워크스페이스 선택" 대화상자에서 Slack Bot을 설치할 Slack 워크스페이스를 선택하세요.\
   ![The image shows a popup dialog from Slack named "Pick a workspace to develop your app in" It contains a dropdown field.](/files/c78a9061a50f690bb77a764646af56ebc3654ddf)
   1. 만약 귀하의 [Slack 요금제가](https://app.slack.com/plans) Enterprise Grid인 경우 Slack Bot을 사용할 Grid의 워크스페이스를 선택하세요. Grid의 다른 워크스페이스에 설치하는 기능은 나중 단계에서 제공됩니다.
5. 클릭하세요 **다음**.
6. "매니페스트에서 앱 만들기" 대화상자에서 다음을 클릭하세요 **YAML.** 다음에서 Slack Manifest를 붙여넣으세요 [이전 단계](#begin-the-slack-bot-alert-destination-configuration-in-panther) (미리 채워진 `Demo App` 예시 내용을 대체합니다).\
   ![The "Create app from manifest" dialog in Slack displays YAML code.](/files/c6d5ea742cda412c56546c4d49336a27162d74ca)
7. 클릭하세요 **다음**.
8. "요약 검토 후 앱 만들기" 대화상자에서 다음을 클릭하세요 **만들기.**\
   ![The dialog is labeled "Review summary and create your app." There is a green "Create" button at the bottom.](/files/d7a3a24d6cc43587c039adb2ef8627ded5cb5f86)
9. Slack 관리자로 로그인한 경우 3단계로 건너뛰세요: [Slack Bot 설치](#installing-slack-bot-to-workspace). 그렇지 않으면 아래를 계속하세요.
10. Basic Information 페이지에서 다음을 클릭하세요 **설치 요청**.\
    ![In Slack's Basic Information page, there is a green button labeled "Request to install."](/files/abaad5718cb4b0447dd564ce4fc8350378cb1192)
    * "Panther 설치 요청" 대화상자에서 Slack 관리자에게 보낼 선택 메시지를 추가한 다음 다음을 클릭하세요 **요청 제출**.
    * 이제 Basic Information 페이지에 다음이 표시되어야 합니다 **요청 제출됨** "앱 설치" 섹션 아래에
11. Slack 관리자에게 설치 요청을 승인해 달라고 요청하되, 아직 설치하지 마세요.
    * 승인되면 **요청 제출됨** 버튼은 다음으로 변경됩니다 **워크스페이스에 설치.**

### 3단계: Slack Bot 설치 <a href="#installing-slack-bot-to-workspace" id="installing-slack-bot-to-workspace"></a>

만약 귀하의 [Slack 요금제가](https://app.slack.com/plans) Enterprise Grid인 경우 아래의 Enterprise Grid 탭을 참조하세요. 다른 모든 Slack 요금제의 경우 아래의 비-Enterprise Slack 탭을 참조하세요.

{% tabs %}
{% tab title="비-Enterprise Slack" %}
**워크스페이스에 Slack Bot 설치**

1. Slack의 Basic Information 페이지에서 다음을 클릭하세요 **워크스페이스에 설치.**\
   ![The Basic Information page in Slack shows a button labeled "Install to Workspace."](/files/f8473f390f5a237df5963ee708d61bee93dcf9ab)
   * Slack OAuth 승인 페이지로 리디렉션됩니다.\
     ![The authorization page in Slack shows that Panther is requesting authorization to the Slack workspace.](/files/5fa4ca6ebf58965dade3a75864aceaec01b26b0f)
2. 클릭하세요 **허용** 새 앱에 대한 액세스를 승인하세요.
   * Slack의 Basic Information 페이지로 다시 리디렉션됩니다.
3. 다음으로 진행하세요 [4단계 - Panther Slack App 구성.](#step-4-configuring-panther-slack-app)
   {% endtab %}

{% tab title="Enterprise Grid" %}
**Enterprise Grid에 Slack Bot 설치**

1. Slack의 Basic information 페이지에서 다음을 확장하세요 **배포 관리** 그리고 다음을 클릭하세요 **앱 배포**.\
   ![In Slack, the Basic Information link in the left sidebar is highlighted. At the bottom of the page, there is a button labeled Distribute App.](/files/b8a91bf52cc0c9e5d9677be21c0ca5b063477a9b)
2. 클릭하세요 **조직 수준 앱 사용에 동의** 조직 전체 설치를 활성화하려면\
   ![The page in Slack is labeled "Share your app with other WorkSpaces on your Grid." At the bottom there is a button labeled "Opt into org-wide apps."](/files/6bbe2cc86f4b9fcf046f5718e0c49c9f3a775573)
3. 클릭하세요 **동의**.\
   ![In the left sidebar in Slack, "Org level apps" is highlighted. There is a button labeled "Opt in" in the center of the screen.](/files/192a555dcd3d1c3ef20f4f1714478a9f0f8d8a8e)
4. 체크박스를 클릭한 다음 다음을 클릭하세요 **예, 동의합니다**.\
   ![A pop-over dialog is labeled "Opt in to org apps." There is a checkbox next to a statement that says "I understand that opting out of this feature cannot be easily done. Opting out will require submitting a request into Slack Help Center." Below that, there is a button labeled "Yes, Opt-in."](/files/dc8d2d3e964a7a433107c363f470061bd7bb3b57)
5. 다시 다음으로 이동하세요 **Settings > Install App**, 다음을 클릭하세요 **조직에 설치**.\
   ![In the left sidebar of Slack, "Install App" is selected. There is a button in the center of the page labeled "Install to organization."](/files/79fcd44b2a748c60a9f381e76cfe6f1b58812444)
6. 클릭하세요 **허용** 새 앱에 대한 액세스를 승인하세요.\
   ![The page says "Panther is requesting permission to access the Slack organization." At the bottom of the page, there is a button labeled "Allow."](/files/a1868cbd41ae19cf25d604bc7dd49a05bffd6ee1)
7. Slack에서 설치가 성공했다는 메시지를 받게 됩니다. 링크된 텍스트를 클릭하세요 **일부 워크스페이스에 추가하기**.\
   ![Slack Bot sent a message in Slack to confirm that the installation was successful.](/files/576093dd2f466e1e69d7490cf4d1a09245a4c821)
8. Slack Bot을 설치할 워크스페이스를 선택하세요. 선택적으로, 향후 워크스페이스에 자동으로 추가할지 여부도 선택할 수 있습니다:\
   ![In Slack, there is a list of workspaces. You can click on the workspaces to select them as locations where you will use the Slack Bot.](/files/b064ea614ee77034692435929d626851bd772800)
9. 클릭하세요 **다음** 그리고 화면의 안내를 순서대로 따르세요.

워크스페이스(들) 설치가 완료되면 Slack에서 확인 메시지를 받게 됩니다:\
![In Slack, Slackbot sends a message to confirm that it has been installed in your workspace.](/files/78e66a2f72f7ed7dee5a8b34bde30dec677e49ab)

완료되면 다음으로 진행하세요 [4단계 - Panther Slack App 구성.](#step-4-configuring-panther-slack-app)
{% endtab %}
{% endtabs %}

### 4단계: Panther Slack App 구성

1. Panther 로고 이미지를 컴퓨터에 다운로드하세요.

{% file src="/files/44c70e2a7289297df4b9b4840be91c7066a48795" %}

2. 다시 다음으로 이동하세요 **Settings > Basic Information** Slack App에서.
3. "Display Information" 섹션으로 스크롤한 다음 다음을 클릭하세요 **+앱 아이콘 추가**:\
   ![The "Display Information" section in Slack shows you an option to add an app icon.](/files/864ad83bf4e87a98a51e901dd42821cdf3cc739c)
   * 이전 단계에서 다운로드한 Panther 앱 아이콘을 선택하세요.
4. Basic Information 페이지의 App Credentials 섹션으로 스크롤하세요. Panther에서 구성을 마칠 때 다음 단계에서 이 정보가 필요하므로 이 페이지를 열어 둔 상태로 유지하세요:\
   ![The App Credentials page in Slack displays the App ID, Client ID, date of app creation, client secret, and signing secret.](/files/5ba7c8110135209b34e340210a1a012775de88b1)

### 5단계: Panther에서 구성 계속하기

1. Panther Console에서 Slack Bot 알러트 대상을 구성하기 시작한 브라우저 탭을 여세요.
   * 해당 탭이 닫혔거나, Slack 관리자가 아니어서 앱 설치 요청을 제출한 경우 다음을 따라야 합니다 [이전 단계](#begin-the-slack-bot-alert-destination-configuration-in-panther) Panther Console의 Slack Bot 대상 설정 프로세스로 돌아가야 합니다. 또한 Slack Bot 앱의 매니페스트를 Panther Console의 최신 버전에 맞게 업데이트해야 합니다.
2. 매니페스트가 표시된 Panther Console의 "Create your Slack Bot app" 페이지에서 다음을 클릭하세요 **계속**.
3. 대상 구성을 위해 양식을 작성하세요:

   <figure><img src="/files/4a71eab46f1298865cd1ce4d63731bb10582ee51" alt="Under a &#x22;Slack Configuration&#x22; header, there are various form fields, including Client Secret, Severity Levels, and Two-Way Status Syncing." width="375"><figcaption></figcaption></figure>

   * **표시 이름**: 알러트 대상의 설명적인 이름을 입력하세요.
     * 참고: 이는 Panther Console에서의 알러트 대상 표시 이름이며, Slack의 봇 이름이 아닙니다.
   * **채널 ID 또는 채널 이름**: 알러트를 수신하려는 Slack 채널 이름(예: #hello-world) 또는 Slack 채널 ID를 입력하세요.
     * Slack 채널 ID 사용을 권장합니다. Panther Console에서 나중에 이 Slack Bot으로 전송된 알러트의 알러트 세부 정보 페이지에서는 해당 알러트로 생성된 특정 Slack 스레드가 하이퍼링크로 연결되기 때문입니다. (채널 이름을 사용하면 채널 전체로만 연결됩니다.)<br>

       <figure><img src="/files/b9c9bc9b40ce855d82e58f673d5c3981d2a8ad64" alt="Under an &#x22;External Conversations&#x22; header is a Slack and Teams icon." width="191"><figcaption></figcaption></figure>
     * 참고: Slack Enterprise Grid를 사용하는 경우 Slack 채널 ID를 제공해야 합니다. 채널 ID를 찾으려면 Slack에서 채널 이름을 클릭한 다음 모달 하단으로 스크롤하세요:\
       ![In Slack, after you click the channel name, a pop-over dialog appears. At the bottom of that dialog, you will see the Channel ID.](/files/b023eb323b8a5ec3a2555cc3a1c1f510e9c68e2f)
   * **클라이언트 ID**: 다음에서 클라이언트 ID 값을 입력하세요 **앱 자격 증명** Slack Bot 앱의 섹션
   * **클라이언트 시크릿**: 다음에서 클라이언트 시크릿 값을 입력하세요 **앱 자격 증명** Slack Bot 앱의 섹션
   * **서명 시크릿**: 다음에서 서명 시크릿 값을 입력하세요 **앱 자격 증명** Slack Bot 앱의 섹션
   * **봇 OAuth 토큰**: 다음 값을 입력하세요 **봇 사용자 OAuth 토큰** 의 값을 **OAuth & Permissions** Slack Bot 앱의 섹션:\
     ![In the left sidebar in Slack, "OAuth and Permissions" is highlighted. The page displays the value for the Bot User OAuth Token.](/files/b658914032b90bfc6f8fe24c77c981f48fa80ff0)
   * **심각도**: 이 대상에 보낼 알러트의 심각도 수준을 선택하세요.
   * **알러트 유형**: 이 대상에 보낼 알러트 유형을 선택하세요.
   * **로그 유형**: 기본적으로 모든 로그 유형의 알러트를 전송합니다. 특정 로그 유형의 알러트만 전송하려면 여기에 로그 유형을 지정하세요.
   * **수동 전송 허용**: 이 토글을 ON으로 설정하면 다음을 할 수 있습니다 [알러트를 수동으로 전송](https://docs.panther.com/alerts#manual-alert-dispatch) 이 대상으로.
   * **Slack 알러트의 시간대**: 이 대상에 전송되는 메시지에 사용할 시간대를 선택하세요.
   * **양방향 상태 동기화**: 토글을 `ON` Panther Console(또는 Panther API)에서 변경한 알러트 상태를 Slack Bot 알러트로 동기화하려면
   * **양방향 담당자 동기화**: 토글을 `ON` Panther Console(또는 Panther API)에서 변경한 알러트 담당자를 Slack Bot 알러트로 동기화하려면
   * **Slack에서 Panther AI 활성화**: 토글을 `ON` AI가 생성한 알러트 분류를 Slack 스레드에 동기화하고, 다음을 표시하며 **AI 분류** 알러트 메시지에 버튼을 표시하고, 분석가가 알러트 스레드에서 Panther AI를 @멘션하여 후속 질문을 할 수 있게 합니다 — Panther AI가 수행할 권한이 필요한 작업을 승인하거나 거부하는 것을 포함합니다. 자세한 내용은 [Slack의 Panther AI](/ko/alerts/alert-management/slack.md#ai-alert-triage-sync).

다음 단계를 위해 이 브라우저 탭을 열어 두세요.

### 6단계: Panther Slack Bot을 Slack 채널에 초대하기

1. Slack 애플리케이션을 열고 Panther와 함께 사용하도록 구성한 채널로 이동하세요.
2. Slack 채널에서 다음 메시지를 입력하고 전송하세요:\
   `/invite @Panther`

Panther Slack Bot이 Slack 채널에 초대되면 Slack에서 확인 메시지를 볼 수 있으며, 설정을 완료하기 위해 Panther Console로 돌아갈 수 있습니다.\
![Panther has been invited to the Slack channel. Slackbot sent a message in the channel that says "Ok! I invited @Panther to this channel."](/files/bb633489e5003fccab937d34f893f0f7908d3196)

### **7단계: Panther Console에서 설정 완료**

1. Panther Console로 돌아가세요.
2. "Create your Slack Bot Application" 페이지에서 다음을 클릭하세요 **대상 추가**.\
   ![The "Create your Slack Bot Application" page in Panther shows a form to fill out to configure the app. At the bottom, there is a button labeled "Add Destination."](/files/9aec6ea12cee528c807949fe9b8c5f9380b273b5)
3. 마지막 페이지에서 선택적으로 다음을 클릭하세요 **환영 메시지 보내기** 통합을 테스트합니다. 이렇게 하면 알러트를 수신하도록 선택한 Slack 채널에 메시지가 전송됩니다.
4. 완료되면 다음을 클릭하세요 **설정 완료**.

새 Slack Bot 알러트 대상으로 Slack에 전송된 알러트를 보거나 관리하는 방법은 다음을 참조하세요 [알러트 분류 - Slack Bot](/ko/alerts/alert-management/slack.md).

### 8단계(선택 사항): 추가 Slack Bot 대상 만들기

여러 Slack Bot 대상과의 상호작용이 어떻게 작동하는지 자세히 알아보려면 다음을 참조하세요 [여러 Slack Bot 대상으로 알러트 보내기](/ko/alerts/alert-management/slack.md#sending-an-alert-to-multiple-slack-bot-destinations).

추가 Slack Bot 알러트 대상을 만들기 위해 Slack 워크스페이스에 새 애플리케이션을 만들 필요는 없습니다.

1. 왼쪽 사이드바에서 다음을 클릭하세요 **알러트 대상**.
2. 클릭하세요 **새로 만들기** 페이지 오른쪽 상단에서 새 대상을 추가하세요.
3. 클릭하세요 **Slack Bot**.
4. 양식을 작성하고 다음을 지정하세요 **표시 이름** 그리고 **채널 ID 또는 채널 이름**.
   * 클라이언트 ID, 클라이언트 시크릿, 서명 시크릿, 봇 OAuth 토큰은 기존 Slack Bot 알러트 대상에 따라 미리 채워집니다.
   * 다음을 사용하여 지정된 채널에 Panther Bot을 초대하는 것을 잊지 마세요 `/invite @Panther`.\
     ![The Slack Bot destination configuration form in the Panther Console shows empty fields "Display Name" and "Channel ID or Channel Name." Other fields in the form, like Client ID, Client Secret, Signing Secret, and Bot OAuth Token, are greyed out. There is a note near the top of the form that says, "The credentials from your existing Slack Bot Alert Destination have been pre-filled for your convenience. Reminder: Invite the @Panther bot to the specified Slack channel if you have not already."](/files/99f0a50b47b1a4a4e0f431c82b5aacab7d8aafea)
5. 클릭하세요 **대상 추가**.

## 새 기능을 위해 기존 Slack Bot 설치 업데이트하기

일부 Panther 기능은 Slack Bot 대상을 처음 만들 때 존재하지 않았던 Slack 앱 권한이 필요합니다. 더 새로운 기능이 예상대로 작동하지 않으면 매니페스트 업데이트가 필요한지 확인하세요:

{% hint style="warning" %}
Panther 버전 1.115 이전에 Slack Bot 대상을 설정했고 다음을 활성화하고 싶다면 [양방향 댓글 동기화](/ko/alerts/alert-management/slack.md#two-way-comment-syncing), 필요한 권한이 포함된 새 매니페스트로 Slack 앱을 업데이트해야 합니다.
{% endhint %}

{% hint style="warning" %}
Panther 버전 1.128 이전에 Slack Bot 대상을 설정했고 분석가가 다음을 할 수 있게 하려면 [알러트 스레드에서 Panther AI를 @멘션](/ko/alerts/alert-management/slack.md#slack-ai-mention), 필요한 권한이 포함된 새 매니페스트로 Slack 앱을 업데이트해야 합니다.  **AI 분류** 버튼과 AI 알러트 분류 동기화는 이 업데이트가 필요하지 않습니다 — @멘션 지원만 필요합니다.
{% endhint %}

기존 Slack Bot 설치를 업데이트하려면:

1. Panther Console의 왼쪽 탐색 막대에서 다음을 클릭하세요 **알러트 대상**.
2. 업데이트하려는 기존 Slack Bot 알러트 대상을 찾아 이름을 클릭하세요.
3. 페이지 하단으로 스크롤한 다음 다음을 클릭하세요 **구성으로 이동**.
4. 새 앱 매니페스트를 복사하세요.
5. 열기 <https://api.slack.com/apps>.
6. 기존 Panther 앱을 찾아 이름을 클릭하세요.
7. 왼쪽 탐색 메뉴에서 다음을 클릭하세요 **앱 매니페스트**.
8. 기존 매니페스트를 Panther에서 복사한 새 매니페스트로 바꾸세요.
9. 클릭하세요 **변경 사항 저장**.
10. 왼쪽 탐색 메뉴에서 다음을 클릭하세요 **앱 설치**.
11. 클릭하세요 **다시 설치할 대상: `<워크스페이스>`**.

## 대상에 대한 추가 정보

알러트 라우팅 순서, 대상 수정 또는 삭제, 워크플로 자동화에 대한 자세한 내용은 Panther 문서를 참조하세요: [대상](https://docs.panther.com/destinations).


---

# 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://docs.panther.com/ko/alerts/destinations/slack-bot.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.
