CanRobot · 캔로봇
Microsoft Frontier Transformation Engineer TITAN Microsoft Certified Trainer Microsoft MVP 2025

M5-5. 에이전트에서 플로우 호출 — 도구로 추가

한 줄 요약 — 4가지 사전 조건을 갖춘 게시된 플로우를 에이전트 레벨(Tools) 또는 토픽 레벨에 추가하고 이름·설명·입력·완료 동작을 구성하면, 오케스트레이터가 런타임에 플로우를 호출합니다. 설명이 곧 호출 조건입니다.

1. 사전 조건 — 4가지

플로우가 다음을 모두 만족해야 Add a tool → Flow 목록에 표시됩니다 (M5-4):

# 조건
1 When an agent calls the flow 트리거 + Respond to the agent 작업
2 게시(Published) 상태
3 실시간 응답 — Respond to the agent 설정의 Networking 아래 Asynchronous response 토글 = Off
4 100초 action limit 내 응답 — 플로우 로직·쿼리·반환 데이터량을 최적화

목록에 플로우가 보이지 않으면 위 4가지를 순서대로 점검하세요.

2. 에이전트 레벨 도구로 추가 — 오케스트레이터가 직접 호출

  1. 왼쪽 창 Agents → 플로우를 붙일 에이전트 선택
  2. Tools 페이지 → Add a tool
  3. Flow 선택 — 게시된 플로우 목록 표시
  4. 원하는 플로우 선택 → Add and configure
  5. 구성 패널에서:
    • Name·Description — 표시 이름과, 오케스트레이터가 언제 쓸지 판단할 명확한 설명
    • Inputs — 각 입력 변수를 채우는 방식 선택 (대화에서 자동 / 고정값)
    • Completion — 도구 실행 후 동작 선택
  6. Save

플로우 도구 구성 패널 화면 구성 예시 — 실제 화면·명칭은 버전에 따라 다를 수 있습니다

3. 토픽 레벨로 추가 — 그 토픽에서만 사용

에이전트 레벨 도구는 오케스트레이터가 런타임에 직접 호출하고, 토픽 레벨 도구는 해당 토픽 안에서만 쓰입니다.

  1. 왼쪽 창 Agents → 에이전트 선택
  2. Topics 페이지 → 플로우를 붙일 토픽 선택
  3. 아무 노드 아래의 Add node(＋) 아이콘 → Add a tool
  4. 추가할 플로우 선택 → 토픽에 새 Action 노드가 생성됩니다

에이전트 레벨 vs 토픽 레벨 추가 경로

4. 테스트

  1. Test your agent 패널에서 플로우를 트리거할 대화 시작 — 예: “다음 주 월요일부터 연차 접수해줘”
  2. 에이전트가 플로우를 호출하고 예상 출력을 반환하는지 확인
  3. 입력 슬롯이 비면 — 자동 생성 질문으로 채우는지 확인

5. 호출 경로 두 갈래

경로 방식 용량 계산
생성형 오케스트레이션 설명 기반으로 오케스트레이터가 선택 호출 Autonomous action 1 + 작업 수
토픽에서 명시 호출 토픽 캔버스의 Action 노드로 고정 호출 (3절) Classic answer 1 + 작업 수

두 호출 경로 비교

정형 구간(반드시 이 시점에 실행)은 토픽 명시 호출, 자유 대화에서의 온디맨드는 생성형 선택 호출이 적합합니다.

6. 문제 해결

  • Add a tool → Flow 목록에 플로우가 없으면 — 1절의 4가지 사전 조건(트리거·응답 작업 / 게시 / Asynchronous response Off / 100초 내 응답)을 순서대로 점검
  • 도구·플로우를 바꾸면 항상 재테스트 — 대화 중 문제 시 에이전트가 오류 메시지(코드 포함)로 응답
  • 플로우 관련 문제 대부분은 Flow checker에서 발견됩니다
  • 호출이 안 되면 — 도구 설명·입력 정의·플로우 게시 상태를 순서대로 확인

핵심 정리

  1. 사전 조건 4가지 — 트리거·응답 작업 / 게시 / Asynchronous response Off / 100초 내 응답 — 하나라도 빠지면 도구 목록에 나타나지 않습니다
  2. 추가 경로 두 가지 — 에이전트 레벨(Tools → Add a tool → Flow) · 토픽 레벨(Topics → 토픽 → Add node → Add a tool)
  3. 설명이 호출 조건 — “언제 쓰는지 + 무엇을 반환하는지”를 담으세요
  4. 정형은 토픽 명시 호출, 온디맨드는 생성형 선택 호출 — 경로별 용량 계산도 다릅니다

M5 에이전트 플로우로 · 다음: M5-6. 트리거·모니터링·용량

출처: Call an agent flow from an agent (MS Learn) · Add an agent flow to an agent (MS Learn)