dokumentacja
Agenci w terminalu

Factory Droid

Markdown

Agent w terminalu · OpenAI Chat, OpenAI Responses, Anthropic Messages

Pełny przewodnik
FormatGdzie skonfigurować
OpenAI Chat, OpenAI Responses, Anthropic Messages~/.factory/settings.json → tablica customModels; wybór modelu — polecenie /model, sekcja „Custom models”

Konfiguracja

Skopiuj konfigurację i zastąp sk-... własnym kluczem z panelu Ailoot. Najlepiej przechowywać klucz w zmiennej środowiskowej AILOOT_API_KEY, jeśli aplikacja to obsługuje.

Przed uruchomieniem wywołaj GET /v1/models ze swoim kluczem Ailoot. Wybierz dokładny identyfikator modelu, którego metody obejmują POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, i użyj go w konfiguracji. Dla agentów sprawdź także obsługę narzędzi i funkcje wymagane przez twoją wersję klienta.

{
  "customModels": [
    {
      "model": "claude-sonnet-5-5",
      "displayName": "Claude Sonnet 5.5 (Ailoot)",
      "baseUrl": "https://api.ailoot.ai",
      "apiKey": "${AILOOT_API_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 64000
    },
    {
      "model": "gpt-6.1-sol",
      "displayName": "GPT-6.1 Sol (Ailoot)",
      "baseUrl": "https://api.ailoot.ai/v1",
      "apiKey": "${AILOOT_API_KEY}",
      "provider": "openai",
      "maxOutputTokens": 64000
    },
    {
      "model": "deepseek-v4-pro",
      "displayName": "DeepSeek V4 Pro (Ailoot)",
      "baseUrl": "https://api.ailoot.ai/v1",
      "apiKey": "${AILOOT_API_KEY}",
      "provider": "generic-chat-completion-api",
      "maxOutputTokens": 32000
    }
  ]
}

Ta konfiguracja odczytuje klucz ze zmiennej AILOOT_API_KEY. Ustaw ją przed uruchomieniem aplikacji:

export AILOOT_API_KEY="sk-..."   # dodaj do ~/.zshrc lub ~/.bashrc

Przykładowy model: claude-sonnet-5-5. Inne modele wybieraj z katalogu — sprawdź, czy model obsługuje wymagany format.

Warto wiedzieć

Sprawdzenie

  • Adres dla formatu OpenAI — https://api.ailoot.ai/v1 (lub pełna ścieżka, jeśli aplikacja wymaga pełnego adresu).
  • Adres dla formatu Anthropic — https://api.ailoot.ai bez /v1.
  • Zadaj krótkie pytanie. Jeśli otrzymasz błąd, sprawdź kod i Request ID, a następnie zajrzyj na stronę Błędy i limity.
  • 404 bezpośrednio po konfiguracji niemal zawsze oznacza błędny adres: nadmiarowe lub brakujące /v1.
  • 402 — saldo nie wystarcza na rezerwę. Agenci rezerwują więcej niż czat: dlaczego.

Dokumentacja aplikacji: https://docs.factory.com/model-independence/byok

Dodatkowe pytania? Prześlij Request ID i opis — pomożemy wyjaśnić sprawę.Napisz do wsparcia