> For the complete documentation index, see [llms.txt](https://bugshot.gitbook.io/ko/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bugshot.gitbook.io/ko/settings/ai.md).

# AI LLM 연동

설정의 **AI 모델** 서브탭에서 직접 쓰시는 LLM을 연결할 수 있습니다. BugShot은 별도 AI 서버를 두지 않고, 여러분이 가진 키를 그대로 씁니다(BYOK — Bring Your Own Key). 그러니 내 키, 내 모델로 안심하고 쓰시면 됩니다.

키가 없어도 괜찮습니다. 브라우저에 Chrome 내장 AI가 준비돼 있으면 별도 설정 없이 그걸로 기본 AI 기능이 동작합니다.

## 연결하기

프로바이더를 고르고 키만 입력하면 됩니다.

* **프로바이더** — 쓰시는 LLM을 목록에서 고르거나, OpenAI 호환 엔드포인트 주소를 직접 입력합니다.
* **API Key** — 해당 서비스에서 발급한 키.

연결하면 사용할 모델을 고르는 화면이 이어지는데, **모델 선택**에서 원하는 모델을 고르시면 됩니다. OpenAI 호환 엔드포인트를 쓰는 프로바이더라면 대부분 무리 없이 연결됩니다. 연결할 때 해당 도메인 접근 권한을 요청할 수 있는데, 허용해 주시면 됩니다.

![AI 모델 연결](/files/K5m1m1qoD6zznal0uwK4)

## 어떤 AI로 동작하나요

BugShot은 아래 순서로 알아서 AI를 고릅니다. 여러분이 신경 쓸 일은 거의 없습니다.

1. **연결한 LLM이 있으면** 그 모델로 동작합니다. AI 기능 배너에 프로바이더 이름(예: OpenAI)이 배지로 표시됩니다.
2. **연결한 LLM이 없으면** Chrome 내장 AI로 자동 폴백합니다. 이때 배지에는 **Chrome AI**가 표시되고, 별도 키나 설정은 필요 없습니다.
3. **Chrome 내장 AI도 쓸 수 없는 환경이면** AI 기능이 화면에 나타나지 않습니다. 이럴 땐 위에서 LLM을 직접 연결하시면 됩니다.

> Chrome 내장 AI는 브라우저 버전·기기 환경에 따라 제공되지 않을 수 있습니다. 더 안정적으로 쓰시려면 LLM을 직접 연결하시는 편이 좋습니다.

## 켜지는 두 기능

AI가 준비되면 두 가지 기능을 쓸 수 있습니다.

* **AI 스타일링** — 요소를 고를 때 "버튼을 둥글게", "여백을 키워" 같은 자연어 지시로 스타일을 바꿉니다. → [스타일링](/ko/element/styling.md)
* **AI 초안 작성** — 캡처·로그를 근거로 이슈 본문을 자동으로 채웁니다. → [이슈 작성(요소)](/ko/element/issue.md)

> AI도 가끔 실수합니다. 생성된 결과는 제출 전에 한 번만 확인해 주세요.

***

🌐 [English](https://bugshot.gitbook.io/en/settings/ai)


---

# 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:

```
GET https://bugshot.gitbook.io/ko/settings/ai.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.