콘텐츠로 건너뛰기
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

에이전트 빌더에서 에이전트를 생성하고 사용자 지정하기

마지막 업데이트 날짜: 2026년 7월 23일

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

비즈니스 프로세스에 따라 데이터를 분석하고, 결과를 생성하며, 조치를 취할 수 있는사용자 지정 에이전트(베타)를 생성하세요. 최신 빌더를 통해 에이전트가 수행해야 할 작업, 액세스할 수 있는 데이터, 그리고 대응 방식을 정의할 수 있습니다.

맞춤형 에이전트는 데이터에 일관된 논리를 적용하여 작업 수행 방식을 표준화하고 수작업 부담을 줄여줍니다. 이는 레코드 검토, 구조화된 결과물 생성, 또는 여러 데이터 소스를 기반으로 한 의사 결정이 필요한 프로세스에 유용합니다.

AI 기능을 위해 계정을 구성하는 방법에 대한 개요는 HubSpot 계정을 설정하여 AI 기능을 도입하는 방법을 참조하십시오.

참고: AI 설정에서 AI 기능 액세스를 관리할 수 있으며, 어떤 데이터를 공유할지 구성할 수 있습니다. AI 보안 제어, 데이터 사용 및 규정 준수에 대한 자세한 내용은 HubSpot의 AI 신뢰 FAQAI 모델 카드를 검토하세요.

시작하기 전에

에이전트 빌더에서 에이전트를 생성하고 사용자 지정하기 전에, 요구 사항과 고려 사항을 확인하십시오.

  • 슈퍼 관리자는 AI 설정에서 다음 스위치를 켜야 합니다.

    • 사용자에게 생성형 AI 도구 및 기능에 대한 액세스 권한 부여

    • CRM 데이터

    • 고객 전환 데이터

    • 파일 데이터

    • 사용자에게 Breeze Assistant에 대한 액세스 권한 부여

권한 필요 에이전트 빌더에서 에이전트를 생성하고 사용자 지정하려면 슈퍼 관리자 또는 Breeze Studio 권한이 필요합니다.

권한 필요 에이전트의 목적에 따라 사용자에게 추가 권한이 필요할 수 있습니다. 예를 들어, 랜딩 페이지를 생성하는 에이전트의 경우 랜딩 페이지를 편집하고 게시하려면 '편집' 및 '게시' 권한이 필요합니다.

에이전트 빌더에서 에이전트 생성하기

지침을 정의하고, 동작을 선택하며, 에이전트가 사용할 데이터와 입력값을 구성하여 맞춤형 에이전트를 생성하세요.

  1. HubSpot 계정에서 ‘더 보기’를 클릭한 다음, ‘에이전트’ > ‘에이전트 허브’로 이동합니다. 계정에 ‘더 보기’가 표시되지 않는 경우, ‘에이전트’ > ‘에이전트 허브 ’로 직접 이동하십시오.

  2. '소개' 탭에서 오른쪽 상단의 '생성' 드롭다운 메뉴를 클릭하고 '에이전트'를 선택합니다.

  3. 에이전트 빌더에서 에이전트의 지침, 작업, 지식 및 입력 항목을 구성하세요.

지침

에이전트가 수행해야 할 작업과 행동 방식을 정의합니다. 여기에는 에이전트의 역할, 목표, 접근 방식 및 예상 결과물을 포함합니다.

에이전트 빌더에서 '지침' 필드에 텍스트를 입력하세요. 에이전트의 역할, 목표, 접근 방식 및 예상 결과를 명확하게 정의하세요.

예를 들어, 다음과 같은 지침을 추가할 수 있습니다.

Role:
You’re a customer onboarding review agent responsible for preparing internal handoffs after a deal is closed.
Goal:
Analyze customer information and summarize key details needed for a successful onboarding process.
Approach: 
Review contact and company properties, deal details, and recent activity.
Identify important context such as customer goals, purchased products, timeline expectations, and risks.
Flag any missing or unclear information that may impact onboarding.
Output:
Section 1: Customer summary (3-5 bullet points).
Section 2: Key onboarding considerations.
Section 3: Missing information or risks.
Keep responses concise, structured, and actionable.

작업

