Getting started Community Training Tutorials Documentation APIs, AI & Tools
String
Einstein AI Connector provides access to the Salesforce Einstein Trust Layer through the Models APIs.
Default configuration
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Name |
String |
Name for this configuration. Connectors reference the configuration with this name. |
x |
|
Connection |
The connection types to provide to this configuration. |
x |
||
Read Timeout |
Number |
Read timeout value. |
30 |
|
Read Timeout Unit |
Enumeration, one of:
|
Time unit for the Read Timeout field. |
SECONDS |
|
Name |
String |
ID used to reference this configuration. |
x |
|
Expiration Policy |
Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. |
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Proxy Configuration |
One of: |
Configures a proxy for outbound connections. |
||
Max Connections |
Number |
Maximum number of outbound connections to keep open at the same time. |
-1 |
|
Connection Timeout |
Number |
Amount of time to wait when initially establishing the TCP connection between the connector and Salesforce Agent before throwing an exception if the connection fails. |
30 |
|
Connection Timeout Unit |
Enumeration, one of:
|
Time unit for the Connection Timeout field. |
SECONDS |
|
Connection Idle Timeout |
Number |
Number of units that a connection can remain idle before it is closed. |
30 |
|
Connection Idle Timeout Unit |
Enumeration, one of:
|
Time unit for the Connection Idle Timeout field. |
SECONDS |
|
TLS Configuration |
Protocol to use for communication. |
|||
Reconnection |
When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy. |
|||
Client Id |
String |
The OAuth public client ID as registered with the service provider. |
x |
|
Client Secret |
String |
The OAuth client secret that corresponds to the client ID. |
x |
|
Token Url |
String |
The service provider’s token endpoint URL. |
|
|
Scopes |
String |
The OAuth scopes to request during the OAuth dance. If not provided, it defaults the scopes in the annotation. |
||
Object Store |
String |
A reference to the object store to use to store each resource owner ID’s data. If not specified, Mule runtime automatically provisions the default one. |
<ms-einstein-ai:agent-define-prompt-template>
Use the Agent define prompt template operation to use specific prompt templates. The prompt template language is a simple way to define and compose AI functions using plain text. You can use it to create natural language prompts, generate responses, extract information, invoke other prompts, or perform any other task that can be expressed with text.
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Template |
String |
Prompt template for the operation. |
#[payload] |
|
Instructions |
String |
Instructions for the LLM, outlining the goals of the task. |
x |
|
Dataset |
String |
Dataset for the LLM to evaluate using the provided template and instructions. |
x |
|
Output Mime Type |
String |
MIME type of the payload this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload this operation outputs. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration to use to execute this component. |
x |
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Model API Name |
String |
Name of the API model that interacts with the LLM. |
sfdc_ai__DefaultOpenAIGPT35Turbo |
|
Probability |
Number |
Probability of the model API staying accurate. |
0.8 |
|
Locale |
String |
Localization information, which can include the default locale, input locale(s), and expected output locale(s). |
en_US |
|
Read Timeout |
Number |
Read timeout value. |
||
Read Timeout Unit |
Enumeration, one of:
|
Time unit for the Read Timeout field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
<ms-einstein-ai:chat-answer-prompt>
The Chat answer prompt operation sends a prompt request to the configured LLM. It uses a plain text prompt as input and responds with a plain text answer.
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Prompt |
String |
Plain text prompt to send to the LLM. |
#[payload] |
|
Output Mime Type |
String |
MIME type of the payload this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload this operation outputs. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration to use to execute this component. |
x |
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Model API Name |
String |
Name of the API model that interacts with the LLM. |
sfdc_ai__DefaultOpenAIGPT35Turbo |
|
Probability |
Number |
Probability of the model API staying accurate. |
0.8 |
|
Locale |
String |
Localization information, which can include the default locale, input locale(s), and expected output locale(s). |
en_US |
|
Read Timeout |
Number |
Read timeout value. |
||
Read Timeout Unit |
Enumeration, one of:
|
Time unit for the Read Timeout field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
<ms-einstein-ai:chat-generate-from-messages>
The Chat generate from messages operation is a prompt request operation with provided messages to the configured LLM. It uses a plain text prompt as input and responds with a plain text answer.
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Messages |
Any |
#[payload] |
||
Output Mime Type |
String |
MIME type this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload this operation outputs. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration to use to execute this component. |
x |
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Model API Name |
String |
Name of the API model that interacts with the LLM. |
sfdc_ai__DefaultOpenAIGPT35Turbo |
|
Probability |
Number |
Probability of the model API staying accurate. |
0.8 |
|
Locale |
String |
Localization information, which can include the default locale, input locale(s), and expected output locale(s). |
en_US |
|
Read Timeout |
Number |
Read timeout value. |
||
Read Timeout Unit |
Enumeration, one of:
|
Time unit for the Read Timeout field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
<ms-einstein-ai:embedding-adhoc-file-query>
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Prompt |
String |
Plain text prompt to send to the LLM. |
x |
|
Input Stream |
Any |
Document content to ingest into the embedding store. |
x |
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration to use to execute this component. |
x |
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Model API Name |
String |
Name of the API model that interacts with the LLM. |
sfdc_ai__DefaultOpenAITextEmbeddingAda_002 |
|
File Type |
Enumeration, one of:
|
Type of the document provided as input. |
||
Option Type |
Enumeration, one of:
|
How to split the loaded document before embedding. |
FULL |
|
Read Timeout |
Number |
Read timeout value. |
||
Read Timeout Unit |
Enumeration, one of:
|
Time unit for the Read Timeout field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
<ms-einstein-ai:embedding-generate-from-file>
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Input Stream |
Any |
#[payload] |
||
Output Mime Type |
String |
The MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration to use to execute this component. |
x |
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Model API Name |
String |
sfdc_ai__DefaultOpenAITextEmbeddingAda_002 |
||
File Type |
Enumeration, one of:
|
Type of the document provided as input. |
||
Option Type |
Enumeration, one of:
|
How to split the loaded document before embedding. |
FULL |
|
Read Timeout |
Number |
Read timeout value. |
||
Read Timeout Unit |
Enumeration, one of:
|
Time unit for the Read Timeout field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
<ms-einstein-ai:embedding-generate-from-text>
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Text |
String |
#[payload] |
||
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration to use to execute this component. |
x |
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Model API Name |
String |
sfdc_ai__DefaultOpenAITextEmbeddingAda_002 |
||
Read Timeout |
Number |
Read timeout value. |
||
Read Timeout Unit |
Enumeration, one of:
|
Time unit for the Read Timeout field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings |
||
Reconnection Strategy |
A retry strategy in case of connectivity errors |
<ms-einstein-ai:rag-adhoc-load-document>
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Prompt |
String |
Plain text prompt to send to the LLM. |
x |
|
Input Stream |
Any |
Document content to ingest into the embedding store. |
x |
|
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration to use to execute this component. |
x |
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Model API Name |
String |
Name of the API model that interacts with the LLM. |
sfdc_ai__DefaultOpenAIGPT35Turbo |
|
Probability |
Number |
Probability of the model API staying accurate. |
0.8 |
|
Locale |
String |
Localization information, which can include the default locale, input locale(s), and expected output locale(s). |
en_US |
|
Embedding Name |
String |
sfdc_ai__DefaultOpenAITextEmbeddingAda_002 |
||
Option Type |
Enumeration, one of:
|
How to split the loaded document before embedding. |
FULL |
|
File Type |
Enumeration, one of:
|
Type of the document provided as input. |
||
Read Timeout |
Number |
Read timeout value. |
||
Read Timeout Unit |
Enumeration, one of:
|
Time unit for the Read Timeout field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
<ms-einstein-ai:tools-use-ai-service>
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Prompt |
String |
Plain text prompt to send to the LLM. |
#[payload] |
|
Input Stream |
Any |
x |
||
Output Mime Type |
String |
MIME type of the payload that this operation outputs. |
||
Output Encoding |
String |
Encoding of the payload that this operation outputs. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration to use to execute this component. |
x |
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Model API Name |
String |
Name of the API model that interacts with the LLM. |
sfdc_ai__DefaultOpenAIGPT35Turbo |
|
Probability |
Number |
Probability of the model API staying accurate. |
0.8 |
|
Locale |
String |
Localization information, which can include the default locale, input locale(s), and expected output locale(s). |
en_US |
|
Read Timeout |
Number |
Read timeout value. |
||
Read Timeout Unit |
Enumeration, one of:
|
Time unit for the Read Timeout field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The expression outcome is stored in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
<ms-einstein-ai:unauthorize>
Deletes all the access token information of a given resource owner ID so that it’s impossible to execute any operation for that user without repeating the OAuth dance.
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Config Ref |
ConfigurationProvider |
Name of the configuration to use to execute this component. |
x |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Enabled Protocols |
String |
Comma-separated list of protocols enabled for this context. |
||
Enabled Cipher Suites |
String |
Comma-separated list of cipher suites enabled for this context. |
||
Trust Store |
||||
Key Store |
||||
Revocation Check |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Path |
String |
The location (which will be resolved relative to the current classpath and file system, if possible) of the truststore. |
||
Password |
String |
Password that protects the truststore. |
||
Type |
String |
Type of truststore. |
||
Algorithm |
String |
Encryption algorithm that the truststore uses. |
||
Insecure |
Boolean |
If |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Path |
String |
Path to the keystore. Mule resolves the path relative to the current classpath and file system, if possible. |
||
Type |
String |
Type of keystore to use. |
||
Alias |
String |
Alias of the key to use when the keystore contains multiple private keys. By default, Mule uses the first key in the file. |
||
Key Password |
String |
Password used to protect the private key. |
||
Password |
String |
Password used to protect the keystore. |
||
Algorithm |
String |
Encryption algorithm that the keystore uses. |
Configures standard revocation checks for TLS certificates.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Only End Entities |
Boolean |
Which elements to verify in the certificate chain:
|
||
Prefer Crls |
Boolean |
How to check certificate validity:
|
||
No Fallback |
Boolean |
Whether to use the secondary method to check certificate validity:
|
||
Soft Fail |
Boolean |
What to do if the revocation server can’t be reached or is busy:
|
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Url |
String |
URL of the OCSP responder. |
||
Cert Alias |
String |
Alias of the signing certificate for the OCSP response (must be in the truststore), if present. |
Configures a reconnection strategy for an operation.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Fails Deployment |
Boolean |
When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy. |
||
Reconnection Strategy |
Reconnection strategy to use. |
Configures a standard reconnection strategy, which specifies how often to reconnect and how many reconnection attempts the connector source or operation can make.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Frequency |
Number |
How often to attempt to reconnect, in milliseconds. |
||
Blocking |
Boolean |
If |
||
Count |
Number |
How many reconnection attempts the Mule app can make. |
Configures a forever reconnection strategy by which the connector source or operation attempts to reconnect at a specified frequency for as long as the Mule app runs.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Frequency |
Number |
How often to attempt to reconnect, in milliseconds. |
||
Blocking |
Boolean |
If |
Configures an expiration policy strategy.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Max Idle Time |
Number |
Configures the maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. |
||
Time Unit |
Enumeration, one of:
|
Time unit for the Max Idle Time field. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Content Quality |
||||
Generation Id |
String |
|||
Generation Parameters |
||||
Response Id |
String |
|||
Response Parameters |
Content moderation details for generated content, including its safety and quality scores.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Scan Toxicity |
Scans content for toxicity. |
Represents safety and toxicity data.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Categories |
Array of Categories |
|||
Is Detected |
Boolean |
Indicates whether a scan detected any toxic content. When the |
The array of toxicity categories.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Category Name |
String |
Name of the category. |
||
Score |
String |
A toxicity score value from 0 to 1. A higher score means the response is more likely to be toxic. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Annotations |
Array of String |
|||
Finish Reason |
String |
|||
Index |
Number |
|||
Logprobs |
String |
|||
Refusal |
String |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Model |
String |
|||
Object |
String |
|||
System Fingerprint |
String |
|||
Token Usage |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Completion Token Details |
||||
Input Count |
Number |
Number of tokens the LLM receives from the prompt. |
||
Output Count |
Number |
Number of tokens the LLM generates in response to the input tokens. |
||
Prompt Token Details |
||||
Total Count |
Number |
Requesting a large number of generated tokens completions can cause increased latencies.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Accepted Prediction Tokens |
Number |
Number of accepted prediction tokens. |
||
Audio Tokens |
Number |
Number of audio tokens completions. |
||
Reasoning Tokens |
Number |
Number of tokens for reasoning and outputs. |
||
Rejected Prediction Tokens |
Number |
Number of prediction tokens the LLM generated that were later discarded because they were deemed incorrect or not useful within the context. |
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Audio Tokens |
Number |
Number of audio tokens in the prompt. |
||
Cached Tokens |
Number |
Number of cached tokens in the prompt. |
Configures the in-memory streaming strategy by which the request fails if the data exceeds the MAX buffer size. Always run performance tests to find the optimal buffer size for your specific use case.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Initial Buffer Size |
Number |
Initial amount of memory to allocate to the data stream. If the streamed data exceeds this value, the buffer expands by Buffer Size Increment, with an upper limit of Max Buffer Size. |
||
Buffer Size Increment |
Number |
This is by how much the buffer size expands if it exceeds its initial size. Setting a value of zero or lower means that the buffer should not expand, meaning that a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised when the buffer gets full. |
||
Max Buffer Size |
Number |
Maximum size of the buffer. If the buffer size exceeds this value, Mule raises a |
||
Buffer Unit |
Enumeration, one of:
|
Unit for the Initial Buffer Size, Buffer Size Increment, and Max Buffer Size fields. |
Configures the repeatable file-store streaming strategy by which Mule keeps a portion of the stream content in memory. If the stream content is larger than the configured buffer size, Mule backs up the buffer’s content to disk and then clears the memory.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
In Memory Size |
Number |
Maximum amount of memory that the stream can use for data. If the amount of memory exceeds this value, Mule buffers the content to disk. To optimize performance:
|
||
Buffer Unit |
Enumeration, one of:
|
Unit for the In Memory Size field. |