Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
[This topic is prerelease documentation and is subject to change.]
The AI Builder group contains the Create text with GPT (preview) action that creates text using the GPT language model, as well as actions in preview to analyze text sentiment, detect the language of a text, or translate text.
Important
- This is a preview feature.
- Preview features aren't meant for production use and might have restricted functionality.
- These features are available before an official release so that customers can get early access and provide feedback.
Further strengthening our commitment to responsible AI we're introducing some updates related to the utilization of Create text with GPT (preview) action in the Power Automate for desktop October 2023 update. Specifically:
- You must use a Display input dialog action or Display message action with each use of the Create text with GPT action.
- The Display input dialog action or Display message action must contain the response from the Create text with GPT action in its body so it is clearly presented to the user.
Ensure that flows that use the Create text with GPT (preview) action check those two points. If either step is omitted, the respective flow(s) will result in an error.
Also note the following:
- This capability is in process of rolling out and might not be available in your region yet.
- This capability might be subject to usage limits or capacity throttling.
- The GPT model might make mistakes or have biases and other undesirable content. Therefore, to ensure that the AI-generated content is accurate, appropriate, and free from bias, always have humans review it.
- This capability is under gated access. Apply for consideration to take part in the trial. To apply, go to Limited preview request.
After deploying the action, select Create instructions to open the instructions wizard. The wizard allows you to create instructions by using existing templates or start from blank.
Learn more about the Text generation model (preview) in the Text generation model overview (preview).
Important
You must add either a Display input dialog or Display message action and pass either of the generated outputs of the Create text with GPT (preview) action (PredictV2Response, PredictV2TextResponse) in its body. This will require a human review of the generated messages. If either of those steps is omitted, the respective flow(s) will result in an error.
Example approach: Add a Display message action with Yes - No buttons to require a human review of the generated content. An error appears when this action doesn't exist. Learn more about the Display message action in Message boxes actions.
Note
To enable the AI Builder (preview) module in the actions pane, the following requirements need to be in place:
- Copilot is enabled in the Power Platform Admin Center.
- The flag
powerappsmakerbotenabledis true at the organization level:PowerAppsMakerBotEnabled
Create text with GPT (preview)
Get a response generated by GPT.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Instructions | No | Text value | Provide instructions for the GPT model to perform a task |
Variables produced
| Argument | Type | Description |
|---|---|---|
| PredictV2Response | Connector object | |
| PredictV2TextResponse | Text |
Exceptions
| Exception | Description |
|---|---|
| Endpoint failure | Indicates an endpoint failure |
Analyze text sentiment (preview)
Analyze the sentiment of text by using AI Builder.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Text | No | Text value | The text to analyze |
Variables produced
| Argument | Type | Description |
|---|---|---|
| SentimentAnalysisResponse | Connector object | |
| SentimentAnalysisTextResponse | Text |
Exceptions
| Exception | Description |
|---|---|
| Endpoint failure | Indicates an endpoint failure |
Detect language of text (preview)
Detect the natural language of input text by using AI Builder.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Text | No | Text value | The text to analyze |
Variables produced
| Argument | Type | Description |
|---|---|---|
| LanguageDetectionResponse | Connector object | |
| LanguageDetectionTextResponse | Text |
Exceptions
| Exception | Description |
|---|---|
| Endpoint failure | Indicates an endpoint failure |
Translate text (preview)
Translate text to a specified language using AI Builder.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Text to translate | No | Text value | The text to translate | |
| Translate to | No | Text value | The BCP-47 language code of the target language (for example, en, fr, de) | |
| Translate from | Yes | Text value | The BCP-47 language code of the source language (for example, en, fr, de). Leave empty to detect it automatically |
Variables produced
| Argument | Type | Description |
|---|---|---|
| TextTranslationResponse | Connector object | |
| TextTranslationTextResponse | Text |
Exceptions
| Exception | Description |
|---|---|
| Endpoint failure | Indicates an endpoint failure |