agent adl create

Create an Agentforce Data Library.

Creates a new data library in the target org. The –source-type flag determines the type of library: SFDRIVE (file upload), KNOWLEDGE (Salesforce Knowledge articles), or RETRIEVER (existing active Custom Retriever).

For SFDRIVE libraries, creation provisions the full Data Cloud pipeline (DLO → DMO → SearchIndex → Retriever). Upload files with sf agent adl upload after creation.

Flag Name (Long)	Flag Name (Short)	Description
`‑‑api‑version`	N/A	Type: Value Override the api version used for api requests made by this command
`‑‑content‑fields`	N/A	Type: Value Comma-separated list of content fields for KNOWLEDGE libraries (optional, mutable after creation).
`‑‑data‑category‑ids`	N/A	Type: Value Comma-separated list of data category selection IDs for KNOWLEDGE libraries. Mutually exclusive with –data-category-names (provide one or the other, not both).
`‑‑data‑category‑names`	N/A	Type: Value Comma-separated list of data category names in qualified format (e.g., “Group_API_Name.Category”). Mutually exclusive with –data-category-ids (provide one or the other, not both).
`‑‑description`	N/A	Type: Value Description of the data library (max 255 characters).
`‑‑developer‑name`	N/A	Type: Value Required API name for the data library (max 80 characters, alphanumeric and underscores only, must start with a letter).
`‑‑flags‑dir`	N/A	Type: Value Import flag values from a directory.
`‑‑index‑mode`	N/A	Type: Value Valid Values: `basic`, `enhanced` Index mode for SFDRIVE libraries: basic or enhanced.
`‑‑json`	N/A	Type: Boolean Format output as json.
`‑‑name`	`‑n`	Type: Value Required Display name for the data library (max 80 characters).
`‑‑primary‑index‑field1`	N/A	Type: Value Primary index field 1 for KNOWLEDGE libraries (required, immutable after creation).
`‑‑primary‑index‑field2`	N/A	Type: Value Primary index field 2 for KNOWLEDGE libraries (required, immutable after creation).
`‑‑retriever‑id`	N/A	Type: Value ID of an active Custom Retriever (required for RETRIEVER source type; retriever must be active).
`‑‑source‑type`	N/A	Type: Value Required Valid Values: `sfdrive`, `knowledge`, `retriever` Type of grounding source: sfdrive (file upload), knowledge (Salesforce Knowledge articles), or retriever (existing active Custom Retriever).
`‑‑target‑org`	`‑o`	Type: Value Required Username or alias of the target org. Not required if the `target-org` configuration variable is already set.
`‑‑wait`	`‑w`	Type: Value Wait N minutes for indexing to complete (KNOWLEDGE libraries). SFDRIVE libraries require upload before indexing; RETRIEVER libraries are ready immediately.

Create an SFDRIVE library:

Create a KNOWLEDGE library with index fields:

Create a RETRIEVER library: