FC Extensions Overview

FC Extensions do not change the basic usage of the E2B SDK or CLI. Applications still use the E2B SDK to create sandboxes, run commands, and read or write files. Capabilities such as VPC, custom domains, OSS, logs, and monitoring take effect through the Function Compute console, the cloud sandbox control plane, or related Alibaba Cloud service configuration. Before integrating, first confirm the configuration entry, scope of effect, and activation status of the target capability.

Feature List

• VPC Network Configuration: Allow a sandbox to access databases, private APIs, container registries, or other cloud resources inside a VPC.

• Custom Domains: Use a fixed domain name and your own certificate to access FC Agent Sandbox APIs and services inside the sandbox.

• Dynamic OSS Mounts: Mount an OSS path into the sandbox through metadata and read or write objects through local file paths.

• Monitoring and Logs: View the running status and resource metrics of a sandbox, and collect logs printed to stdout / stderr by programs inside the sandbox into Simple Log Service.

• Team Quota Management: Set CPU and memory quotas for a specified Team through the Alibaba Cloud POP SDK. For creating Teams, resource groups, and subscription plans, see Teams and Subscription Plans.

• Create an OSS Volume: Create a reusable Volume mount configuration for an OSS Bucket or bucket sub-directory.

• Create an AgenticFS Volume: Create a reusable Volume mount configuration for an AgenticFS AgenticSpace Access Point.

How to Use

1. Confirm whether the extension capability is activated, and the scope in which the configuration takes effect for accounts, regions, templates, sandboxes, or sessions.

2. Complete the extension configuration in Function Compute, the cloud sandbox control plane, or related cloud products.

3. Use the E2B SDK or CLI to create a sandbox.

4. Access the configured network or paths from inside the sandbox, or have programs inside the sandbox output structured logs.

5. View the results in the console, Simple Log Service, or monitoring pages.

Notes

• FC Extensions are not new methods in the E2B SDK, so you do not need to change how the SDK is imported.

• VPC, custom domains, OSS, logs, and monitoring require cloud-side configuration first. The code examples only show how to use and verify them from the application side.

• If the console does not currently show the corresponding cloud sandbox configuration entry, refer to the cloud sandbox control plane documentation, or contact product support to confirm how to activate it.

• Do not expose long-lived credentials in templates, environment variables, logs, or mount paths.

For more configuration details, see the official documentation:

• Monitoring and Logs

• VPC Network Configuration

• Custom Domains

• Dynamic OSS Mounts

• Quota Management

• Create an OSS Volume

• Create an AgenticFS Volume