첫 커스텀 에이전트 구축

모든 팀에서 발생하는 반복적인 워크플로를 자동화하는 커스텀 에이전트를 구축하세요. 한 명이 설정하면 업무 자동화를 실현하여 모든 사람이 혜택을 누릴 수 있습니다.

소요 시간: 10분

전체 팀에서는 반복적인 수동 업무로 매주 몇 시간씩 할애합니다. 커스텀 에이전트는 사용자가 직접 명령어를 입력할 때까지 기다리지 않고 일정 잡기와 트리거 설정에 따라 자동으로 실행되어 변화를 만들어냅니다. 또한 이미 보유한 문서, 데이터베이스와도 연동됩니다.

커스텀 에이전트는 Slack 질문에 답하고, 주간 리포트를 작성하고, 작업을 자동으로 배정할 수 있습니다. 팀에 필요한 부분에 맞게 맞춤 설정하세요. 한 사람이 생성한 에이전트가 모두가 활용할 수 있는 공동 자산으로 자리 잡을 수 있어요.

이 가이드에서 다루는 내용:

  • 자동화에 가장 적합한 워크플로 식별

  • 커스텀 에이전트에 대한 명확하고 효과적인 에이전트 지침 작성

  • 올바른 트리거 및 일정 선택하기

  • 적절한 도구 및 사용 권한 구성

  • 자신 있게 테스트, 반복, 문제 해결

  • 팀 전체에서 커스텀 에이전트를 저장, 공유, 관리하기

커스텀 에이전트를 만들 때는 반복적이고 규칙에 기반하며 시간이 많이 소요되는 업무를 찾아보세요. Slack에서 동일한 질문을 하는 사람, 주간 리포트를 수동으로 업데이트해야 하는 사람 또는 동일한 유형의 요청을 분류하는 사람일 수 있습니다.

다음을 생성할 수 있습니다.

  • Q&A 에이전트: 에이전트에게 기존 문서를 지식 베이스로 사용하여 #프로덕트-질문 채널에서 질문에 자동으로 답변하도록 요청하세요.

  • 작업 배정 에이전트: 접수되는 제품 요청을 수집하고, 심각도와 구성 요소에 따라 자동 태그를 지정하고 새 버그 보고서를 배정하여 자동으로 전달합니다.

  • 프로젝트 보고 에이전트: 작업, Slack 스레드, 프로젝트 데이터베이스에서 가져온 주간 팀 보고서를 작성합니다.

스스로에게 다음과 같이 자문해 보세요. 이 설정을 한 번만 해두면 팀 전체가 이점을 누릴 수 있나요? 아니면 매주 상당한 시간을 절약할 수 있을까요? 그렇다면 커스텀 에이전트에 적합한 후보를 찾은 것입니다.

각 에이전트가 하나의 워크플로에 집중하도록 유지

시작하려면 워크스페이스 사이드바의 에이전트 섹션으로 이동해 +새 에이전트 추가를클릭합니다.

텍스트 상자에서 채팅을 시작하고, 커스텀 에이전트가 무엇을 해야 하는지 단순하고 자연스러운 언어로 설명하세요. 템플릿 옵션으로 시작할 수도 있습니다.

목표와 결과를 명확하게 명시하되, 모든 단계를 상세하게 설명할 필요는 없습니다.

  • 맥락을 구체적으로 작성하세요. 커스텀 에이전트가 언제, 어디에서 행동해야 하는지 정의하세요. 예를 들어, '누군가 질문할 때' 대신 '#프로덕트-질문 채널에서 누군가가 요금에 대해 질문하면 요금 FAQ 페이지에서 답변을 가져와 줘'라고 요청하세요.

  • @멘션 사용:'내 지식 베이스'를 모호하게 언급하는 대신 페이지, 데이터베이스 또는 사람을 지정하세요.

  • 형식과 배정 방식을 미리 정의하세요. 다양한 시나리오에서 어떤 작업이 수행되어야 하는지, 응답이 어디로 전달되어야 하는지 명확히 하세요. 예: '청구에 관한 질문은 재무팀으로 보내세요. 제품 기능에 관한 것이라면 @제품 문서에서 답변하세요.'

  • 예시 제공: 에이전트가 선호하는 스타일에 맞출 수 있도록 강력한 응답이 어떤 모습인지(및 피해야 할 사항) 보여주세요.

  • 명확한 경계 설정: 에이전트가 해야 할 일과 하지 말아야 할 일을 명확하게 명시하세요. 예를 들어, '새 주간 보고서 페이지를 만드는 대신 기존 주간 보고서 페이지를 업데이트해 줘' 또는 #일반이 아닌 #지원에서만 답변해 줘'와 같이 요청하세요.

