機能フラグ

1つのプロジェクトでBeeuniのサーフェスを有効にし、各フラグが制御する機能を確認できます。

機能フラグを使うと、1つのプロジェクトでBeeuniの機能を有効にできます。どの機能もフラグの背後に置いてリリースできます。実験的、ベータ、または完全に安定した機能です。「Experimental」はフラグの安定性を示すバッジであり、システムの名前ではありません。

フラグはプロジェクトごとに設定されます。あるプロジェクトでフラグを有効にしても、別のプロジェクトや他のアカウントには影響しません。

フラグを有効にする

1. Settings → Feature flags を開きます。このタブには、プラットフォームがサポートするすべてのフラグが一覧表示されます。
2. 行の内容を確認します。フラグ名、安定性バッジ、説明文、そして起源（Default on、Default off、またはOverridden for this project）が表示されます。
3. スイッチを操作します。変更は現在のプロジェクトにすぐ適用されます。

プロジェクトのproject.settings.write権限が必要です。それ以外の呼び出し元に対して、ルートは403を返します。

CLIから

同じスイッチを、スクリプトやエージェントからbeeuni projects features経由で操作できます。

beeuni projects features                # every flag: key, state, origin
beeuni projects features enable reminders
beeuni projects features disable reminders
beeuni projects features reset reminders  # drop the override; follow the platform default
beeuni projects features --json          # the full catalog as JSON

リンク済みまたはデフォルト以外のプロジェクトを操作するには、--project <id>を追加します。プラットフォームが利用不可としたフラグは、プロジェクト側の設定にかかわらずオフのままです。CLIではこれがn/a / unavailableと表示されます。

安定性バッジ

バッジが示すのは契約の状態であり、スイッチの状態ではありません。stableフラグも、明示的に有効化する必要があります。appsは安定していますが、デフォルトではオフです。

フラグの適用方法

各フラグには、適用モードが1つ定義されています。

routesによる拒否の内容は、どこでも同じです。

{
  "error": "Apps is not enabled for this project. Contact Beeuni to enable it.",
  "code": "feature_disabled",
  "feature": "apps"
}

error文字列が示すのはフラグ一覧であり、特定のタブではありません。一覧はSettingsのExperimentalタブです。

メッセージ文ではなく、codeで分岐してください。SDKはまさにこの用途のためにisFeatureDisabledError(error)とfeatureDisabledKey(error)をエクスポートしています。

すべてのフラグ

登録順です。Settings → Feature flagsに表示される順序と同じです。

Apps と Backends は Beeuni がプロジェクトごとに有効化します。利用を希望する場合は Beeuni にお問い合わせください。有効化後、Settings に Managed by Beeuni と表示されます。

各フラグが制御する機能

• marketplace — コミュニティやベンダーのレジストリからスキルを閲覧、インストールします。
• connectors_api_discover — 管理対象のOAuthアプリに加えて、直接API、MCP、GraphQL、CLI、Postmanの機能を閲覧します。Connectorsを参照してください。
• agentmail_email — AgentMailの受信トレイ接続を割り当て、受信メールでセッションを開始・継続できるようにします。
• llm_gateway — プロジェクトをBeeuni管理のLLMゲートウェイ経由で実行します。Modelsを参照してください。
• meta_agent — 特化したセッションを起動・管理する、プラットフォーム管理のコーディネーターエージェントを追加します。
• apps — 静的サイト、バンドル、Dockerfile、OCIイメージを、安定したサーバーレスURLにデプロイします。Appsを参照してください。
• monitors — リポジトリから24時間365日稼働するウォッチャーを実行し、セッションにトリガーイベントを送信します。Triggersを参照してください。
• reminders — 1つのセッションに対し、1回または繰り返しの予定チェックインを行います。オフの場合、リマインダールートはfeature_disabledを返し、既存のリマインダーも実行されません。Remindersを参照してください。
• warm_sessions — プロジェクトを開いている間、サンドボックスを1つ起動したままにし、新しいセッションをコールドブートなしで開始できるようにします。
• secrets_egress — シークレットにネットワーク適用を設定します。サンドボックスにはハンドルを保持し、Beeuniは許可済みホストへのリクエストに限り、実際の値を代わりに注入します。Secretsを参照してください。
• pi_harness — このプロジェクトのセッションを、通常のセッションサンドボックス（BEEUNI_HARNESS=pi）内でpiエージェントハーネスを使って実行します。オンの場合、マニフェストの内容にかかわらず、新規セッションや再起動したセッションはすべてpiを起動します。オフの場合はマニフェストに従います。runtime: piならpiを起動し、それ以外は標準のエージェントランタイムを起動します。piはLLMゲートウェイ経由でのみモデルを呼び出します。llm_gatewayがオフの場合、このフラグやマニフェストの内容にかかわらず、すべてのセッションで標準のエージェントランタイムが起動します。いずれの場合も、リポジトリ構成、エージェント、スキルは同じです。実行中のセッションは、再起動または再開するまでハーネスを維持します。piではサブエージェントが動作します。エージェントはtaskツールを使ってgeneral、explore（読み取り専用）、または.md内にmode: subagentがある任意のプロジェクトエージェントに作業を委任し、トランスクリプトには各サブエージェントの手順がその場に表示されます。piセッションはpi.devパッケージも読み込みます。harnesses:を参照してください。piは標準のエージェントランタイムが提供するすべてのセッション機能に対応しているわけではありません。Harnessesの比較表を参照してください。

