메모
이 글의 기능들은 GitHub Copilot 하네스를 기반으로 한 에이전트나 워크플로우에서 사용됩니다.
사용량 기반 청구는 에이전트를 사용, 구축, 테스트, 평가하는 데 적용됩니다. 이러한 행동은 Copilot 크레딧을 소모할 수 있습니다. GitHub Copilot 하네스로 구동되는 에이전트 비용 관리에서 더 알아보세요.
Copilot Studio에서 새롭게 디자인된 비주얼 디자이너에서 워크플로우를 생성하고 편집할 수 있습니다. 디자이너는 디자이너를 벗어나지 않고도 자동화를 빌드하거나 편집하고, 작업을 추가하거나 제거하며, 오류를 확인하고, 워크플로를 게시할 수 있는 캔버스를 제공합니다.
디자이너에서 워크플로우를 표시하세요
디자이너에서 워크플로우를 표시하려면 Copilot Studio를 열고 워크플로우를 선택한 후 빌드 탭을 선택하세요.
워크플로우 표시 방식을 바꾸세요
워크플로의 크기와 복잡성에 따라 더 쉽게 작업할 수 있도록 표시 방식을 조정하는 것이 좋습니다. 캔버스 왼쪽 하단 구석에 있는 툴바를 사용해 뷰를 조절하세요.
스크린샷은 Copilot Studio 디자이너의 보기 옵션 툴바이며, 설명선은 1부터 6까지 번호가 매겨져 있습니다.
범례:
- 확대: 캔버스에서 워크플로의 크기를 늘립니다.
- 축소: 캔버스에서 워크플로의 크기를 줄입니다.
- 보기 맞춤: 캔버스의 전체 워크플로에 맞게 보기 크기를 조정합니다.
- 정리: 보다 깔끔한 엔드 투 엔드 뷰를 위해 워크플로 및 분기를 다시 구성합니다.
- 세로 레이아웃: 워크플로의 세로 레이아웃 보기로 전환합니다.
작업 추가 및 제거
작업을 추가하려는 카드에서 단계 추가를 선택합니다. 추가 창이 열립니다.
추가( Add) 아래에서 워크플로우가 수행하고 싶은 액션이나 추가하고 싶은 커넥터를 입력한 뒤, 목록에서 선택하세요. 선택에 따라 행동을 완료하기 위해 더 많은 정보를 제공해야 할 수도 있습니다.
행동이 필요 없다고 판단되면, 행동 오른쪽 상단의 삭제 아이콘을 선택하세요.
워크플로우 파라미터 확인
워크플로에서 트리거 또는 작업에 대한 매개 변수를 보려면 해당 카드를 선택합니다. 구성 패널이 오른쪽에 열립니다. 매개변수의 값을 입력하려면 드롭다운 리스트에서 옵션을 선택하거나 표현식을 입력하여 값을 동적으로 설정합니다.
오류 확인
워크플로 작업의 오류는 빨간색으로 표시됩니다. 한 작업에서 오류의 세부 정보를 보려면 오류를 선택합니다. 전체 워크플로우의 모든 오류를 나열하려면 보건소 배너를 열어보세요. 개별 오류에 대한 세부 정보를 보려면 오류를 선택합니다.
중요합니다
오류가 포함된 워크플로우는 게시할 수 없습니다. 출판하기 전에 모든 오류를 수정해야 합니다.
워크플로 게시
워크플로에 오류가 없는 경우 게시할 수 있습니다. 캔버스 상단 메뉴에서 게시를 선택하세요.
워크플로 테스트
테스트 런은 디자이너를 떠나지 않고도 한 단계나 전체 워크플로우를 검증할 수 있게 해줍니다. 실제 업스트림 데이터, 스스로 모의한 값, 이전 실행의 출력을 사용하세요.
테스트를 실행하는 방법에는 두 가지가 있습니다.
| 확인하려는 항목 | 테스트 방법 | 찾는 위치 |
|---|---|---|
| 독립된 단일 작업 또는 AI 단계 | 이 노드 테스트 | 노드 측면 패널 안의 테스트 탭 |
| 전체 워크플로우, 엔드투엔드 | 흐름 테스트 실행 | 상단 명령바의 재생 버튼(테스트) |
두 표면 모두 입력(실제 또는 모의)을 제공하고, 실행한 다음, 출력을 검사하는 것과 동일한 아이디어를 공유합니다.
워크플로에서 단일 노드 테스트
워크플로우에서 아무 동작이나 노드나 열어도 플레이 버튼(테스트)을 선택하세요. 여기에는 다음 3개의 섹션이 있습니다.
테스트 실행/다시 설정: 요청 시 단계를 실행하거나 현재 입력 및 출력을 지웁니다.
이전 실행 부하 값: 최근 실행 중인 워크플로우의 드롭다운입니다. 하나를 선택하면 아래 입력 필드로 실행되는 업스트림 단계 출력을 가져옵니다.
입력: 업스트림 단계당 하나의 편집 가능한 필드가 노드 참조를 출력합니다. 각 행 오른쪽의 배지는 해당 필드의 예상 유형(문자열, 이메일, 날짜-시간, 숫자 등)을 보여줍니다.
출력: 가장 최근 테스트의 실시간 결과로, 노드 유형에 맞게 포맷된 결과입니다.
모의 입력
기본적으로 입력 필드는 비어 있습니다. 다음을 할 수 있습니다:
- 필드에 직접 값을 입력합니다. 필드는 오른쪽 배지에 표시된 형식을 허용합니다.
- 단계가 특정 필드를 필요로 하지 않는 경우 그 필드를 비워 두십시오.
Tip
테스트 탭은 이 노드의 표현식이 참조하는 업스트림 단계 출력을 자동으로 나열합니다. 노드에 새 토큰을 추가하면, 다음에 Test를 열 때 해당 필드가 나타납니다.
이전 실행에서 값 로드
만약 작업 흐름이 이전에 실행되었다면, 입력하는 대신 실제 데이터를 재생할 수 있습니다:
이전 실행의 값을 로드하는 드롭다운에서 실행을 선택합니다.
디자이너는 실행의 단계 출력을 가져오고 노드의 입력 스키마를 통해 프로젝션합니다. 일치하는 값은 입력 필드에 기록됩니다.
시나리오를 조정하려는 경우 나중에 필드를 편집합니다.
드롭다운에는 모든 상태의 가장 최근 실행 10개가 표시됩니다. 만약 런에 상위 단계 중 하나의 출력이 포함되어 있지 않다면, 그 단계를 건너뛰거나 경로가 선택되지 않았기 때문에, 사용 가능한 필드만 채워집니다. 나머지는 그대로 남아 있다.
만약 그 워크플로우가 이전에 실행되지 않았다면, 이전 실행 기록이 표시되지 않고 드롭다운이 숨겨집니다.
테스트를 실행하세요
테스트 실행을 선택합니다. 버튼은 호출이 진행 중인 동안 처리 중 상태를 표시하며, Output 섹션에는 스피너가 표시된 다음 결과 또는 오류가 표시됩니다.
- 다시 설정 테스트 는 입력과 마지막 출력을 모두 지웁니다.
- 테스트는 커넥터의 API에 대해 격리된 노드를 실행합니다. 테스트가 나머지 워크플로우를 트리거하지 않습니다.
전체 워크플로우를 테스트해 보세요
위쪽 명령 모음에서 재생 단추(테스트)를 선택합니다. Test는 실제 런타임에서 워크플로를 엔드 투 엔드로 실행합니다.
실행이 시작되기 전에 디자이너는 다음을 수행합니다.
- 저장하지 않은 변경 사항이 있거나 처음 하는 경우에는 워크플로우를 저장하고 게시합니다.
- 처음 실행할 때 새 연결을 설치합니다.
- 실행을 트리거합니다. 경로는 트리거 유형에 따라 달라집니다.
| 트리거 유형 | 테스트를 선택하면 어떻게 되나요? |
|---|---|
| 수동/HTTP 요청 | 트리거 입력을 입력하는 대화 창이 열리고, 워크플로우가 바로 실행됩니다. |
| 되풀이/슬라이딩 윈도우/폴링 | 일정이 시작되면 첫 번째 실행이 자동으로 시작되거나, 이미 설치되어 있다면 워크플로우가 한 번 실행됩니다. |
| 커넥터 이벤트(예: 이메일이 도착하는 경우) | 워크플로우는 게시되고 기다립니다. 트리거를 기다리는 중...이 표시됩니다. 실행이 시작되도록 소스 시스템에서 작업을 수행하세요. |
| HTTP 웹후크 | 워크플로우는 공개됩니다; 평소처럼 외부 시스템에서 트리거하세요. |
모의 입력(수동 트리거)
수동 트리거의 경우, Enter 수동 트리거 입력 대화상자가 트리거에 정의한 입력마다 하나의 필드를 렌더링합니다:
- 텍스트/숫자/전자 메일/날짜: 적절한 입력 컨트롤입니다.
- Boolean: 토글 스위치
- 단일 선택(열거형): 드롭다운.
- 다중 선택: 멀티셀렉트 드롭다운.
- 파일: 파일 선택기. 이 내용은 실행 과정의 일부로 업로드됩니다.
- 개체/배열: JSON을 붙여 넣을 수 있는 여러 줄 텍스트 영역입니다.
해당 입력으로 워크플로우를 시작하려면 Run 을 선택하거나, 실행 없이 해제하려면 Cancel 을 선택하세요. 필수 필드는 별표로 표시됩니다. 값이 없거나 유효하지 않은 경우 인라인 유효성 검사 메시지가 표시되고 실행이 수정될 때까지 차단됩니다.
이 대화는 Test를 선택할 때마다 나타납니다. 실행 사이에 값이 저장되지 않으므로 다른 시나리오를 빠르게 시도할 수 있습니다.
실행 결과 보기
실행이 진행 중이면 다음을 수행합니다.
- 실행이 활성 상태인 동안 명령 모음에 취소 단추가 표시됩니다.
- 오른쪽 활동 패널에는 현재 실행 중이 상단에 표시되어 있으며, 상태 배지가 있습니다: 달리기, 대기, 성공, 실패, 취소. 모든 실행을 선택하여 캔버스에서 열고 각 단계의 입력 및 출력을 검사합니다.
이전 실행 선택
활동 패널은 워크플로우의 실행 이력도 겸합니다:
- 상단의 드롭다운을 이용해 모두/성공/실패/실행 중으로 필터링하세요.
- 새로 고침을 선택하여 목록을 다시 추가합니다.
- 아래쪽에서 추가 로드 를 선택하여 다시 페이지 뒤로 이동하세요.
- 실행을 선택하면 캔버스에 로드됩니다. 여기서 각 노드는 수신한 입력과 해당 실행에 대해 생성된 출력을 표시합니다. 데이터는 드롭다운에서 실행을 선택할 때 노드 수준 테스트 탭에서 사용하는 것과 동일합니다.
각 유형의 테스트를 사용해야 하는 경우
- AI 단일 단계나 커넥터 액션을 반복하는 건가요? 이 노드를 테스트를 사용하세요. 더 빠르고, 게시하지 않으며, 중요한 상류 값만 모킹할 수 있습니다.
- 엔드 투 엔드 행동이나 트리거 논리를 검증하는 방법? 런 플로우 테스트를 사용하세요. 전체 그래프를 실제 실행 시간과 비교해 계산합니다.
- 프로덕션 이슈를 재현해야 하나요? Activity 패널에서 실패한 실행을 열고, 실패한 노드를 열어 이전 실행 실행 값을 테스트 탭에서 사용해 정확한 업스트림 데이터를 다시 실행에 반영하세요.
토큰 선택기의 샘플 값
상위 단계의 출력을 참조하는 표현식을 작성하면, 토큰 선택기가 각 토큰 옆에 샘플 값을 표시해 해당 단계의 실제 데이터가 어떻게 보이는지 볼 수 있습니다. 샘플 값은 워크플로우의 가장 최근 완료된 테스트 런에서 자동으로 추출되므로, 직접 실행을 선택하거나 토큰을 추가할 필요가 없습니다.
행동은 다음과 같습니다:
- 샘플 값은 각 업스트림 단계의 출력에 대해 행에 인라인으로 표시됩니다.
- 가장 최근 완료된 런에서 성공한 결과만 표시됩니다. 건너뛰었거나 도달하지 못했거나 실패한 단계들은 샘플 값이 없습니다.
- 워크플로우가 아직 실행되지 않았거나, 최근 실행에 참조된 단계가 포함되어 있지 않으면, 그 토큰 옆에 샘플 값이 나타나지 않습니다.
샘플 값은 읽기 전용 미리보기 데이터입니다. 표현식을 편집해도 기본 런이 바뀌지 않고, 피커를 닫아도 아무것도 버리지 않습니다.