에이전트가 수행할 수 있는 동작을 선택하십시오. 동작은 지침에 따라 에이전트가 어떤 작업을 완료할 수 있는지를 결정합니다.

  1. 에이전트 빌더에서 왼쪽 패널의 '작업 추가'를 클릭합니다.

  2. 오른쪽 패널에서 'HubSpot', '기본값' 또는 'MCP' 탭을 클릭하고 원하는 작업을 선택합니다.

    • HubSpot: 다양한 유형의 작업(예: 데이터 가져오기, 생성, 조치 수행) 중에서 선택합니다. 작업 유형을 필터링하려면 '유형' 드롭다운 메뉴를 클릭하고 유형 (예: 생성)을 선택합니다.

    • 기본값: 웹 검색 또는 HubSpot CRM 레코드 읽기와 같은 기본 작업 중에서 선택합니다.

      • 웹 검색: 상담원이 웹을 검색할 수 있도록 허용합니다.

      • HubSpot CRM 기록 읽기: 에이전트가 CRM 기록을 읽을 수 있는 권한을 부여합니다.

      • HubSpot CRM 레코드 쓰기: 에이전트가 CRM 레코드에 내용을 작성할 수 있는 권한을 부여합니다.

    • MCP: MCP(Model Context Protocol)를 사용하여 상담원을 외부 시스템에 연결합니다. 지원되는 MCP 서버에 대해 자세히 알아보세요.

지식

업로드된 문서, 브랜드 가이드라인, 지식 저장소 또는 관련 CRM 데이터 등 에이전트가 출력을 생성할 때 참조할 수 있는 구체적인 사용 사례 컨텍스트를 추가하십시오.

'지식' 섹션을 사용하여 에이전트가 데이터를 분석하거나 응답을 생성할 때 활용할 수 있는 지원 정보를 제공하십시오. 입력과 달리, 이 컨텍스트는 실행할 때마다 재정의할 필요 없이 에이전트가 항상 이용할 수 있습니다.

예를 들어, 온보딩에 중점을 둔 에이전트는 거래 세부 정보, 관련 회사 정보 및 최근 활동을 활용할 수 있는 반면, 콘텐츠에 중점을 둔 에이전트는 업로드된 문서나 파일을 사용할 수 있습니다.

  1. 에이전트 빌더의 ‘지식’ 섹션에서 ‘지식 추가’를 클릭합니다.

  2. 오른쪽 패널에서 ‘사용자 지정’, ‘기본’ 또는 ‘통합’을 클릭하고 필요한 지식을 선택합니다.

입력

에이전트가 실행될 때마다 사용하는 구체적인 데이터(예: 레코드, 사용자가 제공한 값, 다른 도구 또는 프로세스에서 전달된 정보)를 정의합니다.

입력을 사용하여 에이전트가 특정 실행 시 어떤 항목에 대해 조치를 취해야 하는지 지정합니다. 지식과 달리 입력은 실행 시점에 제공되며 컨텍스트에 따라 달라질 수 있습니다.

예를 들어, 온보딩에 중점을 둔 에이전트는 거래 이름, 마감일 또는 고객 목표와 같은 입력을 사용할 수 있는 반면, 콘텐츠에 중점을 둔 에이전트는 주제, 대상 또는 핵심 메시지가 필요할 수 있습니다.

  1. 에이전트 빌더에서 '입력' 섹션의 '입력 추가'를 클릭합니다.

  2. '입력 유형' 드롭다운 메뉴를 클릭하고 옵션 (예: CRM 개체)을 선택합니다.

  3. '레이블' 필드에 입력 항목의 이름을 입력합니다. 

에이전트 액세스 관리

각 에이전트에 대한 액세스 권한을 가진 사용자를 제어할 수 있습니다. 기본적으로 슈퍼 관리자는 에이전트를 편집할 수 있으며, 모든 사용자는 에이전트를 실행할 수 있습니다.

