AI Forge

다크 모드

Output 노드 ​

Output은 이전 노드의 값을 선택해 워크플로우의 최종 응답 객체로 조립하는 종료 노드입니다. 반환할 필드 이름과 원본 값을 각각 연결할 수 있습니다.

언제 사용하나요? ​

  • 워크플로우 실행 결과로 반환할 값을 정할 때
  • 여러 노드의 결과를 하나의 응답 객체로 묶을 때
  • 내부 처리 결과 중 호출자에게 필요한 필드만 노출할 때

입력 ​

Output 변수마다 같은 실행 범위에 있는 이전 노드의 출력 필드 하나를 원본으로 선택합니다. 값을 직접 입력하는 기능은 없으므로 고정 문구나 여러 값을 조합하려면 먼저 Template, Transform, Code 같은 노드에서 결과를 만드세요.

예를 들어 SUMMARY.answer와 SEARCH.documents를 각각 선택해 최종 응답에 포함할 수 있습니다.

주요 설정 ​

설정설명
이름캔버스와 실행 이력에 표시할 고유한 노드 이름입니다.
설명최종 응답이 무엇을 의미하는지 기록합니다.
출력 변수 이름최종 응답 객체에 사용할 키입니다. 비어 있거나 중복된 이름은 사용할 수 없습니다.
원본 변수이전 노드와 그 노드의 출력 필드 경로입니다. 실제로 존재하는 필드를 선택해야 합니다.

출력 변수 추가를 누른 뒤 왼쪽에는 반환할 이름을, 오른쪽에는 원본 변수를 지정합니다. 출력 변수는 필요한 만큼 추가하거나 삭제할 수 있습니다.

출력 ​

설정한 이름과 원본 값이 하나의 객체로 반환됩니다.

출력 변수 이름원본 변수
answerSUMMARY.answer
sourcesSEARCH.documents

검색 문서 항목의 일부 필드를 생략해 표시하면 최종 결과는 다음과 같은 형태입니다.

json
{
  "answer": "환불 신청은 구매 후 7일 이내에 가능합니다.",
  "sources": [
    {
      "title": "환불 정책",
      "score": 0.92
    }
  ]
}

출력 변수를 추가하지 않으면 최종 응답에 포함할 필드가 없습니다.

연결과 배치 제약 ​

  • 루트 워크플로우에는 Output 노드가 정확히 하나 있어야 합니다.
  • Output에는 나가는 연결 핸들이 없으며 실행 흐름의 마지막에 배치합니다.
  • Input에서 연결선을 따라 Output까지 도달할 수 있어야 하며, Output에는 이전 노드의 연결이 필요합니다.
  • 원본 변수는 Output과 같은 실행 범위에 있어야 합니다. Loop나 Iteration 내부 노드를 루트 Output에서 직접 참조할 수는 없으며, 해당 컨테이너가 외부로 제공하는 출력을 선택해야 합니다.
  • 원본 노드나 필드가 삭제되면 경고가 표시되고 워크플로우 검증에 실패합니다.
  • Output 변수는 개별 필드 경로를 선택해야 하며 원본 노드 전체를 그대로 선택할 수 없습니다.

예시 ​

Knowledge Base 답변 워크플로우라면 다음과 같이 구성할 수 있습니다.

  1. Retriever로 관련 문서를 검색합니다.
  2. LLM에서 검색 문서를 근거로 답변을 생성합니다.
  3. Output에 answer 변수를 추가하고 LLM.answer를 선택합니다.
  4. 출처도 반환하려면 sources 변수를 추가하고 RETRIEVER.documents를 선택합니다.
  5. 테스트 실행 결과가 의도한 키와 타입으로 반환되는지 확인합니다.

주의사항 ​

  • 같은 출력 변수 이름을 두 번 사용할 수 없습니다.
  • 원본 스키마가 변경되면 이전에 선택한 필드 경로가 사라질 수 있습니다. LLM 구조화 출력이나 Transform 매핑을 수정한 뒤 Output을 다시 확인하세요.
  • 내부 디버깅 정보, 토큰 사용량, 도구의 원본 응답처럼 호출자에게 필요 없는 값은 최종 출력에서 제외하세요.
  • 사람이 읽을 응답이 필요하다면 여러 원본 필드를 그대로 나열하기보다 Template로 먼저 정리하는 편이 좋습니다.

관련 노드 ​