Заставице функција

Uključite Beeuni površinu za jedan projekat i pogledajte šta svaka zastavica omogućava.

Ознака функције укључује једну Beeuni површину за један пројекат. Свака површина може да се објави иза ознаке — експериментална, бета или потпуно стабилна. „Експериментално“ је ознака стабилности ознаке, а не назив система.

Ознаке важе по пројекту. Укључивање ознаке у једном пројекту ништа не мења у другом пројекту нити за друге налоге.

Укључивање ознаке

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 је стабилна и подразумевано искључена.

Примена ознаке

Свака ознака има један режим примене.

Одговор routes при одбијању свуда је исти:

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

Низ error наводи листу ознака, а не конкретну картицу. Листа је на картици Experimental у одељку Settings.

Проверите code, никада текст поруке. SDK извози isFeatureDisabledError(error) и featureDisabledKey(error) управо за то.

Све ознаке

Редослед у регистру — исти као у одељку Settings → Feature flags.

Beeuni укључује Apps и Backends по пројекту. Контактирајте Beeuni за приступ. После укључивања Settings приказује Managed by Beeuni.

Шта контролише свака ознака

• marketplace — прегледајте и инсталирајте вештине из заједничких и добављачких регистара.
• connectors_api_discover — прегледајте директне API, MCP, GraphQL, CLI и Postman површине поред управљаних OAuth апликација. Погледајте Connectors.
• agentmail_email — доделите AgentMail везе са сандучићима да би долазна е-пошта покретала и настављала сесије.
• llm_gateway — усмерите пројекат кроз Beeuni LLM пролаз којим се управља. Погледајте Models.
• meta_agent — додајте координаторског агента којим управља платформа, који покреће и управља специјализованим сесијама.
• apps — објављујте статичке сајтове, пакете, Dockerfile датотеке и OCI слике на стабилне серверлес URL адресе. Погледајте Apps.
• monitors — покрећите непрекидне надзорнике из репозиторијума који шаљу догађаје окидача у сесије. Погледајте Triggers.
• reminders — заказане провере које поново шаљу упит једној сесији, једном или понављано. Када је искључено, руте подсетника враћају feature_disabled, а постојећи подсетници се не активирају. Погледајте Reminders.
• warm_sessions — одржавајте један sandbox покренутим док је пројекат отворен, како би нова сесија почела без хладног покретања.
• secrets_egress — омогућите примену мрежних правила за тајну: sandbox чува референцу, а Beeuni убацује стварну вредност само у захтеве упућене одобреним хостовима. Погледајте Secrets.
• pi_harness — покрећите сесије овог пројекта на pi агентском окружењу унутар уобичајеног sandbox-а сесије (BEEUNI_HARNESS=pi). Када је укључено, свака нова или поново покренута сесија покреће pi, без обзира на манифест. Када је искључено, одлучује манифест — runtime: pi и даље покреће pi, а све друго покреће подразумевани агентски рантајм. pi позива моделе само преко LLM пролаза: када је llm_gateway искључено, свака сесија покреће подразумевани агентски рантајм, без обзира на ову ознаку или манифест. Распоред репозиторијума, агенти и вештине исти су у оба случаја; покренута сесија задржава своје окружење док се поново не покрене или настави. Подагенти раде на pi-ју: агент делегира помоћу алатке task на general, explore (само за читање) или било ког агента пројекта са mode: subagent у његовом .md, а транскрипт приказује кораке сваког подагента на одговарајућем месту. pi сесије учитавају и pi.dev пакете: погледајте harnesses:. pi не подржава све функције сесија које подржава подразумевани агентски рантајм: погледајте табелу у одељку Harnesses.

Унапредјене ознаке

Унапредјена функција је укључена за сваки пројекат и нема прекидач.

• Агенти као главни субјекти су стандардно понашање без прекидача. Сесија агента делује као сам агент — са 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 је унапређен и више није део система ознака. Сваки пројекат може да повеже Teams из одељка Connectors → Channels; администратор закупца и даље једном даје сагласност, или пројекат користи сопственог бота. teams више није кључ ознаке: PATCH /v1/projects/:id/features враћа 400 Unknown feature flag. Сачувано подешавање од пре унапређења нема ефекта. Погледајте Microsoft Teams.

Нуспојаве прекидача

Неке ознаке усклађују стање платформе након потврде уписа.

Ефекти су послови усклађивања, а не део успешног рада прекидача. Одговор API-ја не чека њихово извршење. Сваки ефекат се покушава поновити једном, а механизми за усклађивање који стоје иза њега су идемпотентни и поново се покрећу у периодичним циклусима.

Читање и постављање ознаке из кода

Прочитајте ефективно стање за пројекат преко детаља пројекта или 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 је једна од вредности FEATURE_FLAG_KEYS, извози се из @beeuni/sdk и има тип FeatureFlagKey. Погледајте референцу 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`);
  }
}