Q&A 에이전트를 구축하는 방법은 다음과 같습니다. '@도움말 센터 및 @프로덕트 FAQ를 사용하여 질문에 답변하는 #프로덕트-질문용 Q&A 에이전트를 생성해 줘.'

지침, 추천 페이지 및 도구를 포함하여 에이전트의 구성이 실시간으로 업데이트되는 것을 볼 수 있습니다. 이것은 대화의 시작일 뿐이므로 검토하고 필요에 따라 조정하세요.

트리거는 에이전트에 실행 시점을 알려줍니다. 커스텀 에이전트와 채팅할 때 구축하는 내용에 따라 특정 트리거를 선택하세요.

이벤트 기반 트리거는 다음과 같은 일이 발생할 때 실행됩니다.

  • Notion 또는 Slack 내 @멘션 발생

  • 데이터베이스에 새 페이지 추가됨

  • 특정 Slack 채널에서 메시지 게시됨

Q&A 에이전트의 경우, 연결된 Slack 채널에서 누군가가 에이전트를 @멘션하는 경우와 같이 이벤트 기반 트리거를 사용하세요. #프로덕트-질문 채널에서 @멘션된 경우에만 응답하도록 설정할 수 있으므로 명시적으로 요청된 경우에만 개입합니다.

예약된 트리거는 정의된 일정에 따라 자동으로 실행됩니다.

  • 매주 월요일 오전

  • 매일 오후 5시

  • 매주 금요일

프로젝트 보고 에이전트의 경우 트리거는 시간 기반입니다. 매주 월요일 오전 또는 금요일 오후에 실행되도록 설정하면 팀이 일관된 주간 요약을 받을 수 있으며, 수동으로 요약할 필요가 없습니다.

커스텀 에이전트가 초기 지침을 작성한 후에는 이를 검토하여 예외적인 경우, 이관 경로, 원하는 사항 또는 원하지 않는 사항의 예 등 세부 사항을 추가해야 하는지 확인하세요.

에이전트의 판단을 돕기 위한 ' 경우에는이렇게 해줘' 수준의 간단한 안내로 생각하세요. 답변이 도움말 센터에 있는 경우, 짧은 요약과 링크를 포함하여 답변하세요. 그렇지 않은 경우, 모른다고 말하고 지원 팀을 태그하세요.

기본 사항을 다룬 후에는 더 고급 동작을 추가할 수 있습니다. 제품 Q&A 에이전트의 경우 다음을 추가할 수 있습니다.

  • '질문에 답한 후, 다음과 같은 후속 질문을 해줘. '이 답변이 질문에 대한 해답이 되었나요? 그렇다면 👍로 반응하고, 추가 도움이 필요한 경우 👎로 반응하세요.'

  • '사용자가 👍으로 반응하는 경우, ✅를 추가하여 스레드를 해결됨으로 표시해 줘.'

  • '사용자가 👎으로 반응하는 경우, 나중에 누군가가 해당 질문을 확인하고 소유자를 지정할 수 있도록 @지원 데이터베이스로 전달해 줘.'

지침 페이지는 에이전트의 메모리 역할을 하며, 사용자가 채팅할 때 정보가 추가됩니다. 문제가 발생하는 경우, 문제를 설명하면 에이전트가 문제 해결을 위해 조치를 취할 수 있습니다. 원하는 경우 언제든지 지침 페이지를 열고 수동으로 편집할 수 있습니다.

커스텀 에이전트와 채팅할 때 필요한 페이지, 데이터베이스 또는 도구를 자동으로 추가할 수 있습니다. 도구와 사용 권한 섹션에 해당 항목이 표시됩니다. 에이전트는 연결하라는 명령어도 표시됩니다.

페이지와 도구가 자동으로 추가되더라도, 각 페이지와 도구를 검토하고 사용 권한을 부여해야 합니다. 대부분의 경우, 보기 권한이면 충분합니다. 에이전트가 실제로 콘텐츠를 변경해야 하는 경우에만 편집 권한을 부여하세요.

연결하는 도구에 따라 필요한 권한이 달라집니다. 예를 들어, Slack을 연결하는 경우 에이전트가 읽거나 게시할 수 있는 채널(공개 및 비공개 채널 모두 포함)을 정확히 선택하세요. 구성하지 않은 채널에서는 에이전트가 응답하지 않습니다.

커스텀 에이전트를 사용하기 전에 도구 권한 확인

에이전트는 모든 사용자에게 공개되지 않은 정보에 접근해야 할 수도 있습니다. 더 광범위하게 공유하기 전에 간단한 사용 권한 확인을 통해 사용 권한이 예상 사용 방식과 일치하는지 확인하세요.

MCP API 통합을 사용하여 커스텀 에이전트 연결

