Calypso icon

Calypso

Ask a grounded Calypso RAG agent

Actions3

Ask Agent

AI-generated

Summary

Sends a question or instruction to a Calypso RAG agent through the POST /responses endpoint and returns the grounded answer, source annotations and metadata for each input item.

Inputs

  • Model — Choose 'Default Agent' (calypso-rag-agent, the default) or 'Named Profile' (calypso-rag-agent:).
  • Named Profile Name or ID (required) — Shown only for Named Profile mode. Selects a profile available to the API key, loaded from the API. The 'calypso-rag-agent:' prefix is added if missing. Must not be empty or repeat the prefix.
  • Agent Bucket Context — Shown only for Named Profile mode. Informational list of the profile's buckets. It is ignored at execution.
  • Input (required) — Question or instruction text sent to the agent. Empty or whitespace-only input raises an error.
  • Additional Options — Include Token Usage adds the API's usage object to the output. Include Raw Response adds the full API response as rawResponse. Both default to off.

Output shape

One output item per input item. Each has json with model, input, answer (the response's output_text, or its text parts joined with newlines), sources (annotations collected from the response content), and metadata (apiType 'responses', an ISO timestamp, and the API's metadata under metadata.calypso when present). Optional usage and rawResponse fields are added when enabled.

The request runs once per input item, so each item is a separate API call. The workspace, buckets and policy come from the credential's project API key. usage is only added if the API returned it. With Continue On Fail enabled, a failed item returns {error: true, message, input, model, timestamp} paired to that item. Otherwise the node throws. Success items do not set pairedItem explicitly.

Examples

Example 1: Answer a support question from the project's knowledge base using the default agent.

Model: Default Agent; Input: ={{ $json.question }}; leave options off. Use the 'answer' and 'sources' fields downstream.

Example 2: Query a specific named profile and track cost.

Model: Named Profile, pick a profile; Input: 'Summarize our refund policy'; enable Include Token Usage.

Example 3: Debug the full API payload.

Default Agent; Input set; enable Include Raw Response to read rawResponse.

Links

Discussion