AI

AIはオプションです。プロバイダーを設定しなければ、どこにも何も送られません。basedbは、お手持ちのキーを使ってOpenAI、Anthropic、Mistralと連携できます。さらに、OpenAIのAPIに対応するあらゆるサーバー（Azure、社内のゲートウェイ、自前で動かすモデル）とも連携できます。

プロバイダーを設定する

インターフェースで設定が保存されていない間は、APIは環境変数を読み込みます：

BASEDB_AI_PROVIDER=mistral      # openai、anthropic、mistral、openai_compatibleのいずれか
BASEDB_AI_MODEL=mistral-small-latest
MISTRAL_API_KEY=…               # または BASEDB_AI_API_KEY

キーはBASEDB_AI_API_KEYから読み込まれ、ない場合はプロバイダーの一般的な名前（OPENAI_API_KEY、ANTHROPIC_API_KEY、MISTRAL_API_KEY）から読み込まれます。

Azure、ゲートウェイ、ローカルモデル

BASEDB_AI_PROVIDER=openai_compatibleを指定すると、呼び出しはOpenAI形式でBASEDB_AI_BASE_URLのアドレスに送られます。このアドレスは/chat/completionsの手前までの部分で、パラメーターも含みます。BASEDB_AI_HEADERSは、そのサーバーが求めるヘッダーを、JSONオブジェクトとして各呼び出しに追加します。

# Azure OpenAI：モデルにはデプロイ名を指定し、キーはapi-keyヘッダーに入れる
BASEDB_AI_PROVIDER=openai_compatible
BASEDB_AI_MODEL=mon-deploiement
BASEDB_AI_BASE_URL=https://ma-ressource.openai.azure.com/openai/v1
BASEDB_AI_HEADERS='{"api-key":"…"}'

# Azureの従来の形式（デプロイごと）：パラメーターはパスの後ろに残す
BASEDB_AI_BASE_URL=https://ma-ressource.openai.azure.com/openai/deployments/mon-deploiement?api-version=2024-10-21

# Ollamaで動かすモデル、キーなし
BASEDB_AI_PROVIDER=openai_compatible
BASEDB_AI_MODEL=llama3.1
BASEDB_AI_BASE_URL=http://ollama:11434/v1

openai_compatibleでは、キーは省略できます。BASEDB_AI_API_KEYを指定した場合は、Authorization: Bearerとして送られます。BASEDB_AI_HEADERSのヘッダーは、キーによるヘッダーを置き換えます。たとえば、独自のAuthorizationを要求するゲートウェイの場合です。

BASEDB_AI_BASE_URLとBASEDB_AI_HEADERSは、ゲートウェイ経由で接続する他の3つのプロバイダーにも使えます。anthropicの場合、アドレスは/messagesの手前までの部分です。この2つの変数が適用されるのは、環境変数で指定したプロバイダーだけです。別のプロバイダーを選んだテナントには、アドレスもヘッダーもキーも渡されません。APIは起動時に、採用したプロバイダーを書き出し、無効なアドレスやJSONオブジェクトを通知します。

TLS証明書が自己署名の社内ゲートウェイや、通信を再署名する社内プロキシがあると、呼び出しが失敗します。BASEDB_AI_PROVIDER_SSL_VERIFY=falseを指定すると、このプロバイダーに限って証明書の検証を行わなくなります。インスタンスの他のすべての外向き呼び出しと、テナントが選んだプロバイダーは、引き続き検証されます。起動時にその旨が通知されます。キーはすべての呼び出しで送られるため、管理下にあるネットワークでのみ使用してください。

フィールドのAIオプション

AIはフィールドの型ではなく、オプションです。フィールドのフォームにあるAIスイッチ（テキスト、長文テキスト、URL、数値、単一選択、真偽値、日付で利用可能）をオンにすると、他の列を引用する指示をもとに、モデルがそのフィールドを埋めます：

Résume {{Notes}} en une phrase.
Catégorie de {{Description}} parmi les choix de la liste.

• フィールドは行が作成された時点で計算され、その後は引用した列が変わるたびに再計算されます。必要に応じて、スケジュールに従って計算することもできます（最短15分ごと）。
• 列は型を保ちます。その型として読み取れない回答（数値が見つからない、存在しない選択肢など）は、書き込まれずに拒否されます。
• オプションを無効にすると、値を保ったまま、フィールドを再び手動で編集できるようになります。
• 引用された値はプロバイダーに送られるため、有効にするには明示的な同意が必要です。

BASEDB_AI_FIELD_QUOTAで、テナントごとの1時間あたりの計算回数を制限します（デフォルトは300）。

オートメーションで

オートメーションでは、ステップの1つでAIに質問できます。行と前のステップを引用する指示を送り、選んだ型で回答を読み取り、後続のステップがそれを書き込んだり、送信したり、引用したりします。ルールはフィールドと同じです：保存時の同意が必要で、送られるのは指示が引用する内容のみ、各呼び出しは記録されBASEDB_AI_FIELD_QUOTAにカウントされます。

下書きとCopilot

• 下書き：テーブルや数式を一文で説明すると、確認用の提案が届きます。送られるのはラベル、型、入力した文だけで、セルの値は一切送られません。
• テンプレート：データベース全体を説明すると（「顧客からのクレームの管理」）、テーブル、サンプル行、ビュー、ダッシュボード、オートメーションが届き、調整してから作成できます。送られるのはその文だけです。データベーステンプレートをご覧ください。
• Copilot：表示中のデータベースについての会話です。フィルター、クエリ、列、テーブル、テストデータを依頼できます。各提案はカードとして届き、フォームと同じ経路で、クリックひとつで適用されます。

デフォルトでは、プロバイダーに送られるのは構造のみです。データの読み取りを許可にチェックを入れると、その会話の間、Copilotが行を読み（1回の読み取りにつき最大50行）、それに基づいて回答できるようになります。読み取った内容は、それぞれ回答の下に一覧表示されます。

ダッシュボードのCopilot

ダッシュボードセクションでは、Copilotが質問、ダッシュボードの変更、フィルターの値を提案し、クリックひとつで適用できます。ルールは同じです：同意がなければ、送られるのは構造のみ（テーブルとフィールド、データベースのダッシュボードと質問、表示中のダッシュボードのカード定義（質問とテキスト））で、結果やフィルターで選んだ値は送られません。データの読み取りを許可にチェックを入れると、それらの値と、表示中のフィルターでのカードの結果が加わります（1回の読み取りにつき最大50行、それぞれ回答の下に一覧表示）。

オートメーションのCopilot

オートメーションセクションでは、Copilotがオートメーション全体（画面上のものを変更した案、または新しいもの）を提案し、エディターのフローに配置します。保存することは決してありません。内容を確認してから、ご自身で保存してください。ルールは同じです：同意がなければ、送られるのは構造のみ（テーブルとフィールド、データベースのオートメーション、画面上のオートメーション、値を含まない最近の実行、仮の記号で示したメンバーとSlackチャンネル）で、データの読み取りを許可にチェックを入れると、読み取った行が加わります（1回の読み取りにつき最大50行）。

BASEDB_AI_QUOTAで、テナントごとの1時間あたりの対話的な呼び出し回数を制限します（デフォルトは120）。