PromptOpenAI
Description
Sends a prompt to OpenAI, writing the response either as a FlowFile attribute or to the contents of the incoming FlowFile. The prompt may consist of pure text interaction or may include images. In the case of images, a URL may be provided, or the contents of the FlowFile may be used, depending on the provided configuration
Tags
ai, chat, image, openai, prompt, text
Properties
In the list below required Properties are shown with an asterisk (*). Other properties are considered optional. The table also indicates any default values, and whether a property supports the NiFi Expression Language.
| Display Name | API Name | Default Value | Allowable Values | Description |
|---|---|---|---|---|
| Web Client Service * | Web Client Service | Controller Service: WebClientServiceProvider Implementations: StandardWebClientServiceProvider | The Web Client Service to use for communicating with OpenAI | |
| OpenAI API Key * | OpenAI API Key | The API Key for authenticating to OpenAI | ||
| OpenAI Organization | OpenAI Organization | The organization to use for OpenAI Supports Expression Language, using FlowFile attributes and Environment variables. | ||
| Prompt Type * | Prompt Type | Text |
| The type of prompt to send to OpenAI |
| Text Model Name * | Text Model Name | gpt-4o-mini | The name of the OpenAI model Supports Expression Language, using FlowFile attributes and Environment variables. This property is only considered if:
| |
| Image Model Name * | Image Model Name | gpt-4o-mini | The name of the OpenAI model Supports Expression Language, using FlowFile attributes and Environment variables. This property is only considered if:
| |
| System Message | System Message | The system message to send to OpenAI. FlowFile attributes may be referenced via Expression Language, and the contents of the FlowFile may be referenced via the flowfile_content variable. E.g., ${flowfile_content} Supports Expression Language, using FlowFile attributes and Environment variables. | ||
| User Message * | User Message | The user message to send to OpenAI. FlowFile attributes may be referenced via Expression Language, and the contents of the FlowFile may be referenced via the flowfile_content variable. E.g., ${flowfile_content} Supports Expression Language, using FlowFile attributes and Environment variables. | ||
| Image URL | Image URL | The URL of the image to send to OpenAI. If not specified, the contents of the FlowFile will be used as the image. Supports Expression Language, using FlowFile attributes and Environment variables. This property is only considered if:
| ||
| Image MIME Type | Image MIME Type | ${mime.type} | The MIME type of the image Supports Expression Language, using FlowFile attributes and Environment variables. This property is only considered if:
| |
| Detail Level * | Detail Level | Auto |
| The image detail level that OpenAI should use for processing the image. Low detail will be less expensive and lower latency, while a high level may provide better results. This property is only considered if:
|
| Max File Size | Max File Size | 10 MB | The maximum size of a FlowFile that can be sent to OpenAI as an image. If the FlowFile is larger than this, it will be routed to 'failure'. This property is only considered if:
| |
| Response Format * | Response Format | Plain Text |
| The format of the response from OpenAI This property is only considered if:
|
| User | User | Your end user, sent to OpenAI for monitoring and detection of abuse Supports Expression Language, using FlowFile attributes and Environment variables. | ||
| Temperature | Temperature | The temperature to use for generating the response. Supports Expression Language, using FlowFile attributes and Environment variables. | ||
| Top P | Top P | The top P value to use for generating the response Supports Expression Language, using FlowFile attributes and Environment variables. | ||
| Seed | Seed | The seed to use for generating the response Supports Expression Language, using FlowFile attributes and Environment variables. | ||
| Max Tokens | Max Tokens | The maximum number of tokens to generate Supports Expression Language, using FlowFile attributes and Environment variables. | ||
| Results Attribute | Results Attribute | The name of the attribute to write the response to. If unset, the response will be written to the FlowFile content. |
Dynamic Properties
This component does not support dynamic properties.
Relationships
| Name | Description |
|---|---|
| failure | If unable to obtain a valid response from OpenAI, the original FlowFile will be routed to this relationship |
| success | The response from OpenAI is routed to this relationship |
Reads Attributes
This processor does not read attributes.
Writes Attributes
This processor does not write attributes.
State Management
This component does not store state.
Restricted
This component is not restricted.
Input Requirement
This component requires an incoming relationship.
System Resource Considerations
This component does not specify system resource considerations.