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

Connected Content FAQ

Frequently asked questions about configuring Connected Content and handling its responses.

These are the questions we hear most often when setting up and using Connected Content.

Can I use connected_content multiple times in one message?

Yes. However, all connected_content calls in one message share a cumulative time budget of 2 seconds. If the first call took 1.8 seconds, the second call must finish within 0.2 seconds. Once the limit is exceeded, subsequent calls are immediately skipped without a network call. Use multiple calls only when the average response time of the external API is sufficiently short.


Won't it take a long time to send while waiting for the response?

Each call terminates within a maximum of 2 seconds. The cumulative limit for one message is also 2 seconds. Send delays do not accumulate indefinitely.


How do I access the response when it is a JSON array?

If the top level is an array, it is not recognized as an object and becomes an empty value. Have the API return a response wrapped in an object, such as {"items":[...]}. You can also set up a separate wrapping endpoint.


Can I use non-JSON responses (e.g., plain text, HTML)?

Not supported. If it cannot be parsed as a JSON object, it is treated as an empty value.


I want to use the response only for conditional branching without displaying it directly in the message.

You can use the :save variable directly in {% if %} and the like. You do not need to output it in the message body. Refer to the examples in Behavior on Failure.


How do I extract a response field whose key contains Korean characters, spaces, or dots?

Use bracket subscript in the form {{var["key name"]}}. Single quotes (') can also be used.

Last updated