에이전트를 공유하거나 활성화하기 전에 테스트하세요. 목표는 첫 시도에서 완벽을 달성하는 것이 아니라 제어된 반복입니다.

  • 활성화하기 전에 테스트:실행을 클릭하여 에이전트를 수동으로 실행하고 트리거 또는 일정을 켜기 전에 출력 값을 검토하세요.

  • 안전한 환경에서 시작하기:

    • Slack 기반 에이전트의 경우: 테스트 채널을 만들고, 질문을 게시하고, 에이전트를 @멘션하세요. 에이전트가 정확하게 응답하고 올바른 출처에서 정보를 가져오는지 확인하세요.

    • 작업 배정 에이전트의 경우: 테스트 요청 또는 버그를 제출하고 태그가 지정되고 올바르게 할당되었는지 확인하세요.

    • 예약된 에이전트의 경우: 일정을 활성화하기 전에 수동으로 트리거하여 출력을 미리 보세요.

  • 반복적인 개선이 필요하다는 점 염두에 두기: 커스텀 에이전트가 제대로 작동하려면 여러 번의 테스트 실행이 필요할 수 있습니다. 의도한 작업이 아닌 실제 출력 결과를 바탕으로 지침을 조정하세요.

  • 먼저 활동 로그를 확인하세요. 문제가 발생하면 시계 아이콘을 클릭하여 실행을 트리거한 요소, 에이전트가 수행한 작업, 실패한 위치를 확인하세요.

활동 탭에는 각 실행과 에이전트가 수행한 작업이 표시됩니다. 무언가 잘못된 경우, 에이전트와 채팅하여 문제를 해결하거나 필요한 경우 버전 기록을 통해 롤백하세요.

일반적인 이슈 해결 방법

커스텀 에이전트가 원하는 방식으로 작동하면, 이를 저장하고 팀과 공유하여 모든 사람이 동일한 자동화의 혜택을 누릴 수 있습니다.

Notion의 페이지와 마찬가지로 에이전트를 공유할 수 있습니다. 화면 상단의 공유 버튼을 클릭하고 필요에 따라 팀원 또는 그룹을 초대하세요.

유용한 몇 가지 사항에 유의하세요.

  • 편집은 향후 모든 실행에서 개선됩니다. 에이전트의 지침 업데이트는 모든 사용자의 향후 모든 실행에 적용됩니다.

  • 권한이 중요함: 에이전트는 자체 사용 권한으로 실행되므로, 더 광범위하게 공유하기 전에 에이전트가 보고 수행할 수 있는 작업을 검토하세요.

  • 소규모로 시작: 먼저 몇 명의 팀원과 공유한 다음, 원활하게 작동하는 것이 확인되면 더 많은 사람에게 공유하는 것이 좋습니다.

  • 이름을 지정하고 명확하게 설명하기: 명확한 이름과 짧은 설명을 통해 팀원이 에이전트를 언제 어떻게 사용해야 하는지 알 수 있습니다.

신중하게 공유하면 에이전트가 단순히 개인 단축키가 아닌 신뢰할 수 있는 팀원이 될 수 있습니다.

공유 범위 확장 전 사용 권한 검토

커스텀 에이전트가 실행되면, 예전에는 사람이 계속 조율해야 했던 업무가 자동으로 처리됩니다. 팀은 내 지시를 기다릴 필요 없이 필요한 답변, 업데이트, 배정을 받을 수 있습니다.

  • 필요한 크레딧을 가장 정확하게 예측할 수 있는 방법은 실제로 커스텀 에이전트를 사용해 보는 것입니다. 각 실행 후 크레딧 대시보드에 정확한 사용량이 표시됩니다.

  • 최상의 결과를 얻으려면

    • 먼저 작은 범위로 시작한 다음, 커스텀 에이전트를 미세 조정하세요.

    • 필요한 크레딧을 정확히 파악하려면 1~2회의 청구 주기 동안 실제 사용량을 검토해 보세요.

    • 필요에 따라 크레딧 사용량을 늘리거나 줄이세요.

  • 이 추정치는 현재 사용량을 기반으로 합니다. 에이전트 효율성이 개선됨에 따라, 시간이 지날수록 비용은 점차 감소할 것으로 예상됩니다. 이 기준은 정기적으로 업데이트될 예정입니다.

  • 크레딧 사용량 관리에 관한 더 많은 팁은 커스텀 에이전트 시작하기에 관한 가이드를 참고해 주세요.

이 가이드 공유하기

피드백 보내기

이 내용이 도움이 되었나요?


템플릿으로 시작하기

템플릿 갤러리에서 10,000개가 넘는 템플릿을 둘러보세요.


설명되지 않은 부분이 있나요?