Skip to content

Pagbuo ng mga Integration

Dinisenyo ang Triggerfish para ma-extend. Kung gusto mong mag-connect ng bagong data source, mag-automate ng workflow, bigyan ang iyong agent ng bagong skills, o mag-react sa external events, may malinaw na integration pathway -- at bawat pathway ay sumusunod sa parehong security model.

Mga Integration Pathway

Nag-ooffer ang Triggerfish ng limang natatanging paraan para i-extend ang platform. Bawat isa ay may iba't ibang layunin, pero lahat ay may parehong security guarantees: classification enforcement, taint tracking, policy hooks, at full audit logging.

PathwayLayuninPinakamainam Para Sa
MCP GatewayMag-connect ng external tool serversStandardized agent-to-tool communication via Model Context Protocol
Plugin SDKMag-run ng sandboxed custom codeCRUD operations sa external systems, complex data transformations, workflows
Exec EnvironmentAng agent ang nagsusulat at nagru-run ng sariling codePagbuo ng integrations, prototyping, testing, at pag-iterate sa feedback loop
SkillsBigyan ang agent ng bagong capabilities via instructionsReusable behaviors, community marketplace, agent self-authoring
Browser AutomationKontrolin ang browser instance via CDPWeb research, form filling, scraping, automated web workflows
WebhooksTumanggap ng inbound events mula sa external servicesReal-time reactions sa emails, alerts, CI/CD events, calendar changes
GitHubFull GitHub workflow integrationPR review loops, issue triage, branch management via webhooks + exec + skills
Google WorkspaceI-connect ang Gmail, Calendar, Tasks, Drive, SheetsBundled OAuth2 integration na may 14 tools para sa Google Workspace
ObsidianMagbasa, magsulat, at maghanap ng Obsidian vault notesClassification-gated note access na may folder mappings, wikilinks, daily notes

Security Model

Bawat integration -- anuman ang pathway -- ay gumagana sa ilalim ng parehong security constraints.

Lahat ay Nagsisimula bilang UNTRUSTED

Ang mga bagong MCP servers, plugins, channels, at webhook sources ay naka-default sa UNTRUSTED state. Hindi sila pwedeng mag-exchange ng data sa agent hanggang hindi sila explicitly na-classify ng owner (personal tier) o admin (enterprise tier).

UNTRUSTED  -->  CLASSIFIED  (pagkatapos ng review, may assigned classification level)
UNTRUSTED  -->  BLOCKED     (explicitly na pinagbawal)

Dumadaan ang Classification

Kapag nag-return ng data ang isang integration, dala ng data na iyon ang classification level. Ang pag-access ng classified data ay nag-eescalate ng session taint para pumantay. Kapag na-taint na, hindi na pwedeng mag-output ang session sa mas mababang-classification na destination. Ito ang No Write-Down rule -- fixed ito at hindi ma-override.

Ine-enforce ng Policy Hooks sa Bawat Boundary

Lahat ng integration actions ay dumadaan sa deterministic policy hooks:

HookKailan Ito Nag-fire
PRE_CONTEXT_INJECTIONPumapasok ang external data sa agent context (webhooks, plugin responses)
PRE_TOOL_CALLNagre-request ang agent ng tool call (MCP, exec, browser)
POST_TOOL_RESPONSENag-return ng data ang tool (classify response, update taint)
PRE_OUTPUTUmaalis ang response sa system (final classification check)

Ang mga hooks na ito ay pure functions -- walang LLM calls, walang randomness, walang bypass. Parehong input palagi ang parehong decision.

Audit Trail

Bawat integration action ay nilo-log: kung ano ang tinawag, sino ang tumawag, kung ano ang policy decision, at paano nagbago ang session taint. Ang audit trail na ito ay immutable at available para sa compliance review.

SECURITY Hindi ma-bypass, ma-modify, o ma-influence ng LLM ang

policy hook decisions. Nare-run ang hooks sa code sa ilalim ng LLM layer. Ang AI ang nagre-request ng actions -- ang policy layer ang nagde-decide. :::

Pagpili ng Tamang Pathway

Gamitin ang decision guide na ito para pumili ng integration pathway na akma sa iyong use case:

  • Gusto mong mag-connect ng standard tool server -- Gamitin ang MCP Gateway. Kung nagsasalita ng MCP ang isang tool, ito ang daan.
  • Kailangan mong mag-run ng custom code laban sa external API -- Gamitin ang Plugin SDK. Nare-run ang plugins sa double sandbox na may strict isolation.
  • Gusto mong bumuo at mag-iterate ng code ang agent -- Gamitin ang Exec Environment. Nakakuha ang agent ng workspace na may full write/run/fix loop.
  • Gusto mong turuan ang agent ng bagong behavior -- Gamitin ang Skills. Magsulat ng SKILL.md na may instructions, o hayaan ang agent na magsulat ng sarili niya.
  • Kailangan mong i-automate ang web interactions -- Gamitin ang Browser Automation. CDP-controlled Chromium na may domain policy enforcement.
  • Kailangan mong mag-react sa external events sa real time -- Gamitin ang Webhooks. Ang mga inbound events ay verified, classified, at niru-route sa agent.

Ang mga pathways na ito ay hindi mutually exclusive. Pwedeng gumamit ng

browser automation ang isang skill internally. Pwedeng ma-trigger ng webhook ang isang plugin. Ang isang agent-authored integration sa exec environment ay pwedeng i-persist bilang skill. Natural silang nagko-compose. :::