For the complete documentation index, see llms.txt. This page is also available as Markdown.

커넥티드 콘텐츠 FAQ

커넥티드 콘텐츠 설정과 응답 처리에 관한 자주 묻는 질문입니다.

커넥티드 콘텐츠를 설정하고 사용할 때 자주 묻는 질문입니다.

한 메시지에 connected_content를 여러 번 써도 되나요?

가능합니다. 단, 한 메시지의 모든 connected_content 호출은 누적 2초의 시간 예산을 공유합니다. 첫 번째 호출이 1.8초 걸렸다면 두 번째 호출은 0.2초 안에 끝나야 합니다. 한도를 초과하면 이후 호출은 네트워크 호출 없이 즉시 스킵됩니다. 외부 API의 평균 응답시간이 충분히 짧을 때만 다중 호출을 사용하세요.


응답을 받기 전에 발송 시간이 오래 걸리진 않나요?

각 호출은 최대 2초 안에 종료됩니다. 한 메시지의 누적 한도도 2초입니다. 발송 지연이 무한정 누적되지 않습니다.


응답이 JSON 배열일 때는 어떻게 접근하나요?

최상위가 배열이면 객체로 인식되지 않아 빈 값이 됩니다. API가 {"items":[...]}처럼 객체로 감싼 응답을 반환하도록 하세요. 래핑 엔드포인트를 따로 둘 수도 있습니다.


JSON이 아닌 응답(예: 단순 텍스트, HTML)도 사용할 수 있나요?

지원하지 않습니다. JSON 객체로 파싱되지 않으면 빈 값으로 처리됩니다.


응답을 메시지에 직접 노출하지 않고 조건 분기에만 쓰고 싶어요.

:save 변수를 {% if %} 등에서 그대로 사용할 수 있습니다. 메시지 본문에 출력할 필요는 없습니다. 실패 시 동작의 예시를 참고하세요.


키에 한글, 공백, 점이 들어 있는 응답 필드는 어떻게 꺼내나요?

{{var["키 이름"]}} 형태의 bracket subscript를 사용하세요. 작은따옴표(')도 사용할 수 있습니다.

마지막 업데이트