Gemini knowledge retrieval is temporarily unavailable (upstr

Error message

Gemini knowledge retrieval is temporarily unavailable (upstream 503). Budibase is operating normally; please retry shortly.

What it means

Error "Gemini knowledge retrieval is temporarily unavailable (upstream 503). Budibase is operating normally; please retry shortly." thrown in Budibase/budibase.

Source

Thrown at packages/server/src/ai/tools/budibase/knowledgeFiles.ts:337

          operationId,
          question
        )
        return {
          context: result.text,
          sources: result.sources,
          chunks: result.chunks,
        }
      } catch (error: any) {
        if (isGeminiRetrievalUnavailable(error)) {
          console.error("[AI_UPSTREAM] Gemini unavailable", {
            event: GEMINI_UPSTREAM_EVENT,
            provider: "gemini",
            path: "knowledge_retrieval",
            upstreamStatus: error?.status,
            agentId,
            errorMessage: error?.message,
          })
          throw new Error(GEMINI_RETRIEVAL_UNAVAILABLE_MESSAGE)
        }
        console.error("Failed to retrieve agent knowledge context", {
          agentId,
          status: error?.status,
          message: error?.message,
        })
        throw error
      }
    },
  }),
})

View on GitHub (pinned to a81a902e9a)

When it happens

Trigger: Thrown at packages/server/src/ai/tools/budibase/knowledgeFiles.ts:337 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Budibase/budibase@a81a902e9a (2026-08-29). Data as JSON: /api/errors/ae36400fd494c40b. Report an issue: GitHub.