Automating tasks is the core of PowerShell scripting. Adding artificial intelligence into the mix takes automation to a whole new level. Today, we’ll simplify the process of connecting to OpenAI’s powerful text summarization API from PowerShell. Let’s turn complex AI interaction into a straightforward script.<\/p>\n
To follow this guide, you’ll need an OpenAI API key. If you don’t already have one, you’ll need to create an OpenAI account<\/a> or sign in<\/a> to an existing one. Next, navigate to the API key page<\/a> and create a new secret key to use.<\/p>\n We’ll start by setting up our function with parameters such as the API key and text to summarize:<\/p>\n Next, we’ll prepare our connection to OpenAI’s API by specifying the URL and headers:<\/p>\n We need to tell the API what we want it to do: summarize text. We do this in the request body:<\/p>\n The final part of the function sends the request and then gets the summary back from the API:<\/p>\n Now, to use the function, you just need two pieces of information: your OpenAI API key and the text to summarize.<\/p>\n Replace Here’s a how I am running this function in my local PowerShell prompt, I copied the text from Wikipedia:<\/p>\n and I get the following result:<\/p>\n Combining AI with PowerShell scripting is like giving superpowers to your computer. By breaking down each step and keeping it simple, you can see how easy it is to automate text summarization using OpenAI’s GPT-3.5 API. Now, try it out and see how you can make this script work for you!<\/p>\n Remember, the beauty of scripts is in their flexibility, so feel free to tweak and expand the function to fit your needs.<\/p>\n Happy scripting and enjoy the power of AI at your fingertips!<\/p>\nStep-by-Step Function Creation<\/h2>\n
Step 1: Define the Function and Parameters<\/h3>\n
function Invoke-OpenAISummarize {\n param(\n [string]$apiKey,\n [string]$textToSummarize,\n [int]$maxTokens = 60,\n [string]$engine = 'davinci'\n )\n # You can add or remove parameters as per your requirements\n}<\/code><\/pre>\nStep 2: Set Up API Connection Details<\/h3>\n
$uri = \"https:\/\/api.openai.com\/v1\/engines\/$engine\/completions\"\n $headers = @{\n 'Authorization' = \"Bearer $apiKey\"\n 'Content-Type' = 'application\/json'\n }<\/code><\/pre>\nStep 3: Construct the Body of the Request<\/h3>\n
$body = @{\n prompt = \"Summarize the following text: `\"$textToSummarize`\"\"\n max_tokens = $maxTokens\n n = 1\n } | ConvertTo-Json<\/code><\/pre>\nStep 4: Make the API Request and Return the Summary<\/h3>\n
$parameters = @{\n Method = 'POST'\n URI = $uri\n Headers = $headers\n Body = $body\n ErrorAction = 'Stop'\n }\n\n try {\n $response = Invoke-RestMethod @parameters\n return $response.choices[0].text.Trim()\n } catch {\n Write-Error \"Failed to invoke OpenAI API: $_\"\n return $null\n }\n}<\/code><\/pre>\nRunning the Function<\/h2>\n
$summary = Invoke-OpenAISummarize -apiKey 'Your_Key' -textToSummarize 'Your text...'\nWrite-Output \"Summary: $summary\"<\/code><\/pre>\n'Your__Key'<\/code> with your actual key and 'Your text...'<\/code> with what you want to summarize.<\/p>\n$summary = Invoke-OpenAISummarize -apiKey '*********' -textToSummarize @'\nPowerShell is a task automation and configuration management program from\nMicrosoft, consisting of a command-line shell and the associated scripting\nlanguage. Initially a Windows component only, known as Windows PowerShell,\nit was made open-source and cross-platform on August 18, 2016, with the\nintroduction of PowerShell Core.[5] The former is built on the .NET Framework,\nthe latter on .NET (previously .NET Core).\n'@<\/code><\/pre>\nPowerShell, initially Windows-only, is a Microsoft automation tool that became\ncross-platform as open-source PowerShell Core, transitioning from .NET Framework\nto .NET.\n<\/code><\/pre>\nConclusion<\/h2>\n
References<\/h2>\n