---
isPublished: true
knowledgeIndex: false
hidden: true
noindex: true
template: "page.peb"
title: "AI Prompt SObject Utils Flow Reference"
description: "Inputs, outputs, transaction effects and troubleshooting for AI Prompt SObject Utils in Salesforce Flow."
contentType: "reference"
audience: "admin,developer"
---

# AI Prompt SObject Utils

Read Salesforce record fields and format them as prompt text.
The namespaced Apex action name is `rooms__AIPromptSObjectUtils`.

**Reference status: Limited.** Review the supported behavior and limitations below.

## Transaction summary

| Effect | Behavior |
| --- | --- |
| API callout | No API callout is made. |
| Record writes | No record is inserted, updated or deleted. |
| Background work | No queued work is started. |
| Platform event | The action does not directly publish a platform event. |
| Email | The action does not send email. |

The normal mode reads Record ID. Related-record mode reads the selected child object through the supplied parent lookup field. The output uses Markdown tables.

Serialize to JSON, Extract All SObject Fields, Use Field Label, Use Field API Name and Use Markdown Table Format do not select different output formats in this action. The Record input is not a replacement for Record ID.

## Inputs

Required describes the Flow input setting. Additional conditions are stated in the guidance.

| API name | Flow label | Required | Default or guidance |
| --- | --- | --- | --- |
| `recordId` | Record ID | No | The source record ID, or the parent ID for related records. |
| `record` | Record (The record type being described. Select any record type to bypass this option.) | No | Retained type-selection input. The normal request still needs Record ID. |
| `serializeToJSON` | Serialize to JSON | No | Declared default: `false`. Does not change the Markdown output format. |
| `extractSObjectFields` | Extract All SObject Fields (default=True) | No | Declared default: `true`. Use the explicit field list to limit selected fields. |
| `extractSpecificFields` | Extract specific fields (CSV) | No | Comma-separated field API names to query. Blank selects the available field set. |
| `ignoreNullFields` | Ignore NULL fields | No | Defaults to `true`. Excludes fields with null values. |
| `ignoreIDFields` | Ignore ID fields | No | Defaults to `true`. Excludes ID and lookup fields. |
| `ignoreFields` | Ignore fields list (comma separated) | No | Comma-separated fields to omit in normal record mode. |
| `useFieldLabel` | Use Field Label | No | Declared default: `true`. Field labels remain part of the Markdown output. |
| `useFieldName` | Use Field API Name | No | Declared default: `true`. Field API names remain part of the Markdown output. |
| `useMarkdownFormat` | Use Markdown Table Format (default=true) | No | Declared default: `true`. Output remains Markdown when changed. |
| `describeRelatedRecords` | Describe Related Records | No | Defaults to `false`. Selects related-record mode when enabled. |
| `relatedSObject` | Related Record Type (SObject Name) | No | Full child SObject API name for related-record mode. |
| `relatedSObjectField` | Related Record Parent Field | No | The child lookup-field API name that refers to Record ID. |

## Outputs

| API name | Flow label | Meaning |
| --- | --- | --- |
| `success` | Success | Whether the action reported success. Check this value before continuing. |
| `errorMessage` | Error Message | Record, field or query error details. |
| `output` | Text Output | Readable field information in Markdown tables. |

## Configure the Flow

1. Set Record ID.
2. Set Extract specific fields when only selected fields are required.
3. For related records, enable Describe Related Records and supply the child object and parent lookup API names.
4. Check Success, Error Message and Text Output before using the text in a prompt.

Confirm the Flow user's action access and the required access to the referenced records.
Review the configured Salesforce API connection user's access when the action makes a callout.
Connect the action's Fault path.

## Troubleshooting

**Record access fails.** Confirm that the Flow user can read the record and selected fields.

**The output is empty or fields are absent.** Review null, ID and ignored-field filters and the selected field list. Related records can return `(No records found)`.

**A format toggle has no effect.** This action returns Markdown tables. Do not require JSON output from Serialize to JSON.

Confirm that the action and its fields exist in the installed package.
See the [Flow action index](/content/build/flows/index.md) for related actions and transaction guidance.