一般提供になったフラグ

一般提供になった機能はすべてのプロジェクトで有効で、切り替えスイッチはありません。

• Agents as principalsはスイッチのない標準動作です。エージェントセッションは、誰が実行してもエージェント自身として動作し、その上限ロールの範囲内でBeeuni権限を持ちます。Agent permissionsを参照してください。
• Review Centerはフラグシステムの対象外になりました。Reviewページ、サイドバーのReview行、コマンドパレットの行はすべてのプロジェクトに表示されます。project.review.readとproject.review.actの権限は引き続き適用されます。review_centerはフラグキーではなくなりました。PATCH /v1/projects/:id/featuresは400 Unknown feature flagを返し、beeuni projects features enable review_center prints that error and exits 1となります。一般提供になる前に保存された上書き設定は影響しません。
• Computersはフラグシステムの対象外になりました。すべてのメンバーがプロジェクトのサイドバーから各自のコンピューターを接続できます。唯一のゲートは、プラットフォームのTUNNEL_ENABLED設定です。agent_tunnelはフラグキーではなくなりました。PATCH /v1/projects/:id/featuresは400 Unknown feature flagを返します。Computersを参照してください。
• Microsoft Teamsはフラグシステムの対象外になりました。すべてのプロジェクトでConnectors → ChannelsからTeamsを接続できます。テナント管理者による同意は一度必要ですが、プロジェクト独自のボットを使用することもできます。teamsはフラグキーではなくなりました。PATCH /v1/projects/:id/featuresは400 Unknown feature flagを返します。一般提供になる前に保存された上書き設定は影響しません。Microsoft Teamsを参照してください。

スイッチによる副作用

一部のフラグは、書き込みの確定後にプラットフォームの状態を収束させます。

これらの処理は状態を収束させるためのものであり、切り替えの成功条件には含まれません。APIレスポンスは処理の完了を待ちません。各処理は1回再試行され、その後のリコンサイラーは冪等性を備え、定期的なスイープでも再実行されます。

コードからフラグを読み取る、設定する

プロジェクト詳細、またはReactフックから、プロジェクトごとの有効状態を読み取ります。

import { useFeatureFlag } from '@beeuni/sdk/react';

function AppsNavItem({ projectId }: { projectId: string }) {
  const apps = useFeatureFlag(projectId, 'apps');
  if (!apps.enabled) return null;
  return <Link href={`/projects/${projectId}/apps`}>Apps</Link>;
}

enabledがtrueになるのは、サーバーが正確にtrueを返した場合のみです。プロジェクトIDがない場合、クエリの実行中、エラーの場合は、いずれもfalseになります。ゲートはフェイルクローズにしてください。

クライアントを使って、プロジェクトの上書き設定を行います。

const p = beeuni.project(projectId);

await p.updateFeatureFlag('apps', true);   // turn it on for this project
await p.updateFeatureFlag('apps', null);   // clear the override, inherit the default

updateFeatureFlagはPATCH /v1/projects/:id/featuresを呼び出します。featureは、@beeuni/sdkからエクスポートされ、型がFeatureFlagKeyであるFEATURE_FLAG_KEYSのいずれかです。SDKリファレンスを参照してください。

機能が無効な場合は、メッセージではなくコードで処理してください。

import { featureDisabledKey, isFeatureDisabledError } from '@beeuni/sdk';

try {
  await beeuni.project(projectId).apps.list();
} catch (error) {
  if (isFeatureDisabledError(error)) {
    console.log(`${featureDisabledKey(error)} is off for this project`);
  }
}