Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

在伺服器環境使用遠端設定

Firebase Remote Config 支援使用 Firebase Admin SDK 進行伺服器端設定，適用於 Node.js (v12.1.0 以上版本)、Python (v6.7.0 以上版本)、Java (v9.7.0 以上版本) 和 Go (v4.17.0 以上版本)。

這項功能可讓您使用 Remote Config 動態管理伺服器端應用程式的行為和設定。包括 Cloud Functions for Firebase 等無伺服器實作項目，以及 Cloud Run 上的容器化服務。

Firebase 用戶端 SDK 會擷取從 Remote Config 範本衍生的用戶端專屬設定，但伺服器端 Remote Config SDK 會從 Firebase 下載或擷取完整的 Remote Config 範本。接著，伺服器可以評估每個傳入要求的範本，並使用自己的邏輯，以極低的延遲時間提供自訂回應。您可以根據隨機百分比和自訂信號中定義的用戶端屬性，使用條件控制及自訂回應。

使用伺服器端 Remote Config，您可以：

定義在伺服器上執行或透過伺服器存取的應用程式設定參數，以便遠端設定 AI 模型參數和提示，以及其他整合項目等用途，確保 API 金鑰安全無虞。
根據環境或其他應用程式的變化動態調整參數，例如更新 LLM 參數和模型端點。
遠端更新伺服器呼叫的 API，即可控管費用。
為存取伺服器的用戶端即時產生自訂設定。
記錄哪些用戶端收到參數值，並在Cloud Functions for Firebase中將此值做為授權驗證系統的一部分。

您可以在 Cloud Run、Cloud Functions for Firebase 或自行代管的伺服器環境中，部署伺服器端 Remote Config。

事前準備

請按照「在伺服器中新增 Firebase Admin SDK」一文中的操作說明，建立 Firebase 專案、設定服務帳戶，並在伺服器中新增 Firebase Admin SDK。請務必使用平台支援的 Admin SDK 版本：

Node.js：Firebase Admin Node.js SDK 12.1.0 以上版本
Python：Firebase Admin Python SDK 6.7.0 以上版本
Java：Firebase Admin Java SDK 9.7.0 以上版本
Go：Firebase Admin Go SDK 4.17.0 以上版本

步驟 1：初始化 Firebase Admin SDK 並授權 API 請求

初始化 Admin SDK 時，如果沒有任何參數，SDK 會使用 Google 應用程式預設憑證，並從 GOOGLE_APPLICATION_CREDENTIALS 環境變數讀取選項。初始化 SDK，並為您的平台設定 Remote Config：

Node.js

匯入 initializeApp 和 getRemoteConfig，然後初始化 Firebase 應用程式例項：

import { initializeApp } from "firebase-admin/app";
import { getRemoteConfig } from "firebase-admin/remote-config";

// Initialize Firebase
const firebaseApp = initializeApp();

Python

匯入 firebase_admin (以及 asyncio 和 json，用於非同步範本載入和 JSON 剖析)，然後初始化應用程式：

import firebase_admin
import asyncio
import json

firebase_admin.initialize_app()

Java

使用 FirebaseOptions 和服務帳戶憑證初始化 Firebase Admin SDK：

// Initialize the Firebase Admin SDK
FirebaseOptions options = new FirebaseOptions.Builder()
    .setCredentials(GoogleCredentials.fromStream(serviceAccount))
    .build();
FirebaseApp.initializeApp(options);

Go

初始化 Firebase 應用程式，並建立 RemoteConfig用戶端例項：

ctx := context.Background()

// Initialize Firebase
app, err := firebase.NewApp(ctx, nil)
if err != nil {
    log.Fatalln("Error initializing app:", err)
}

remoteConfig, err := app.RemoteConfig(ctx)
if err != nil {
    log.Fatalln("Error initializing remote config client:", err)
}

步驟 2：找出伺服器應用程式的預設參數值

找出應用程式中要使用 Remote Config 動態更新的變數。接著，請考量應用程式中預設必須設定哪些變數，以及這些變數的預設值。即使應用程式與Remote Config後端伺服器的連線中斷，也能順利執行。

