Core Concepts

Conceptual Landscape

Understand providers, integrations, tools, credentials, and execution.

Core concepts

DataFuse separates the description of an API from a user's connection to that API and from each individual tool execution.

Provider

A provider describes an external service: its category, authentication methods, actions, and optional triggers. Providers can come from the catalog or from a custom definition.

Integration

An integration is a configured provider connection for a DataFuse user or organization. It records which provider is being used and how DataFuse should resolve that connection during execution.

Tool

A tool is an agent-callable action derived from a provider definition. Each tool has a name, description, input schema, and execution target.

Credential flow

Connected credentials are stored in the server-side integration layer and resolved when a tool runs. Do not place provider API keys or access tokens in prompts, client-side configuration, examples, or support requests.

Logs and audit events

Execution results and organization audit events are different data surfaces. Organization audit events can be forwarded to a configured webhook without being persisted in the DataFuse audit table when zero-retention audit mode is enabled.