다음을 통해 공유


주제 만들기 및 편집

Copilot Studio에서 토픽은 에이전트 대화가 진행되는 방식을 정의합니다.

토픽을 작성하려면 원하는 내용을 설명하여 AI가 토픽을 생성하도록 할 수도 있고, 아예 처음부터 토픽을 생성할 수도 있습니다.

Copilot Studio에서 토픽은 사용자와 에이전트 간의 대화 스레드의 일부를 나타냅니다. 작성 캔버스에서 토픽을 정의하고 작업 합니다. 토픽에는 하나 이상의 노드가 포함되어 있으며, 이 노드는 토픽에서 수행할 수 있는 대화형 경로를 함께 정의합니다. 각 노드는 메시지 보내기 또는 질문하기와 같은 작업을 수행합니다.

에이전트 및 토픽 제한에 대한 자세한 내용은 할당량, 제한, 앱 등록, 인증서 및 구성 값을 참조하세요.

사전 요구 사항

사용자에게 응답할 올바른 토픽 선택

사용자에게 응답하는 방법을 결정하기 위해 에이전트는 생성형 오케스트레이션 또는 클래식 오케스트레이션을 사용합니다.

생성형 오케스트레이션을 통해 에이전트는 사용자 쿼리에 응답하거나 이벤트 트리거에 응답하는 데 사용할 토픽, 작업 및 지식의 가장 적절한 조합을 결정합니다. 각 토픽에는 에이전트에게 용도를 알려주는 설명이 있습니다. 설명 작성에 대해 자세히 알아보세요.

클래식 오케스트레이션을 사용하도록 구성된 에이전트에서 각 토픽에는 트리거 문구 세트가 있습니다. 트리거 구문은 고객이 특정 문제와 관련된 질의에 사용할 가능성이 높은 구문, 키워드 및 질문입니다. 이러한 에이전트는 자연어 이해, 고객의 메시지, 토픽의 트리거 문구를 사용하여 트리거에 가장 적합한 토픽을 찾습니다. 토픽을 트리거하기 위해 고객 입력이 토픽 트리거 문구와 정확히 일치할 필요는 없습니다. 예를 들어 매장 영업시간에 대한 토픽에는 "매장 영업시간 확인"이라는 트리거 문구가 있을 수 있습니다. 고객이 "매장 영업시간 보기"를 입력하면 이 문구가 매장 영업시간 토픽을 트리거합니다. 트리거 문구 작성에 대해 자세히 알아보세요.

Copilot Studio의 토픽

에이전트는 두 가지 유형의 토픽(시스템 토픽 및 사용자 지정 토픽)을 가질 수 있습니다. 모든 새 에이전트는 미리 정의된 시스템 및 사용자 지정 주제 집합으로 시작합니다.

  • 시스템 토픽은 사람과 대화하거나 대화를 종료하라는 사용자 지정 요청과 같은 필수 동작을 지원합니다. 일부 시스템 토픽에는 에이전트의 필요에 맞게 사용자 지정할 수 있는 트리거 문구가 있습니다.

    • 시스템 토픽을 만들 수 없습니다.
    • 시스템 토픽은 삭제할 수 없지만 비활성화할 수는 있습니다.
    • 시스템 토픽을 변경할 수 있습니다. 그러나 완전한 에이전트 경험을 만드는 데 익숙해질 때까지는 시스템 토픽을 편집하지 않는 것이 좋습니다.

    자세한 내용은 시스템 토픽 사용을 참조하세요.

  • 사전 정의된 사용자 지정 토픽은 고객에게 인사하기, 대화 종료하기, 대화 다시 시작하기 등의 일반적인 동작을 다룹니다.

    • 사전 정의된 사용자 지정 토픽을 변경하거나 에이전트에서 완전히 제거할 수 있습니다.
    • 만드는 모든 토픽은 사용자 지정 토픽입니다.

노드 유형

이용할 수 있는 노드 유형은 다음과 같습니다.

노드 유형 설명
메시지 노드 고객에게 메시지를 보냅니다.
질문 노드 고객에게 질문합니다.
적응형 카드 노드 다른 앱과 교환할 JSON 코드 조각을 만듭니다.
조건 노드 조건에 따라 대화를 분기하니다.
변수 관리 노드 값을 설정하거나, 값을 구문 분석하거나, 변수를 지웁니다(에이전트가 사용한 대화 기록을 지우는 기능 포함).
토픽 관리 대화를 리디렉션하거나, 사용자를 이전하거나, 토픽 또는 대화를 종료합니다.
도구 호출 노드 Power Automate나 Excel Online과 같은 흐름을 호출하거나 커넥터나 다른 유형의 도구를 사용합니다.
고급 생성형 답변, HTTP 요청, 이벤트 등을 보냅니다.

식별하기 쉽도록 노드 이름을 바꾸세요. 노드의 이름 필드를 선택하여 이름을 직접 업데이트하거나, 노드의 더보기 아이콘()을 선택하고 메뉴에서 이름 바꾸기를 선택합니다. 코드 편집기에서 노드 이름을 바꿀 수도 있습니다.

