Build with Agent

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는 Replit의 AI 빌더이자 아이디어를 소프트웨어로 변환하는 동반자입니다. Agent는 변경사항을 계획하고, 코드를 작성하고, 동작을 설명하고, 이슈를 디버그하고, 앱을 개선할 수 있습니다. Vibe coding 101이 마인드셋을 설명하는 반면, 이 페이지는 Agent와 실제로 어떻게 작업하는지 설명합니다. 효과적인 프롬프팅은 더 명확한 지시를 작성하는 방법을 설명합니다. Agent를 필드의 쿼터백으로 생각하세요: 상황을 읽고, 경로를 선택하고, 작업을 앞으로 진행시킵니다. 여러분은 코치입니다: 전략을 세우고, 플레이를 정하고, 결과를 검토하고, 다음 움직임을 결정합니다. Agent는 많은 것을 할 수 있지만, 여러분이 프로세스를 이끌 때 가장 잘 작동합니다: 구체적으로, 계획을 세우고, 컨텍스트를 추가하고, 검토 및 테스트하고, 필요할 때 체크포인트를 사용하세요.

​

Agent와 빌드하기 위한 다섯 가지 팁

Agent와 작업할 때 이 습관들을 사용하세요:

1. 구체적으로.
2. 계획 세우기.
3. 컨텍스트 추가.
4. 검토 및 테스트.
5. 체크포인트 사용.

​

구체적으로

Agent는 복잡한 작업을 처리할 수 있지만, 명확한 방향이 필요합니다. 유용한 요청은 원하는 것, 중요한 것, 그리고 변경하지 말아야 할 것을 설명합니다. 모든 구현 세부사항을 설명할 필요는 없지만, Agent가 좋은 결정을 내릴 수 있을 만큼 충분한 방향을 제공해야 합니다. 다음 대신: 이렇게 시도하세요: 두 번째 프롬프트는 Agent에게 목표, 집중 영역, 제약사항을 제공합니다. 요청에 여러 부분이 있을 때 가장 중요한 것을 말하세요. Agent가 그 작업을 단계로 나눌 수 있지만, 여러분의 방향이 성공이 어떤 것인지 알려줍니다. 더 구체적인 지시의 예시는 효과적인 프롬프팅을 참조하세요.

​

계획 세우기

계획은 불확실성, 여러 단계, 트레이드오프, 또는 파일이 변경되기 전에 승인하고 싶은 것이 있을 때 도움이 됩니다. 대화에서 Agent에게 계획을 만들도록 요청할 수 있습니다: 파일을 변경하기 전에 Agent가 먼저 생각하고 승인을 기다리길 원할 때는 Plan 모드를 사용하세요. 제출하기 전에 프롬프트 컴포저에서 Plan을 토글하세요. Agent가 생각을 마치면 지금 검토 버튼이 있는 작업 계획을 검토할 준비가 됨 배너가 표시됩니다.

​

컨텍스트 추가

컨텍스트는 Agent가 무엇이 중요한지 이해하는 데 도움을 줍니다. 텍스트, 스크린샷, 스케치, 파일, 데이터, 오류, 또는 Canvas 주석으로 컨텍스트를 추가할 수 있습니다. 문제를 가장 잘 설명하는 형식을 사용하세요. 변경이 동작, 목표, 또는 제약사항에 관한 것일 때 텍스트 사용: 레이아웃을 말로 설명하기 어려울 때 스크린샷이나 스케치 사용: 변경이 시각적이고 앱의 특정 부분을 가리키고 싶을 때 Canvas 주석 사용. 좋은 컨텍스트에는 변경하지 말아야 할 것도 포함됩니다. 그러면 Agent가 의도치 않게 다른 부분을 다시 작성하지 않고 한 영역을 개선할 수 있습니다.

​

검토 및 테스트

Agent가 빌드 전에 계획을 제안하고, 이후에 변경사항을 요약할 수 있습니다. 둘 다 읽으세요. 작업 계획 카드에서 보기를 선택하여 계획을 엽니다. 확장된 계획은 Agent가 무엇을 빌드할 의도인지, 성공 기준, 범위에서 제외된 것, Agent가 따를 단계를 보여줍니다. Agent가 빌드하기 전에 계획을 검토하세요:

• 이것이 올바른 문제를 해결하나요?
• 빠진 것이 있나요?
• 범위를 벗어난 것이 있나요?
• 먼저 빌드할 더 작은 버전이 있나요?
• 결과를 어떻게 테스트해야 하는지 설명하나요?

계획이 너무 광범위하면 Agent에게 줄이도록 요청하세요. Agent가 빌드한 후, 앱을 직접 테스트하세요. Preview를 열고 그것이 대상인 사람처럼 사용하세요. 확인사항:

• 누군가 주요 작업을 완료할 수 있나요?
• 요청한 변경이 발생했나요?
• 모바일에서도 앱이 여전히 작동하나요?
• 중요한 동작이 깨졌나요?
• Agent가 관련 없는 것을 변경했나요?
• 결과가 계속 빌드할 만큼 충분히 좋은가요?

무언가 잘못되었다면 본 것을 설명하세요. 다음 대신: 이렇게 시도하세요: 구체적인 피드백이 Agent가 올바른 이슈를 수정하는 데 도움을 줍니다.

​

체크포인트 사용

체크포인트는 변경이 잘못된 방향으로 갔을 때 복구하는 데 도움을 줍니다. 결과가 가깝다면 집중적인 피드백을 사용하세요: 앱이 이전보다 나빠졌거나, 중요한 동작이 깨졌거나, Agent가 예상보다 더 많이 변경했을 때 체크포인트를 사용하세요. Agent 패널에서 History를 열어 체크포인트를 확인하세요. 각 체크포인트에는 변경사항과 함께 여기서 롤백 및 변경사항 컨트롤이 표시됩니다. 여기서 롤백을 선택하면 Agent가 롤백을 적용하기 전에 복원될 내용을 확인합니다. 앞으로 수정할지 롤백할지 확실하지 않다면 Agent에게 비교를 도와달라고 요청하세요. 잘못된 방향으로 가는 것은 정상입니다. 체크포인트를 사용하면 더 안전한 버전으로 돌아갈 수 있는 능력을 잃지 않고 탐색할 수 있습니다. 더 많은 복구 가이드는 체크포인트 및 롤백을 참조하세요.

​

좋은 Agent 협업의 느낌

다음과 같을 때 올바른 방향에 있습니다:

• 요청이 목표와 제약사항을 설명합니다.
• Agent의 계획이 검토할 만큼 충분히 명확합니다.
• 말로 부족할 때 스크린샷, 파일, Canvas 메모를 추가합니다.
• 변경 후 중요한 흐름을 테스트합니다.
• 무언가 잘못되었을 때 집중적인 피드백을 제공합니다.
• 잘못된 변경을 영원히 풀려고 하는 대신 체크포인트를 사용합니다.

​

다음 단계