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

# 일반 Agent

> 일반 Agent를 통해 모든 프레임워크로 작업하고, 모든 유형의 결과물을 만들고, 연결된 서비스에 읽기 및 쓰기를 하는 방법을 알아보세요.

## 일반 Agent란 무엇인가요?

일반 Agent는 Replit Agent와 함께 작업하는 가장 유연한 방법입니다. 아티팩트 유형을 미리 선택하거나 특정 것을 만들겠다고 결정할 필요가 없습니다. 그냥 채팅을 시작하세요 — CSV를 만들거나, PDF를 생성하거나, 주제를 조사하거나, 준비가 되면 완전한 앱을 만들 수 있습니다.

주요 개념:

* **사전 선택 불필요**: 아티팩트 유형을 미리 선택하지 않고 작업 시작
* **모든 출력 가능**: 파일(CSV, PDF, 문서) 생성, 조사, 또는 앱 빌드
* **커넥터**: BigQuery, Linear, Slack, Notion, Amplitude, Segment, Hex 등 외부 서비스 읽기 및 쓰기
* **점진적 공개**: 간단한 채팅으로 시작하여 자연스럽게 완전한 앱 빌드로 확장

## 일반 Agent 접근 방법

여러 가지 방법으로 일반 Agent에 접근할 수 있습니다:

1. **Replit 홈페이지에서 프롬프트 작성 전 "일반"을 선택하세요**
2. **기존 프로젝트를 열고** Agent와 직접 채팅을 시작하세요
3. **[개발자 프레임워크](https://replit.com/templates)를 선택하세요** — 모든 개발자 프레임워크는 자동으로 일반 Agent를 포함합니다
4. **GitHub에서 [가져오기](/build/import-from-providers)** — GitHub에서 가져온 프로젝트는 자동으로 일반 Agent를 사용합니다

## 일반 Agent 사용 방법

### 그냥 채팅을 시작하세요

프로젝트를 열고 대화를 시작하세요. 특정 것을 만들겠다고 결정하지 않아도 됩니다 — Agent는 현재 프로젝트 컨텍스트 내에서 작업하며 어떤 요청도 처리할 수 있습니다.

**예시 프롬프트:**

* "이 문서의 핵심 사항을 요약해줘"
* "매출 기준 상위 100개 기업의 CSV를 만들어줘"
* "내 상위 5개 Linear 티켓은 무엇인가요?"
* "TypeScript로 Vue.js 프로젝트를 설정해줘"

Agent는 세션 중에 만들어진 파일로 작업하고, 단일 파일 출력을 생성하고, 추론의 일부로 코드를 실행할 수 있습니다 — 무엇을 만들지 결정하기 전에 모두 가능합니다.

### 외부 서비스 연결

Agent가 데이터를 직접 읽고 쓸 수 있도록 도구를 연결하세요:

1. 프로젝트 설정에서 **커넥터**로 이동하세요
2. 서비스를 연결하세요 (BigQuery, Linear, Slack, Notion, Amplitude, Segment, Hex 등)
3. Agent에게 해당 서비스를 통해 데이터를 읽거나 쓰도록 요청하세요

**커넥터를 활용한 예시 프롬프트:**

* "Linear에서 열린 티켓이 무엇인가요?"
* "#engineering에서 오늘의 Slack 메시지를 요약해줘"
* "BigQuery에서 지난달 판매 데이터를 가져와줘"
* "내 캘린더에서 다가오는 이벤트를 보여줘"
* "온보딩 버그에 대한 새 티켓을 Linear에 만들어줘"
* "Slack의 #engineering에 요약을 보내줘"

### 채팅에서 완전한 앱으로

빌드할 준비가 되면 그냥 말하세요. Agent는 가벼운 채팅에서 앱 빌드로 원활하게 전환됩니다 — 처음부터 다시 시작하거나 컨텍스트를 전환할 필요가 없습니다.

* "이것을 웹 앱으로 만들어줘"
* "이 데이터를 기반으로 앱을 만들어줘"
* "이 지표들을 위한 대시보드를 만들어줘"
* "Rust CLI 도구를 설정해줘"

주제를 조사하거나 보고서를 생성하거나 데이터를 탐색하는 것으로 시작하여 적절한 시점에 완전한 애플리케이션 빌드로 확장할 수 있습니다.

## 만들 수 있는 것

* **지식 작업**: 앱을 만들지 않고도 조사, 요약, 분석
* **단일 파일 출력**: CSV, PDF, 문서, 데이터 내보내기, 형식화된 보고서
* **데이터 애플리케이션**: 연결된 서비스를 쿼리하고 대시보드에서 결과 시각화
* **모든 프레임워크 또는 언어**: Angular, Vue, Svelte, Rust, Go, C#, Python tkinter, Godot 게임, CLI 도구 등
* **풀 스택 앱**: 준비가 되면 채팅 컨텍스트에서 완전한 애플리케이션 빌드

## 예상되는 사항

일반 Agent는 더 많은 기능과 유연성을 제공하며, 이에 따른 가변성이 있습니다:

* **단일 설정**: 때로는 Agent가 모든 것을 한 번에 구성합니다
* **반복적 협업**: 복잡한 설정은 여러 차례의 수정이 필요할 수 있습니다
* **기술 제한**: 일부 기술은 Nix 환경에서 완전히 지원되지 않을 수 있습니다

<Note>
  사전 구성된 환경이 있는 표준 Agent와 달리, 일반 Agent는 요청에 따라 자체 환경과 실행 명령을 설정합니다. 배포할 준비가 되면 게시 구성을 요청해야 할 수도 있습니다.
</Note>

## 자주 묻는 질문

<Accordion title="Agent가 내 다른 프로젝트를 볼 수 있나요?">
  아니요. 각 채팅은 단일 프로젝트 내에서만 이루어집니다. 프로젝트 A와 프로젝트 B가 서로 대화할 수 없습니다.
</Accordion>

<Accordion title="외부 도구에 아직 접근할 수 없는 이유는 무엇인가요?">
  먼저 커넥터를 통해 서비스를 연결해야 합니다. 연결되면 Agent가 해당 서비스를 읽고 쓸 수 있지만, 기본적으로는 접근 권한이 없습니다.
</Accordion>

<Accordion title="어떤 커넥터를 사용할 수 있나요?">
  현재 지원되는 커넥터: BigQuery, Linear, Slack, Notion, Amplitude, Segment, Hex 등. 추가 커넥터가 정기적으로 추가되고 있습니다.
</Accordion>

<Accordion title="일반 Agent를 사용하려면 커넥터가 필요한가요?">
  아니요. 커넥터는 선택 사항입니다. 외부 연결 없이도 지식 작업, 파일 생성, 앱 빌드에 일반 Agent를 사용할 수 있습니다.
</Accordion>

## 이용 가능 여부

| 기능       | Core | Pro |
| -------- | ---- | --- |
| 일반 Agent | ✅    | ✅   |
| 모든 프레임워크 | ✅    | ✅   |
| 지식 작업    | ✅    | ✅   |
| 파일 생성    | ✅    | ✅   |
| 커넥터      | ✅    | ✅   |
| 앱 빌드     | ✅    | ✅   |

일반 Agent는 모든 사용자에게 제공됩니다.
