# 빠른 시작

> Endue 에이전트를 만들고, 이미 쓰는 도구에 연결하고, 실제 결과물을 받기까지 약 10분.

말만 하는 장난감이 아니라 실제로 쓸모 있는 일을 하는 에이전트 하나를 만들어 봅니다. 끝나면 자기 정체성과 도구 연결을 갖춘 에이전트, 그리고 가리킬 수 있는 결과물이 남습니다.

## 시작하기 전에

다음이 준비돼 있어야 합니다.

- 웹에 로그인된 Endue 계정.
- 10분 정도의 시간.
- 에이전트가 다룰 서비스의 계정 — Gmail, Google 캘린더, Slack, Notion, 또는
  [그 밖의 서비스](/ko/docs/connect/available-connectors/) 중 하나. 3단계에서 하나를 연결합니다.
  데이터를 시험 삼아 다뤄도 괜찮은 계정을 쓰세요.

<Aside type="note">
  이 안내는 웹 앱을 기준으로 합니다. Endue 는 [데스크톱 · 모바일 · 명령줄](/ko/docs/get-started/surfaces/)
  에서도 돌아가고, 여기서 만드는 에이전트는 그 모두에서 그대로 동작합니다.
</Aside>

## 첫 에이전트 만들기

<Steps>

1. **에이전트를 만듭니다.**

   **에이전트**로 가서 **새 에이전트**를 선택합니다. 이름과 핸들을 정하세요. 핸들은 나중에
   에이전트를 부르는 이름이니 짧게 두는 편이 좋습니다.

   이 에이전트가 무엇을 위한 것인지 한 문장으로 씁니다. 구체적일수록 좋습니다.
   *"매일 아침 안 읽은 메일을 요약하고 답장이 필요한 것을 표시한다"* 는 *"이메일 비서"* 보다
   훨씬 나은 에이전트를 만듭니다.

2. **시스템 프롬프트를 줍니다.**

   에이전트를 열고 시스템 프롬프트를 씁니다. 모든 대화 전에 읽는 상시 지침입니다. 무엇을
   해야 하는지, 무엇을 절대 하면 안 되는지, 좋은 결과가 어떤 모습인지 적으세요.

   Endue 는 이 프롬프트의 모든 판을 보관합니다. 마음껏 바꾸세요. 바꾼 것이 더 나쁘면 잘
   되던 리비전으로 되돌리면 됩니다.

3. **도구를 연결합니다.**

   에이전트 빌더에서 **커넥터**를 열고 에이전트가 다룰 서비스를 연결합니다 — Gmail,
   Google 캘린더, Slack, Notion, 또는 [제공되는 전체 목록](/ko/docs/connect/available-connectors/)
   중 하나입니다.

   해당 제공자 화면으로 이동해 로그인하고 접근을 승인하게 됩니다. Endue 는 그 동의 화면에
   표시된 권한만 받고, 그 권한은 언제든 해지할 수 있습니다.

   그런 다음 연결을 에이전트에 바인딩합니다. 그래야 계정의 모든 에이전트가 아니라 이
   에이전트만 그 연결을 쓸 수 있습니다.

   <Aside type="caution" title="쓰려던 계정이 맞는지 확인하세요">
     연결은 제공자의 특정 계정에 묶입니다. 회사 구글 계정과 개인 구글 계정을 둘 다 쓴다면
     어느 쪽으로 로그인하는지 확인하세요.
   </Aside>

4. **실제 일을 시켜봅니다.**

   에이전트와 대화를 열고 시험용이 아닌 진짜 작업을 줍니다 —
   *"이번 주 메일 중 내가 답장하지 않은 것을 모두 찾아서, 각각 무엇을 요구하는지 요약해줘."*

   에이전트는 **실행** 안에서 일합니다. 어떤 도구를 부를지 정하고, 부르고, 결과를 읽고,
   답에 이를 때까지 계속합니다. 각 단계는 진행되는 대로 볼 수 있습니다.

5. **엉뚱한 방향으로 가면 잡아줍니다.**

   잘못 가는 실행이 끝나기를 기다릴 필요가 없습니다. 도는 중에 정정을 보내면 에이전트가
   다음 단계에서 그것을 반영합니다.

6. **계정 밖으로 나가는 일은 승인합니다.**

   에이전트가 메일을 보내거나, 메시지를 올리거나, 무언가를 지우려 하면 멈추고 먼저 묻습니다.
   승인하면 사용자가 본 그 행동을 그대로 실행하고, 거절하면 다른 방법을 찾습니다.

   외부로 나가는 행동과 되돌릴 수 없는 행동에 대해 이 관문은 선택 사항이 아니며 끌 수도
   없습니다.

7. **결과물을 찾습니다.**

   보고서 · 요약 · 문서처럼 분량이 있는 산출물은 **아티팩트**가 되어 **아티팩트** 아래에
   자기 페이지를 갖습니다. 아티팩트는 기본적으로 사용자만 볼 수 있습니다. 작업 공간 밖의
   사람에게 읽히고 싶을 때 링크로 공유하면, 그 사람에게 다른 접근 권한은 생기지 않습니다.