舉例來說，如果您要編寫管理生成式 AI 函式的伺服器應用程式，可以設定預設模型名稱、提示前言和生成式 AI 設定，如下所示：

參數名稱	說明	類型	預設值
`model_name`	模型 API 名稱	字串	`gemini-2.0-flash`
`preamble_prompt`	要加在使用者查詢內容開頭的提示	字串	`I'm a developer who wants to learn about Firebase and you are a helpful assistant who knows everything there is to know about Firebase!`
`generation_config`	要傳送至模型的參數	JSON	`{"stopSequences": ["I hope this helps"], "temperature": 0.7, "maxOutputTokens": 512, "topP": 0.1, "topK": 20}`

步驟 3：設定伺服器應用程式

決定要搭配 Remote Config 使用的參數後，請設定應用程式以設定預設值、擷取伺服器專屬的 Remote Config 範本，並評估其值。

存取並載入 Remote Config 伺服器範本。

Node.js

使用 initServerTemplate() 初始化伺服器範本，並呼叫 load() 從後端擷取範本：

// Initialize server-side Remote Config
const rc = getRemoteConfig(firebaseApp);
const template = rc.initServerTemplate();

// Load Remote Config
await template.load();

如果您在 Cloud Functions for Firebase 中使用 Node.js，可以透過非同步 getServerTemplate() 函式，在單一步驟中初始化及載入範本：

// Initialize server-side Remote Config
const rc = getRemoteConfig(firebaseApp);
const template = await rc.getServerTemplate();

Python

使用 init_server_template() 初始化伺服器範本，並呼叫 load() 從後端擷取範本：

from firebase_admin import remote_config

# Initialize server-side Remote Config
template = remote_config.init_server_template()

# Load the template from the backend
asyncio.run(template.load())

或者，如果您使用 Python 搭配 Cloud Functions for Firebase，可以透過非同步 get_server_template() 函式，在單一步驟中初始化及載入範本：

# Initialize server-side Remote Config
template = await remote_config.get_server_template()

Java

使用下列程式碼初始化伺服器端 Remote Config 用戶端： FirebaseRemoteConfig.getInstance()

// Initialize server-side Remote Config client
FirebaseRemoteConfig rc = FirebaseRemoteConfig.getInstance();

或者，如果您使用 Java 搭配 Cloud Functions for Firebase，可以透過 getServerTemplate() 初始化範本並載入，只需一個步驟：

ServerTemplate template = rc.getServerTemplate();

Go

使用 InitServerTemplate() 初始化伺服器範本，並呼叫 Load() 從後端擷取範本：

// Initialize server-side Remote Config
defaultConfig := make(map[string]any)
templateDataJSON := ""
template, err := remoteConfig.InitServerTemplate(defaultConfig, templateDataJSON)
if err != nil {
    log.Fatalln("Error initializing server template:", err)
}

// Load Remote Config
err = template.Load(ctx)
if err != nil {
    log.Fatalln("Error fetching server template:", err)
}

您也可以使用 GetServerTemplate 函式擷取必要的伺服器範本，藉此初始化範本。您可以將這個範本轉換為 JSON 格式並儲存至本機，然後使用 InitServerTemplate 函式初始化這個 JSON 範本。

為確保應用程式即使與 Remote Config 後端伺服器的連線中斷，也能順利執行，請在應用程式中為每個參數新增預設值。

Node.js

在 initServerTemplate 或 getServerTemplate 範本函式中新增 defaultConfig 物件：

const template = rc.initServerTemplate({
  defaultConfig: {
    model_name: "gemini-pro",
    generation_config: '{"stopSequences": [], "temperature": 0.7, "maxOutputTokens": 512, "topP": 0.1, "topK": 20}',
    preamble_prompt: "I'm a developer who wants to learn about Firebase and you are a helpful assistant who knows everything there is to know about Firebase!"
  },
});

// Load Remote Config
await template.load();

Python

在 init_server_template 或 get_server_template 範本函式中新增 default_config 字典：