에이전트의 구성이 사용자가 액세스 권한이 없는 다른 HubSpot 기능(예: 블로그 또는 랜딩 페이지)에 의존하는 경우, 해당 사용자는 에이전트를 편집하거나 실행할 권한이 있더라도 에이전트를 실행할 수 없습니다.

  1. 에이전트 빌더에서 세 개의 수직 점 아이콘을 클릭하고 왼쪽 상단의 '액세스 권한 할당'을 선택합니다.

  2. 오른쪽 패널에서 액세스 옵션을 선택합니다.

    • 소유자 및 슈퍼 관리자가 편집 및 실행 가능: 에이전트를 생성하거나 설치한 사용자와 슈퍼 관리자만 에이전트를 편집하고 실행할 수 있습니다.

    • 소유자 및 슈퍼 관리자가 편집 가능, 모든 사용자가 실행 가능: 에이전트를 생성하거나 설치한 사용자와 슈퍼 관리자만 에이전트를 편집할 수 있습니다. 모든 사용자가 에이전트를 실행할 수 있습니다.

    • 모든 사용자가 편집 및 실행 가능: 모든 사용자가 에이전트를 편집하고 실행할 수 있습니다.

    • 사용자 지정 팀 및 사용자 액세스: 선택한 사용자 및 팀만 에이전트를 편집하거나 실행할 수 있습니다. 이 옵션을 선택하면 다음과 같은 추가 액세스 옵션이 표시됩니다:

      • 실행 및 편집: 선택한 사용자 또는 팀이 에이전트를 실행하고 편집할 수 있습니다.

      • 실행: 선택된 사용자 또는 팀이 에이전트를 실행할 수 있습니다.

  3. 설정이 완료되면 ‘업데이트’를 클릭하세요.

에이전트 빌더에서 에이전트 테스트하기

에이전트를 테스트하여 출력이 기대에 부합하는지 확인하세요. 테스트를 통해 에이전트가 올바른 입력을 사용하고, 올바른 데이터를 참조하며, 예상된 결과를 반환하는지 확인할 수 있습니다. 

참고: 에이전트 테스트 시 크레딧이 소모되지 않습니다. 에이전트 빌더에서 예상 에이전트 비용을 확인하는 방법에 대해 자세히 알아보세요.

  1. 오른쪽 패널에서 필요한 입력값을 입력합니다.

  2. '에이전트 테스트'를 클릭합니다.

  3. 표시되는 대화 상자에서 ‘실행’을 클릭합니다.

  4. [ 출력 ] 탭에서 다음 항목에 대한 출력을 확인하십시오.

    • 에이전트가 예상된 형식을 따르는지 확인하십시오.

    • 에이전트가 예상된 데이터와 컨텍스트를 사용하는지 확인하십시오.

    • 누락된 내용, 부정확한 내용 또는 불명확한 응답을 확인합니다.

  5. 필요에 따라 에이전트 구성을 업데이트하십시오:

    • 명확성이나 구체성을 높이기 위해 지침을 다듬으십시오.

    • 관련 데이터가 누락되었거나 잘못된 경우 지식 소스를 조정합니다.

    • 필요한 정보가 포함되도록 입력 내용을 업데이트하십시오.

  6. 출력 결과가 일관되고 요구 사항을 충족할 때까지 테스트를 반복하십시오. 그런 다음 예상 크레딧 비용을 검토하고 실행 한도를 설정하십시오.

예상 크레딧 비용 검토 및 실행 한도 설정

에이전트 테스트를 마친 후, 해당 작업에 필요한 예상 HubSpot 크레딧을 확인하세요. 또한 실행 한도를 설정하여 에이전트가 실행 중에 사용할 수 있는 크레딧 수를 제어함으로써, 계정 전반의 크레딧 사용량을 관리할 수 있습니다.

  1. 에이전트 빌더에서 페이지 상단의 '실행 내역'을 클릭하십시오.

  2. 왼쪽 패널에서 에이전트 실행 항목을 클릭하십시오.

  3. 오른쪽 패널에서 예상 크레딧을 검토하십시오.

이러한 예상 비용은 참고용으로만 제공됩니다. 실제 비용은 다를 수 있습니다.에이전트의 예상 크레딧 비용 확인월별 실행 한도 설정에 대해 자세히 알아보세요.

맞춤형 에이전트 게시

에이전트를 테스트하고 출력이 기대에 부합함을 확인한 후, 에이전트를 저장하고 게시하여 사용할 수 있도록 하세요. 

  1. 에이전트 빌더에서 '저장 및 변경 사항 게시'를 클릭합니다.

  2. 에이전트를 실행하려면 오른쪽 상단의 ‘실행’을 클릭하세요. 에이전트 수신함에서 에이전트 출력을 실행하고 검토하는 방법에 대해 자세히 알아보세요.

게시 후에는 에이전트를 더 광범위한 프로세스의 일부로 활용하고, 다른 자동화 작업에 에이전트를 포함시키세요. 워크플로에 에이전트를 추가하는 방법에 대해 자세히 알아보세요.

다음 단계

이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.