트리거 노드와 단계로 이동 노드의 이름을 바꾸는 것은 불가능합니다.

노드 이름은 최대 500자까지 가능합니다.

토픽 만들기

  1. 에이전트에 대한 주제 페이지로 이동합니다. 더 잘 보이도록 지금은 테스트 패널을 닫습니다.

  2. 토픽 추가를 선택하고 공백에서를 선택합니다.

    트리거 노드는 비어 있는 토픽 제작 캔버스에 나타납니다.

  3. 트리거 노드의 추가 아이콘()을 선택한 다음 속성을 선택합니다. 인식된 의도 속성 패널이 나타납니다.

  4. 인식된 의도 속성에서 구문 영역을 선택합니다. 문구 보조 패널이 나타납니다.

  5. 문구 추가에서 토픽에 대한 트리거 문구를 입력하세요.

    에이전트는 AI가 고객의 응답을 이해하도록 훈련하기 위해 5~10개의 트리거 문구가 필요합니다. 더 많은 트리거 문구를 추가하려면 다음 중 하나를 수행하세요.

    • 텍스트 필드 옆에 있는 추가 아이콘 을 선택하고 원하는 문구를 입력하세요.
    • 트리거 문구 세트를 각각 별도의 줄에 붙여넣고 Enter를 선택합니다.
    • 트리거 문구 세트를 입력하고 각 문구 다음에 Shift+Enter를 눌러 별도의 줄에 배치한 다음 Enter를 선택합니다.
    • 이 주제에 추가하려는 트리거 문구를 나열하는 파일을 업로드합니다.

    트리거 문구에 문장 부호를 포함시킬 수 있지만 긴 문장보다는 짧은 문구를 사용하는 것이 가장 좋습니다.

  6. 도구 모음에서 세부 정보을 선택하여 토픽 세부 정보 패널을 엽니다.

  7. 토픽에 대한 세부 정보를 추가합니다.

    • "토픽"을 식별할 수 있는 이름(예: '매장 영업 시간')을 입력합니다. 토픽 페이지에는 에이전트에서 정의된 모든 토픽이 이 이름으로 나열됩니다.
    • 원하는 경우, 에이전트가 고객의 메시지와 일치하는 토픽을 확인할 수 없을 때 고객에게 표시할 이름을 입력합니다.
    • 필요한 경우 설명 필드를 사용하여 본인과 팀의 다른 에이전트 제작자를 위해 토픽의 목적을 설명합니다. 고객은 토픽 설명을 볼 수 없습니다.
  8. 토픽을 저장하려면 상단 메뉴바에서 저장을 선택하세요.

중요

토픽 이름에 마침표(.)를 사용하지 마세요. 토픽 이름에 마침표가 있는 에이전트가 포함된 솔루션은 내보낼 수 없습니다.

주제에 대한 트리거 문구 업로드

토픽의 트리거 노드의 문구 패널에서 토픽과 연결된 트리거 문구 세트를 추가하거나 교체할 수 있습니다.

  1. 토픽에 추가하려는 모든 트리거 문구를 각 문구를 별도의 줄에 나열하는 텍스트 파일(최대 3MB)을 준비합니다.

  2. 문구 추가에서 파일 업로드를 선택합니다.

  3. 파일 업로드에서 원하는 옵션을 선택합니다.

    • 토픽에 대한 새로운 트리거 문구를 추가하려면 추가를 선택합니다.
    • 모든 기존 트리거 문구를 파일의 목록으로 바꾸려면 Replace를 선택합니다.
  4. 파일을 창에 놓습니다. 또는 클릭하여 찾아보기를 선택한 후 파일을 찾아 선택합니다.

  5. 표시되는 트리거 문구를 검토하고 추가를 선택합니다.

  6. 토픽을 저장합니다.

주제에 대한 트리거 문구 다운로드

토픽의 트리거 노드의 문구 패널에서 토픽과 연결된 트리거 문구 세트를 다운로드할 수 있습니다.

  1. 문구 추가에서 다운로드를 선택합니다.

  2. 결과 텍스트 파일을 저장하거나 텍스트 편집기에서 열어 내용을 검토합니다. 각 트리거 문구는 별도의 줄에 나타납니다.

토픽 대화 경로 디자인

토픽을 생성하면 제작 캔버스에 트리거 노드가 자동으로 나타납니다. 그런 다음 다양한 유형의 노드를 추가하여 토픽에 대해 원하는 대화 경로를 얻을 수 있습니다.

토픽 제작 캔버스에서 다른 노드 뒤 또는 두 노드 사이에 노드를 추가하려면 다음을 수행하세요.

  1. 새 노드를 추가하려는 노드 아래에 있는 노드 추가 아이콘 을 선택합니다.

  2. 나타나는 목록에서 원하는 노드 유형을 선택합니다.

    트리거 노드 뒤에 노드를 삽입하기 위해 선택할 수 있는 옵션의 스크린샷.

노드 삭제