template = remote_config.init_server_template({
  'default_config': {
    'model_name': "gemini-pro",
    'generation_config': '{"stopSequences": [], "temperature": 0.7, "maxOutputTokens": 512, "topP": 0.1, "topK": 20}',
    'preamble_prompt': "I'm a developer who wants to learn about Firebase and you are a helpful assistant who knows everything there is to know about Firebase!"
  },
})

# Load Remote Config
asyncio.run(template.load())

您也可以使用 get_server_template 函式擷取必要的伺服器範本，藉此初始化範本。您可以使用 template.to_json 函式，將這個範本轉換為 JSON 格式。這個 JSON 範本可以儲存在本機，您隨後可以使用 init_server_template 函式初始化這個 JSON 範本。

Java

在 getServerTemplate 函式中，使用 KeysAndValues 新增 defaultConfig 物件：

// Initialize default config using KeysAndValues
KeysAndValues defaultConfig = new KeysAndValues.Builder()
                                  .put("rc_param_1", "default value 1")
                                  .put("rc_param_2", "default value 2")
                                  .build();
ServerTemplate template = rc.getServerTemplate(defaultConfig);

或者，您也可以在初始化 Remote Config 時傳遞預設快取範本，即使與 Remote Config 伺服器的連線中斷，也能使用該範本：

String templateDataJSON = "{}"; // add your default template as JSON
ServerTemplate template = rc.serverTemplateBuilder()
                    .defaultConfig(defaultConfig)
                    .cachedTemplate(templateDataJSON)
                    .build();

Go

在 InitServerTemplate 或 GetServerTemplate 範本函式中新增 defaultConfig 對應：

// Initialize server-side Remote Config
defaultConfig := make(map[string]any)
defaultConfig["model_name"] = "gemini-2.0-flash"

// Assume the type generationConfig has been defined
defaultConfig["generation_config"] = &generationConfig{
    StopSequences:   []string{"I hope this helps"},
    Temperature:     0.7,
    MaxOutputTokens: 512,
    TopP:            0.9,
    TopK:            30,
}

defaultConfig["preamble_prompt"] = "I'm a developer who wants to learn about Firebase and you are a helpful assistant who knows everything there is to know about Firebase!"

templateDataJSON := ""
template, err := remoteConfig.InitServerTemplate(defaultConfig, templateDataJSON)
if err != nil {
    log.Fatalln("Error initializing server template:", err)
}

// Load Remote Config
err = template.Load(ctx)
if err != nil {
    log.Fatalln("Error fetching server template:", err)
}

範本載入後，請評估範本，從中匯入參數和值：

Node.js

使用「template.evaluate()」：

// Add template parameters to config
const config = template.evaluate();

Python

使用「template.evaluate()」：

# Add template parameters to config
config = template.evaluate()

Java

使用「template.evaluate()」：

// Add template parameters to config
ServerConfig config = template.evaluate();

Go

如果沒有套用任何條件，請使用 template.Evaluate() 和空白評估情境：

// An empty evaluation context means no conditions are applied.
evaluationContext := make(map[string]any)
config, err := template.Evaluate(evaluationContext)
if err != nil {
    log.Fatalln("Error evaluating template:", err)
}

(選用) 如果您在 Remote Config 範本中設定條件，請定義並提供所需的情境值：

如果使用百分比條件，請在範本評估函式中，加入要用來評估條件的隨機 ID (randomizationId、randomization_id 或 randomizationID)。
如果使用自訂信號，請定義屬性和值。如要使用自訂信號，請使用 Firebase Admin Node.js SDK 12.5.0 以上版本、Python SDK 6.7.0 以上版本、Java SDK 9.7.0 以上版本和 Go SDK 4.17.0 以上版本。

舉例來說，您可以將Firebase安裝 ID或使用者 ID 設為隨機 ID，確保與伺服器通訊的每位使用者都會加入適當的隨機群組；version 設為自訂信號，指定目標為特定用戶端版本；platform 設為自訂信號，指定目標為用戶端平台。

如要進一步瞭解條件，請參閱「條件規則類型」。

Node.js

