Appearance
Plugins Overview
Plugins extend your HELIX agents with external API capabilities. They allow agents to interact with services like Shopee, Stripe, Slack, Discord, and more — without writing any code.
How Plugins Work
Plugins are structured configurations that tell the runtime how to:
- Authenticate with an external API (API key, OAuth2, basic auth, bearer token)
- Build HTTP requests (endpoint, method, parameters)
- Parse responses (JSON extraction)
Plugins do NOT execute arbitrary code. They are safe to install from the marketplace.
Plugin Types
| Type | Description | Examples |
|---|---|---|
| API Connector | Call external REST APIs | Shopee, Shopify, Stripe, Google Sheets |
| Notification Channel | New notification delivery methods | Slack, Discord, WhatsApp |
Plan Requirements
| Plan | Plugin Access |
|---|---|
| Trial / Starter | Not available |
| Pro | Up to 3 plugins |
| Scale | Up to 10 plugins |
| Enterprise | Unlimited + custom plugins |
Security
- Credentials encrypted at rest using Fernet symmetric encryption
- Encryption keys are org-scoped (derived from org ID + server secret)
- Credentials are never returned in API responses — only masked indicators (e.g.,
sk-****1234) - All plugin executions are logged with sanitized request/response data
- External API errors are caught gracefully and logged as execution failures
Next Steps
- Installing Plugins — Install from the marketplace
- Configuring Plugins — Set up credentials and test connections
- Agent Integration — Assign plugins to agents