AI Forge

다크 모드

워크플로우 ​

워크플로우는 여러 노드를 연결해 반복 작업을 자동화하는 Studio의 비주얼 빌더입니다. 만들어둔 워크플로우는 채팅에서 도구처럼 호출할 수 있습니다.

화면 예시 ​

Studio 워크플로우 화면

내 워크플로우와 공유된 워크플로우를 확인하고, 예제로 생성하거나 JSON 파일로 가져올 수 있습니다.

워크플로우 생성 ​

  1. 좌측 사이드바에서 워크플로우로 이동합니다.
  2. 워크플로우 생성을 선택합니다.
  3. 이름, 아이콘, 설명을 입력합니다.
  4. 공유 범위를 선택합니다.
  5. 생성된 워크플로우 편집 화면에서 노드를 추가하고 연결합니다.

워크플로우 이름과 설명은 AI가 도구 선택을 판단하는 데 사용됩니다. 채팅에서 어떤 상황에 호출해야 하는지 알 수 있도록 목적을 명확하게 작성하세요.

설계 순서 ​

워크플로우는 노드를 먼저 추가하기보다, 입력과 출력부터 정하면 만들기 쉽습니다.

  1. 목표 정의: 워크플로우가 끝났을 때 무엇을 반환해야 하는지 정합니다.
  2. 입력 정의: 채팅에서 받아야 할 값과 필수 여부를 정합니다.
  3. 단계 분해: 검색, 판단, 변환, 외부 호출, 응답 생성 단계로 나눕니다.
  4. 노드 선택: 각 단계에 맞는 노드를 배치합니다.
  5. 변수 연결: 이전 노드 출력이 다음 노드 입력으로 전달되는지 확인합니다.
  6. 예외 처리: 실패 가능성이 있는 단계에는 조건 분기나 재시도 전략을 둡니다.
  7. 게시 전 테스트: 예시 입력으로 실행해 최종 출력이 예상 형식과 일치하는지 확인합니다.

초안과 게시 ​

워크플로우는 초안과 게시 상태를 가집니다.

상태설명
초안편집할 수 있지만 채팅에서 사용할 수 없습니다.
게시채팅에서 도구로 사용할 수 있지만 편집이 제한됩니다.

수정이 필요하면 초안으로 전환해 편집한 뒤 다시 게시하세요.

노드 ​

워크플로우는 Input 노드에서 시작해 Output 노드로 결과를 반환합니다. 처리 과정에는 AI 모델, 외부 도구, 데이터 변환, 조건 분기와 반복 제어 노드를 조합할 수 있습니다.

분류노드
시작과 종료Input, Output
AI와 외부 연동LLM, Tool, Retriever, HTTP
데이터 처리와 분기Template, Code, Transform, Condition
반복과 흐름 제어Iteration, Loop, Variable Assigner, Exit Loop
캔버스 문서화Note

설정, 입출력, 연결 제약은 노드 레퍼런스에서 확인하세요.

노드 선택 기준 ​

해야 할 일추천 노드
사용자의 입력값 구조 정의Input
자연어 요약, 분류, 초안 작성LLM
외부 도구 호출Tool
내부 문서 검색Retriever
REST API 호출HTTP
계산, 정규화, 복잡한 변환Code
필드명 변경이나 단순 매핑Transform
조건별 처리Condition
배열 항목을 독립적으로 처리Iteration
이전 결과를 개선하며 반복Loop
이메일, 보고서, 메시지 생성Template
최종 응답 조립Output

변수 참조 ​

노드 설정에서 /를 입력하면 이전 노드의 출력 변수를 참조할 수 있습니다. 입력값, LLM 응답, 도구 결과를 다음 단계의 컨텍스트로 연결할 때 사용합니다.

구조화된 출력 ​

LLM 노드에서는 JSON 스키마를 정의해 구조화된 출력을 생성할 수 있습니다. 결과를 다음 노드에서 안정적으로 사용해야 하는 경우 구조화된 출력을 사용하세요.

  1. LLM 노드 설정에서 구조화된 출력을 활성화합니다.
  2. 출력 스키마를 직접 작성하거나 AI로 생성합니다.
  3. 다음 노드에서 해당 필드를 변수로 참조합니다.

가져오기와 내보내기 ​

워크플로우는 JSON 파일로 내보내거나 가져올 수 있습니다.

기능설명
내보내기워크플로우 구조를 JSON 파일로 다운로드합니다. API 키와 토큰 같은 민감 데이터는 마스킹됩니다.
가져오기JSON 파일에서 워크플로우를 복원합니다. 코드 노드가 포함된 경우 실행 전에 내용을 검토하세요.

주의

가져온 워크플로우에 마스킹된 값이 있으면 실행 전에 해당 값을 다시 입력해야 합니다.

채팅에서 실행하기 ​

게시된 워크플로우는 채팅 입력창에서 @를 입력해 선택할 수 있습니다. Input 노드에서 정의한 스키마에 따라 AI가 필요한 입력값을 구성하고 워크플로우를 실행합니다.

에이전트와 함께 사용하기 ​

워크플로우를 에이전트에 연결하면 사용자는 에이전트를 호출하는 것만으로 정해진 절차를 실행할 수 있습니다.

상황권장 구성
절차는 고정되어 있고 설명이 필요한 경우워크플로우가 실행을 담당하고, 에이전트가 결과를 해석합니다.
여러 워크플로우 중 선택해야 하는 경우에이전트 지침에 각 워크플로우의 사용 조건을 적습니다.
외부 시스템 변경 작업이 포함된 경우에이전트 지침에 실행 전 확인 절차를 넣고, 채팅 도구 모드를 수동으로 둡니다.
팀 공통 업무로 배포하는 경우워크플로우 게시 상태, 공유 범위, 연결된 MCP 권한을 함께 확인합니다.

게시 전 체크리스트 ​

항목확인 내용
이름과 설명채팅에서 어떤 상황에 사용할지 분명하게 드러나나요?
입력 스키마필수 입력과 선택 입력이 구분되어 있나요?
변수 연결이전 노드 출력이 다음 노드에서 올바르게 참조되나요?
실패 처리외부 API 오류, 검색 결과 없음, 빈 입력을 처리하나요?
출력 형식채팅에서 읽기 쉬운 최종 결과로 반환되나요?
민감 정보내보내기 전 API 키, 토큰, 내부 URL이 남아 있지 않나요?

관련 문서 ​