將包含 randomizationId 和任何自訂信號的評估內容物件傳遞至 template.evaluate()：

// Add template parameters to `config`. Evaluates the
// template and returns the parameter value assigned to
// the group assigned to the {randomizationId} and version.
const config = template.evaluate({
  randomizationId: "2ac93c28-c459-4760-963d-a3974ec26c04",
  version: "1.0",
  platform: "Android"
});

Python

將包含 randomization_id 和任何自訂信號的字典傳遞至 template.evaluate()：

# Add template parameters to `config`. Evaluates the
# template and returns the parameter value assigned to
# the group assigned to the {randomization_id} and version.
config = template.evaluate({
  'randomization_id': "2ac93c28-c459-4760-963d-a3974ec26c04",
  'version': "1.0",
  'platform': "Android"
})

Java

建立包含 randomizationId 和任何自訂信號的 KeysAndValues 內容，並傳遞至 template.evaluate()：

// Add custom signals and randomizationId
KeysAndValues context = new KeysAndValues.Builder()
                                .put("custom_signal_key", "99")
                                .put("randomizationId", "2ac93c28")
                                .build();

// Evaluate the template with signals
ServerConfig config = template.evaluate(context);

Go

將包含 randomizationID 和任何自訂信號的評估內容地圖傳遞至 template.Evaluate()：

// Add template parameters to `config`. Evaluates the
// template and returns the parameter value assigned to
// the group assigned to the {randomizationID}, version, and platform.
evaluationContext := make(map[string]any)
evaluationContext["randomizationID"] = "2ac93c28-c459-4760-963d-a3974ec26c04"
evaluationContext["version"] = "1.0"
evaluationContext["platform"] = "Android"

config, err := template.Evaluate(evaluationContext)
if err != nil {
    log.Fatalln("Error evaluating template:", err)
}

接著，從評估的設定物件中擷取所需參數值。使用 getter 方法，將 Remote Config 中的值轉換為預期格式。

舉例來說，如果您在伺服器上實作 Agent Platform，並想變更模型和模型參數，可以為 model_name 和 generation_config 設定參數。以下是支援的 getter 方法，以及如何存取各平台 Remote Config 值的範例：

Node.js

支援的 getter 方法：

布林值：getBoolean
物件：getValue
編號：getNumber
字串：getString

// Replace defaults with values from Remote Config.
const generationConfig =
  JSON.parse(
    config.getString('generation_config'));

const is_ai_enabled = config.getBoolean('is_ai_enabled');

const model = config.getString('model_name');

// Generates a prompt comprised of the Remote Config
// parameter and prepends it to the user prompt
const prompt = `${config.getString('preamble_prompt')} ${req.query.prompt}`;

Python

支援的 getter 方法：

布林值：get_bool
整數：get_int
浮點數：get_float
字串：get_string
值來源：get_value_source

# Replace defaults with values from Remote Config.
generation_config = json.loads(config.get_string('generation_config'))
is_ai_enabled = config.get_bool('is_ai_enabled')
model = config.get_string('model_name')

# Generates a prompt comprised of the Remote Config
# parameter and prepends it to the user prompt.
prompt = f"{config.get_string('preamble_prompt')}{req.args.get('prompt')}"

Java

支援的 getter 方法：

布林值：getBoolean
字串：getString
雙倍：getDouble
長格式：getLong
值來源：getValueSource

// Get the model name
String modelName = config.getString("model_name");
// Get the origin of value assigned to param
ValueSource modelNameSource = config.getValueSource("model_name");

方法 getValueSource 會傳回 ValueSource，指出參數的值來源是 STATIC、REMOTE 或 DEFAULT。

Go

支援的 getter 方法：

布林值：GetBoolean
整數：GetInt
浮點數：GetFloat
字串：GetString
值來源：GetValueSource

// Replace defaults with values from Remote Config.

// Assume the type generationConfig has been defined
var genConfig generationConfig
err = json.Unmarshal([]byte(config.GetString("generation_config")), &genConfig)
if err != nil {
    log.Fatalln("Error unmarshaling generation config:", err)
}
model := config.GetString("model_name")

