M5-6. 에이전트에 워크플로 추가
한 줄 요약 — 게시된 워크플로를 에이전트의 도구(tool) 로 추가하면 오케스트레이터(orchestrator)가 런타임에 직접 호출합니다. 요건은 3가지 — “When an agent calls the flow” 트리거 + “Respond to the agent” 액션 + 게시(published) — 그리고 응답은 100초 액션 한도 안의 실시간이어야 합니다.
1. 도구가 되기 위한 요건
| 요건 | 내용 | 미충족 시 |
|---|---|---|
| When an agent calls the flow 트리거 | 에이전트 호출용 트리거 | 도구 목록에 미표시 |
| Respond to the agent 액션 | 에이전트에 결과 반환 (필수) | 도구 목록에 미표시 |
| 게시(publish) | 게시된 워크플로만 도구로 추가 가능 | 도구 목록에 미표시 |
| Asynchronous response = Off | “Respond to the agent” 설정 > Networking 아래 토글 | 실시간 응답 불가 — 비동기 응답은 지원 안 됨 |
| 100초 한도 | 에이전트 액션 응답 제한 시간(100-second action limit) | 응답 실패 — 흐름 로직·쿼리·반환 데이터양을 최적화해 일반 실행이 100초 미만이 되게 할 것 |
2. 에이전트에 추가하는 절차
- Copilot Studio에서 Agents 선택 → 워크플로를 추가할 에이전트 선택.
- Tools로 이동 → Add a tool 선택 → Add tool 패널 표시.
- Workflows 선택 → 도구로 사용 가능한 워크플로 목록 표시 (= 위 3요건을 갖춘 게시된 워크플로만).
- 원하는 워크플로 선택 → 도구로 추가되고 에이전트 도구 목록에 해당 워크플로 탭이 생깁니다.
3. 도구로서 구성 — Workflow details
- 도구 목록에서 워크플로 탭 선택 → Workflow details 패널 표시.
- Details 탭에서 워크플로 name / description 확인 — 이 이름·설명이 에이전트가 언제 이 도구를 쓸지 판단하는 근거입니다. 목적·기능을 명확히 서술하세요. 설명이 부실하면 오케스트레이터의 도구 선택 정확도가 떨어집니다.
- input parameters / output parameters 정보 확인.
- 필요 시 Save로 변경 저장.
4. 목록에 워크플로가 안 보일 때 — 점검 3가지
- 게시 되어 있는가?
- When an agent calls the flow 트리거가 있는가?
- Respond to the agent 액션이 있는가?
5. 설계 관점 — M5 전체 그림 마무리
이 세션으로 워크플로↔에이전트 양방향 연결이 완성됩니다.
- 워크플로 안의 에이전트(M5-2·M5-3·M5-4): 결정적 흐름 속 한 단계에 추론·분류를 위임.
- 에이전트 안의 워크플로(이번 세션): 에이전트의 추론 흐름 속에서 결정적 절차를 도구로 호출.
에이전트가 도구로 부르는 워크플로는 100초 안에 결과를 돌려줘야 하므로, 오래 걸리는 처리 (대량 조회, 사람 대기 등)는 도구용 워크플로에 넣지 말고 흐름을 짧게 유지하는 것이 핵심입니다.
핵심 정리
- 도구화 3요건 = 전용 트리거 + Respond to the agent + 게시 — 하나라도 없으면 목록에 안 보임.
- Asynchronous response는 Off(실시간 응답 필수), 100초 액션 한도는 하드 제약.
- Details 탭의 이름·설명이 오케스트레이터의 호출 판단 근거 — 명확하게 작성.
- 추가된 워크플로는 에이전트 도구 목록에 탭으로 나타나고 입력/출력 매개 변수를 확인할 수 있음.
(기능·화면·명칭은 프리뷰 기준 · subject to change)
M5 허브로 복귀 · 이전 ← M5-5. 인간 검토 요청 RFI · 처음부터 다시 → M5-1. 디자이너