</Steps>

<Aside type="note" title="스크린샷은 준비 중입니다">
  이 안내는 제품을 함께 띄워 놓고 따라올 독자를 기준으로 썼습니다. 단계별 주석 스크린샷은
  앱에서 자동으로 생성되며 이 페이지의 다음 판에 실립니다.
</Aside>

## 반복되게 만들기

방금 만든 에이전트는 시킬 때 움직입니다. 진짜 값어치는 시키지 않아도 움직일 때 나옵니다.

같은 작업을 일정이 붙은 **루틴**으로 바꾸세요 — 평일 아침 8시, 매주 월요일, 매달 1일처럼요.
루틴은 Endue 를 열어두지 않아도 실행되고, 결과물은 돌아왔을 때 기다리고 있습니다. 판단이
필요하면 에이전트가 묻고, 그 요청은 인박스에서 보입니다.

## 더 나은 에이전트 만들기

도움이 되는 에이전트와 성가신 에이전트를 가르는 것은 대개 어떤 모델을 쓰느냐가 아니라 어떻게
설정했느냐입니다. 아래를 해본 뒤에는 [시험하고 다듬기](/ko/docs/build/iterating/)에서 잘 돌던
에이전트를 망가뜨리지 않고 바꾸는 방법을 다룹니다.

<AccordionGroup>
  <Accordion title="좋은 결과가 어떤 모습인지 말한다">
    단계는 에이전트가 알아서 고릅니다. 알아서 맞힐 수 없는 것은 "다 됐다" 에 대한 사용자의
    기준입니다.

    *"메일 요약해줘"* 대신 *"안 읽은 메일을 요약하되 보낸 사람별로 묶고, 나에게 직접 질문한
    것은 원문 그대로 인용해서 메일을 열지 않고도 답할 수 있게 해줘"* 로 말해보세요.
  </Accordion>

  <Accordion title="상시 규칙은 매 메시지가 아니라 시스템 프롬프트에 둔다">
    모든 대화에서 되풀이하게 될 것은 시스템 프롬프트에 넣습니다. 내가 누구인지, 무엇을 중요하게
    보는지, 에이전트가 절대 하면 안 되는 일, 결과물의 형식 같은 것들입니다.

    프롬프트는 버전이 남으니 마음 놓고 다듬어도 됩니다. 바꾸고, 나아졌는지 보고, 아니면
    되돌리세요.
  </Accordion>

  <Accordion title="한 가지 일을 맡긴다">
    목적이 좁고 도구가 셋인 에이전트가, 목적이 흐릿하고 도구가 스무 개인 에이전트보다 낫습니다.
    기존 에이전트를 넓히지 말고 두 번째 에이전트를 만드세요.
  </Accordion>

  <Accordion title="도는 중에 바로잡는다">
    실행이 잘못 가는 것을 보면서 끝나기를 기다리면 그 실행을 통째로 버리게 됩니다. 문제가
    보이는 즉시 정정을 보내세요. 에이전트는 다음 단계에서 그것을 반영합니다.
  </Accordion>

  <Accordion title="필요한 연결만 바인딩한다">
    연결을 에이전트별로 바인딩하는 데는 이유가 있습니다. 캘린더가 필요 없는 에이전트는 캘린더를
    갖지 않아야 합니다. 잘못될 수 있는 범위가 좁아지고, 에이전트의 선택도 더 예측 가능해집니다.
  </Accordion>
</AccordionGroup>

## 다음에 읽을 것

<CardGrid>
  <LinkCard
    title="핵심 개념"
    href="/ko/docs/get-started/core-concepts/"
    description="에이전트 · 실행 · 스킬 · 커넥터 · 메모리 · 아티팩트가 정확히 무엇인지."
  />
  <LinkCard
    title="Endue 의 동작 방식"
    href="/ko/docs/get-started/how-it-works/"
    description="모든 실행 뒤의 루프, 그리고 실행이 멈추는 이유."
  />
  <LinkCard
    title="에이전트 빌더"
    href="/ko/docs/build/agent-builder/"
    description="에이전트의 행동을 정하는 모든 설정."
  />
  <LinkCard
    title="루틴"
    href="/ko/docs/automate/routines/"
    description="방금 만든 것을 사용자 없이도 돌아가는 일로 바꾸기."
  />
</CardGrid>

## 도움 받기

- **문서 검색** — 아무 페이지에서나 <kbd>Ctrl</kbd>/<kbd>⌘</kbd> + <kbd>K</kbd> 를 누르세요.
- **에이전트에게 묻기** — 여기 모든 페이지는 Markdown 으로도 제공되고 사이트 전체가
  [`/llms.txt`](/ko/docs/llms.txt) 에 색인돼 있습니다. 에이전트에게 그 주소를 주고 물어보세요.
- **메일 보내기** — [support@endue.ai](mailto:support@endue.ai).