API 노드는 외부 API를 호출하여 데이터를 가져오거나 전송하는 데 사용됩니다. 이 노드를 통해 에이전트는 외부 시스템과 통신하여 다양한 기능을 수행할 수 있습니다.

API 구성

API 노드에서는 다음과 같은 API 세부 정보를 구성할 수 있습니다:

  • HTTP 메소드: GET, POST, PUT, DELETE 등 HTTP 요청 메소드를 선택합니다.
  • URL: API 엔드포인트 URL을 입력합니다(예: https://api.example.com).
  • 인증(Authorization): API 호출에 필요한 인증 정보를 설정합니다.
  • 헤더(Headers): 요청에 포함할 헤더를 추가합니다.
  • 본문(Body): 요청 본문을 설정합니다.
    • {{variableName}} 형식으로 동적변수를 사용할 수 있습니다.
    • JSON 형식의 데이터를 입력할 수 있습니다(예: { 'key': 'value' }).
  • 응답 타임아웃: API 응답 대기 시간(초)을 설정합니다.

전환 조건

API 노드는 다음과 같은 상황에서 전환이 발생할 수 있습니다:

  • 성공적인 API 호출 이후: 사용자가 정의한 조건에 따라 다음 노드로 전환합니다.

    • 예: status == 200 그리고 product_type == 티셔츠 인 경우
    • 예: status == 200 그리고 product_type == 반바지 인 경우
  • 요청 실패 시: API 호출중 오류가 발생한 경우 자동으로 “요청 실패 시” 전환 조건을 통해 지정된 노드로 이동합니다.

지시사항 작성

API 호출을 진행하는 동안 에이전트가 어떤 말을 할 것인지 설정할 수 있습니다:

동적 프롬프트

에이전트가 동적으로 대화 내용을 생성할 수 있도록 프롬프트를 작성합니다.

정적 프롬프트

에이전트가 말할 고정된 문장을 설정합니다.

없음

API 호출 중에 에이전트가 아무 말도 하지 않습니다.