Zmienne środowiskowe

Pliki konfiguracyjne Sinaptic® DROID+ obsługują podstawianie ${ENV_VAR}. Dowolna wartość w droid.yaml lub w konfiguracjach agentów może odwoływać się do zmiennej środowiskowej.

Plik .env

Sinaptic® DROID+ automatycznie ładuje plik .env z katalogu roboczego podczas uruchamiania. Zmienne ustawione w środowisku systemowym mają pierwszeństwo przed wartościami z pliku .env.

# .env
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GEMINI_API_KEY=AIza...
GROK_API_KEY=xai-...

Klucze dostawców LLM

Zmienna	Dostawca	Wymagane
OPENAI_API_KEY	OpenAI (domyślnie)	Tak (jeśli używasz OpenAI)
ANTHROPIC_API_KEY	Anthropic (Claude)	Tak (jeśli używasz Anthropic)
GEMINI_API_KEY	Google Gemini	Tak (jeśli używasz Gemini)
GROK_API_KEY	xAI Grok	Tak (jeśli używasz Grok)

Dostawcy lokalni (Ollama, LM Studio, llama.cpp) nie wymagają kluczy API.

Zmienne środowiska wykonawczego

Zmienna	Opis	Domyślnie
DROID_CONFIG	Ścieżka do głównego pliku konfiguracyjnego	./droid.yaml
DROID_DATA_DIR	Ścieżka do katalogu danych	./data

Użycie w konfiguracji

Odwołuj się do dowolnej zmiennej środowiskowej za pomocą składni ${VAR}:

llm:
  api_key: ${OPENAI_API_KEY}

server:
  api_key: ${DROID_API_KEY}

mcp:
  servers:
    my-server:
      env:
        TOKEN: ${MY_SERVICE_TOKEN}

Jeśli zmienna środowiskowa nie jest ustawiona, ciąg ${VAR} pozostaje bez zmian (nie jest rozwinięty). Oznacza to, że wartością konfiguracyjną będzie dosłowny ciąg ${VAR}, co prawdopodobnie spowoduje błąd uwierzytelniania — co ułatwia wykrycie brakujących zmiennych.