// Parameter created on the console
isAIEnabled := config.GetBoolean("is_ai_enabled")

// Generates a prompt comprised of the Remote Config
// parameter and prepends it to the user prompt (assume it is extracted from the request body)
userPrompt := "What is Remote Config?"
prompt := fmt.Sprintf("%s %s", config.GetString("preamble_prompt"), userPrompt)

如果您的伺服器是長期執行的伺服器，而非無伺服器環境，請定期重新載入範本 (例如在 Node.js 中使用 setInterval 或在 Java 中使用 java.util.Timer)，確認您是從 Remote Config 伺服器擷取最新範本。

步驟 4：在 Remote Config 中設定伺服器專屬的參數值

接著，建立伺服器 Remote Config 範本，並設定要在應用程式中使用的參數和值。

如要建立伺服器專屬的 Remote Config 範本，請按照下列步驟操作：

在 Firebase 控制台中，依序前往「DevOps & Engagement」(DevOps 與參與度) >「Remote Config」(遠端設定) >「Parameters」(參數) 頁面。
從頁面頂端的「用戶端/伺服器」選取器中，選取「伺服器」。
定義 Remote Config 參數，這些參數的名稱和資料類型必須與您在應用程式中定義的參數相同，並提供值。當您擷取及評估範本，並將這些值指派給變數時，這些值會覆寫您在「設定伺服器應用程式」中設定的預設設定 (defaultConfig 或 default_config)。
您也可以視需要設定條件，將值持續套用至隨機樣本的執行個體或自訂信號。如要進一步瞭解條件，請參閱「條件規則類型」。
新增完參數後，請按一下「發布變更」。
查看變更，然後再次點選「發布變更」。

步驟 5：使用 Cloud Functions for Firebase 或 Cloud Run 部署

如果伺服器應用程式輕巧且為事件驅動型，建議使用 Cloud Functions for Firebase 部署程式碼。舉例來說，假設您有一個應用程式，其中包含由生成式 AI API (例如 Google AI 或 Agent Platform) 支援的角色對話。在這種情況下，您可以將 LLM 服務邏輯代管在應用程式隨選呼叫的函式中。

如要瞭解如何使用第 2 代 Cloud Functions for Firebase 和伺服器端 Remote Config 解決方案，請參閱「搭配使用伺服器端 Remote Config 與 Cloud Functions for Firebase 和 Agent Platform」。
如要進一步瞭解如何使用 Cloud Functions for Firebase 部署應用程式，請參閱「開始使用：編寫、測試及部署第一個函式」。
試用範例可呼叫函式，並在「Call the Agent Platform Gemini API (formerly Vertex AI) with Remote Config and App Check」中，使用伺服器端 Remote Config 和 App Check。

如果您要建構以伺服器算繪的網頁應用程式，App Hosting支援熱門的網頁架構。

否則，您可能需要考慮 Cloud Run。如要使用 Cloud Run 部署伺服器應用程式，請按照您所用語言的快速入門指南操作：

如要進一步瞭解 Cloud Run 和 Cloud Functions for Firebase 的最佳用途，請參閱「Cloud Functions for Firebase vs. Cloud Run：何時該使用哪一個？」。

後續步驟

在「參數和條件 (伺服器端)」中，探索伺服器端參數和條件。
使用完整解決方案：搭配使用伺服器端 Remote Config 與 Cloud Functions for Firebase 和 Agent Platform。
瞭解如何管理 Remote Config 範本版本。

在伺服器環境使用遠端設定 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

步驟 1：初始化 Firebase Admin SDK 並授權 API 請求

Node.js

Python

Java

Go

步驟 2：找出伺服器應用程式的預設參數值

步驟 3：設定伺服器應用程式

Node.js

Python

Java

Go

Node.js

Python

Java

Go

Node.js

Python

Java

Go

Node.js

Python

Java

Go

Node.js

Python

Java

Go

步驟 4：在 Remote Config 中設定伺服器專屬的參數值

步驟 5：使用 Cloud Functions for Firebase 或 Cloud Run 部署

後續步驟

在伺服器環境使用遠端設定