> For the complete documentation index, see [llms.txt](https://docs.manyfast.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.manyfast.io/use/ai.md).
# AI 에이전트
매니패스트의 AI 에이전트 **매니**는 프로젝트의 기획 문서를 읽고, 사용자의 요청에 따라 내용을 검토·생성·수정합니다.
PRD·기능명세서·유저플로우 등 지원되는 기획 항목의 맥락을 바탕으로 질문에 답하고 필요한 작업을 수행할 수 있습니다. Linear·Jira·GitHub를 연결하면 기존 이슈를 조회하거나 새로운 업무 이슈를 만드는 작업도 요청할 수 있습니다.
## 1. AI 에이전트로 할 수 있는 일
매니에게 기획과 관련된 질문을 하거나, 프로젝트의 문서를 직접 생성·수정하도록 요청할 수 있습니다.
* **기획 내용 조회 및 요약:** 프로젝트에 작성된 PRD·기능명세서·유저플로우의 내용을 찾아 설명하거나 요약합니다.
* **기획 검토 및 보완:** 기획에서 누락된 조건과 불명확한 정책을 확인하고 추가로 결정해야 할 내용을 제안합니다.
* **기획 항목 생성 및 수정:** PRD와 기능명세서에 새로운 항목을 추가하거나 기존 내용을 수정합니다.
* 유저플로우 생성 및 편집: 새로운 유저플로우를 만들고, 일반 채팅에서 기존 플로우의 노드와 연결을 직접 수정할 수 있습니다.
* **파일 참고:** 기획서·회의록·이미지 등 채팅에 첨부한 자료를 읽고 프로젝트 작업에 참고합니다.
* **외부 이슈 관리:** 연결된 Linear·Jira·GitHub 이슈를 조회·요약하고, 지원되는 범위에서 생성·수정·댓글 작성 작업을 수행합니다.
AI가 수행할 수 있는 작업은 **선택한 기획 항목, 문서 종류, 연결된 서비스와 사용자 권한**에 따라 달라질 수 있습니다. 지원하지 않는 작업을 요청한 경우에는 처리할 수 없는 항목과 이유가 채팅에 표시됩니다.
## 2. 채팅 시작하고 작업 대상 지정하기
#### **새 채팅 시작하기**
왼쪽 도구 패널에서 채팅을 엽니다. 채팅 상단의 새 채팅 버튼을 누르면 새로운 대화를 시작합니다. 채팅 목록 버튼에서는 이전 대화를 다시 열 수 있습니다.
새 채팅을 시작해도 프로젝트에 이미 작성된 기획 문서는 그대로 유지됩니다. 이전 대화의 맥락이 필요하다면 채팅 목록에서 기존 대화를 선택하세요.
#### **AI 모델 선택하기**
채팅 입력창 아래의 **모델 선택 메뉴**에서 현재 사용할 수 있는 AI 모델을 선택할 수 있습니다.
선택 가능한 모델은 플랜과 제공 상태에 따라 달라집니다. Claude Sonnet 5.5·Opus 5.5 등 현재 모델 선택 메뉴에 표시되는 모델을 기준으로 선택하세요. 모델마다 답변의 특성과 크레딧 소모량이 다를 수 있습니다.
#### **파일 첨부하기**
채팅 입력창의 **파일 첨부 버튼**을 눌러 기획서·회의록·표·이미지 등의 참고 자료를 추가할 수 있습니다.
PDF, Word, Excel, PowerPoint, HWP/HWPX, 텍스트와 이미지 자료를 첨부할 수 있습니다. 일반 파일 업로드는 원본 기준 파일당 최대 50MB입니다.
Excel은 시트 구조를, PowerPoint는 슬라이드를 참고해 분석합니다. 어떤 내용을 어떤 문서에 반영할지 요청에 함께 적어 주세요.
예:
* “첨부한 회의록에서 확정된 정책만 정리해줘.”
* “이 표를 참고해서 기능명세서의 수용 기준을 보완해줘.”
* “첨부한 화면을 기준으로 누락된 기능을 찾아줘.”
#### **프로젝트 아이템 지정하기**
채팅 입력창에 **@를 입력하면 현재 채팅에서 사용할 수 있는 프로젝트 아이템 목록**이 표시됩니다.
PRD·기능명세서·유저플로우 등 작업 대상을 선택하고 요청을 입력하면, 매니가 선택한 항목을 중심으로 내용을 읽고 작업합니다.
예:
* “@PRD의 핵심 내용을 세 문장으로 요약해줘.”
* “@기능명세서에서 결제 기능의 예외 조건을 확인해줘.”
* “@유저플로우의 로그인 다음에 이메일 인증 단계를 추가해줘.”
선택한 아이템에 여러 작업 방식이 제공되는 경우에는 **새로 만들기, 기존 항목 보기, 기존 항목 수정** 등 작업 유형을 고르는 화면이 먼저 표시될 수 있습니다.
## 3. AI 작업 진행 과정 확인하기
매니가 요청을 처리하는 동안 채팅에 **현재 수행 중인 작업과 진행 단계**가 순서대로 표시됩니다.
작업에 따라 다음과 같은 단계가 나타날 수 있습니다.
* 질문과 요청 내용 정리
* 프로젝트 문서 읽기
* 관련 항목 조회
* 작업 계획 또는 변경안 작성
* 기획 항목 생성·수정
* 적용 결과 확인
각 단계를 펼치면 매니가 어떤 자료와 항목을 확인하고 있는지 살펴볼 수 있습니다.
#### **작업 중단하기**
AI 작업이 진행되는 동안 입력창의 **중단 버튼**을 눌러 작업을 멈출 수 있습니다.
작업을 중단하더라도 이미 처리된 정보량에 대한 크레딧은 사용될 수 있습니다. 중단 시점까지 반영된 내용이 있는지도 결과 화면에서 함께 확인하세요.
#### **실패 안내 확인하기**
요청을 처리하지 못한 경우에는 **실패한 작업과 확인할 수 있는 이유**가 채팅에 표시됩니다.
대상 아이템이 없거나 요청 범위가 지나치게 넓은 경우에는 수정할 문서와 항목을 더 구체적으로 지정한 뒤 다시 요청해 보세요.
## 4. 결과 확인하고 반영하기
AI 작업의 결과를 반영하는 방식은 **요청한 작업의 종류**에 따라 달라집니다.
#### **질문과 요약 결과**
기획 내용에 관한 질문이나 요약 요청은 채팅에서 바로 결과를 확인할 수 있습니다. 결과가 충분하지 않다면 같은 대화에서 조건이나 범위를 추가하여 다시 요청할 수 있습니다.
#### 기획 항목 생성, 수정, 삭제 승인 또는 거절하기
PRD와 기능명세서의 변경 제안이 표시되는 경우에는 제안별 내용을 확인한 뒤 승인하거나 거절합니다. 이미 반영된 작업 결과나 단순한 채팅 답변과 변경 제안을 구분해 확인하세요.
제안이 있는 항목의 승인·거절 버튼에서 개별 변경을 처리합니다. 일괄 처리 툴바가 표시되는 경우에는 적용 범위를 확인한 뒤 처리하세요.
승인한 제안은 문서에 반영되며, 거절한 제안은 제외됩니다. 이미 완료된 변경은 이 승인 절차의 대상이 아닙니다.
#### **유저플로우 편집**
일반 채팅에서 기존 유저플로우 수정을 명확하게 요청하면, 별도의 편집 계획 승인 카드 없이 작업을 진행합니다. 기본적으로 새 버전에 저장하며, 현재 버전을 덮어쓰려면 요청에 명시하세요. 대상이나 삭제 범위가 모호하면 먼저 확인 질문을 합니다.
작업이 끝나도 보고 있던 버전은 자동으로 바뀌지 않습니다. 결과 보기를 선택해 수정된 버전을 확인하세요. 문서 동기화는 일반 편집과 다르게, 비교 결과를 검토하고 적용 방식을 선택하는 절차를 거칩니다.
#### **외부 이슈 생성 및 수정**
Linear·Jira·GitHub의 이슈 생성·수정·댓글 작성처럼 외부 서비스의 내용이 바뀌는 작업은 먼저 **승인 카드**가 표시됩니다.
승인 카드에서 다음 내용을 확인할 수 있습니다.
* 연결된 서비스와 작업 대상
* 이슈 제목과 설명
* 상태·담당자·라벨·우선순위 등 적용할 속성
* 기존 이슈에 추가할 댓글
내용을 확인한 뒤 **적용**을 누르면 연결된 사용자 계정으로 반영됩니다. 승인하기 전에는 외부 서비스의 이슈가 생성되거나 수정되지 않습니다.
서비스마다 제공하는 속성과 지원 범위가 다를 수 있습니다. 자세한 연결 방법은 Jira, GitHub, Linear 연동하기 가이드에서 확인하세요.
## 5. 모델 선택과 크레딧 확인하기
AI 채팅과 문서 생성·수정 작업에는 **크레딧이 사용됩니다.**
소모량은 선택한 AI 모델, 요청에 포함된 정보량, 읽어야 하는 문서의 범위와 작업 복잡도에 따라 달라집니다.
* 단순한 질문이나 요약에도 크레딧이 사용될 수 있습니다.
* 여러 문서와 항목을 한 번에 처리하면 더 많은 크레딧이 사용될 수 있습니다.
* 생성·수정 범위가 넓거나 처리 시간이 긴 작업은 크레딧 소모량이 커질 수 있습니다.
* 작업을 중단해도 이미 처리된 정보량에 대한 크레딧은 사용될 수 있습니다.
#### **잔여 크레딧 확인하기**
채팅 입력창 아래의 원형 크레딧 표시를 누르면 월간·일간·구매 크레딧 잔량을 확인할 수 있습니다. 원형 표시의 비율은 전체 잔량을 뜻하지 않으므로, 구매 크레딧을 포함한 잔량은 펼친 창에서 확인하세요.
펼친 창의 상세 보기에서 작업별 지급·사용 내역을 확인할 수 있습니다. 추가 구매는 별도의 결제 절차로 진행됩니다.
크레딧은 **일일 → 월간 → 구매 크레딧 순서**로 사용됩니다.
잔여 크레딧이 적으면 입력창에 저잔량 안내가 표시됩니다. 모든 크레딧을 사용하면 새로운 AI 작업을 시작할 수 없으며, 플랜 업그레이드 또는 크레딧 추가 구매 안내가 표시됩니다.
## 6. 매니 커스터마이징 활용하기
프로젝트에서 반복해서 사용하는 말투와 문서 작성 규칙이 있다면 **매니 커스터마이징**에 미리 저장할 수 있습니다.
매니 커스터마이징에서는 다음과 같은 설정을 관리할 수 있습니다.
* 대화 말투: 매니가 채팅에서 답변하는 말투와 형식
* 기획서 문체: PRD와 기능명세서 등 기획 문서에 사용하는 문체
* 기능 설명 양식: 기능과 상세 기능을 작성하는 순서와 형식
* 우리 팀 용어: 프로젝트에서 일관되게 사용해야 하는 명칭과 설명
* 하지 말아야 할 것: 사용하지 않을 표현이나 피해야 할 작성 방식
* 그 밖에 알아둘 것: 프로젝트의 AI 작업에 공통으로 적용할 추가 규칙
저장한 설정은 해당 프로젝트에서 지원되는 AI 작업에 적용됩니다. 사용할 수 있는 설정과 편집 권한은 플랜과 프로젝트 권한에 따라 달라질 수 있습니다.
설정 방법, 미리보기와 기존 문서 적용 과정은 매니(AI) 커스터마이징 가이드에서 자세히 확인하세요.
## 7. 개인 노트에 대화 내용 보관하기
왼쪽 **문서함 → 노트**를 엽니다. 조사 결과, 비교한 선택지와 미정 사항을 프로젝트별 개인 노트에 모아 둘 수 있습니다. 노트는 본인만 볼 수 있으며 팀원에게 자동으로 공유되지 않습니다.
매니에게 “이거 노트에 담아줘”라고 요청하거나 새 노트를 직접 작성합니다. 채팅에서 **@**로 노트 항목을 붙이거나 “노트 반영해줘”라고 요청해 기획 작업에 활용합니다. 문서 변경 제안이 만들어지면 검토한 뒤 승인합니다.
팀과 공유할 내용은 회의록에 저장합니다. 저장할 그룹과 내용을 확인하세요. 팀에 공유되는 회의록은 개인 노트 원본과 구분됩니다.
## 8. 그룹 회의록을 읽고 기획에 활용하기
프로젝트가 속한 그룹의 회의록을 매니에게 찾아 읽도록 요청할 수 있습니다. 예: “지난주 회의록을 요약해줘”, “그 회의에서 합의한 정책을 읽고 기능명세서 변경안으로 정리해줘”.
해당 그룹의 멤버이며 회의록 접근 권한이 있어야 합니다. 개별 프로젝트 링크만 공유받은 외부 사용자는 AI를 통해 그룹 회의록에 접근할 수 없습니다.
회의록을 읽는 것만으로 결정이 문서에 자동 반영되지는 않습니다. 근거가 된 회의와 수정 범위를 확인한 뒤 변경안을 승인하세요. AI 작업에는 크레딧이 사용되며 자료가 많으면 남은 범위를 이어서 요청해야 할 수 있습니다.