삭제하려는 노드의 더 보기 아이콘()을 선택한 후 삭제를 선택합니다.

캔버스에서 노드 편집을 위한 컨트롤

도구 모음의 컨트롤을 사용하여 선택한 노드 또는 선택한 인접 노드를 잘라내기, 복사, 붙여넣기 및 삭제할 수 있습니다.

도구 모음에는 편집을 실행 취소할 수 있는 컨트롤도 있습니다. 실행 취소 아이콘 을 선택하고 다음을 선택합니다.

  • 가장 최근 변경 내용을 실행 취소하려면 실행 취소
  • 마지막 저장을 실행 취소 하여 모든 작업을 마지막 저장으로 되돌리기
  • 이전 작업을 다시 실행하기 위해 다시 실행

노드 붙여넣기

잘라내기 또는 복사 도구를 사용하여 하나 이상의 노드를 클립보드에 배치한 후 이를 캔버스에 붙여넣는 두 가지 방법이 있습니다.

  • 노드를 선택한 후 붙여넣기를 선택하면 선택한 노드 뒤에 클립보드의 노드가 삽입됩니다.

  • + 메뉴를 보려면 ""를 선택하고 붙여넣기를 선택하면 클립보드의 노드가 해당 위치에 삽입됩니다.

토픽에 대한 입력 및 출력 매개 변수 추가

토픽에는 입력 및 출력 매개 변수가 있을 수 있습니다. 토픽이 다른 토픽으로 리디렉션되면 이러한 매개 변수를 사용하여 토픽 간에 정보를 전달할 수 있습니다.

또한 에이전트가 생성형 모드를 사용하면 대화 컨텍스트에서 토픽 입력을 자동으로 채우거나 질문을 생성한 후 사용자로부터 값을 수집할 수 있습니다. 이 동작은 생성형 슬롯 채우기가 작업에 작동하는 방식과 유사합니다.

토픽의 입력 및 출력 매개 변수에 대해 자세히 알아보려면 토픽 입력 및 출력 관리를 참조하세요.

코드 편집기로 토픽 편집

코드 편집기는 읽고 이해하기 쉬운 마크업 언어인 YAML로 토픽을 보여줍니다. 코드 편집기를 사용하여 다른 작성자가 만든 항목을 포함하여 다른 봇의 항목을 복사하여 붙여넣습니다.

중요

코드 편집기에서 토픽 완전히 디자인하고 복잡한 토픽을 붙여넣는 것은 완전히 지원되지 않습니다.

이 예에서는 YAML을 복사하여 코드 편집기에 붙여넣어 고객에게 배송 정보를 묻는 토픽을 빠르게 추가합니다.

  1. 항목 페이지에서빈 항목에서> 추가를 선택합니다.

  2. 작성 캔버스의 오른쪽 상단에서 더 보기를 선택한 다음 코드 편집기 열기를 선택하세요.

    토픽에 대한 코드 편집기를 여는 방법의 스크린샷.

  3. 코드 편집기의 내용을 선택하고 삭제합니다. 그런 뒤 다음 YAML 코드를 복사하여 붙여넣습니다.

    kind: AdaptiveDialog
    beginDialog:
      kind: OnRecognizedIntent
      id: main
      intent:
        displayName: Lesson 3 - A topic with a condition, variables and a prebuilt entity
        triggerQueries:
          - Buy items
          - Buy online
          - Buy product
          - Purchase item
          - Order product
    
      actions:
        - kind: SendMessage
          id: Sjghab
          message: I am happy to help you place your order.
    
        - kind: Question
          id: eRH3BJ
          alwaysPrompt: false
          variable: init:Topic.State
          prompt: To what state will you be shipping?
          entity: StatePrebuiltEntity
    
        - kind: ConditionGroup
          id: sEzulE
          conditions:
            - id: pbR5LO
              condition: =Topic.State = "California" || Topic.State = "Washington" || Topic.State     = "Oregon"
    
          elseActions:
            - kind: SendMessage
              id: X7BFUC
              message: There will be an additional shipping charge of $27.50.
    
            - kind: Question
              id: 6lyBi8
              alwaysPrompt: false
              variable: init:Topic.ShippingRateAccepted
              prompt: Is that acceptable?
              entity: BooleanPrebuiltEntity
    
            - kind: ConditionGroup
              id: 9BR57P
              conditions:
                - id: BW47C4
                  condition: =Topic.ShippingRateAccepted = true
    
              elseActions:
                - kind: SendMessage
                  id: LMwySU
                  message: Thank you and please come again.
    
  4. 저장을 선택한 다음 코드 편집기 닫기를 선택합니다. 질문 노드에 따라 오는 조건부 논리에 주목하십시오.

     Copilot Studio 코드 편집기에서 YAML로 생성된 대화의 스크린샷.

에이전트 테스트 및 게시

토픽에 변경 사항을 적용했으면 에이전트를 테스트하여 모든 것이 예상대로 작동하는지 확인합니다.

만족하면 원하는 채널에 에이전트를 게시하세요.