From 8e5a9ad2c6bfe7e4b53e7e57c1655834340712c9 Mon Sep 17 00:00:00 2001 From: Hugo Bernier Date: Wed, 10 Jan 2024 22:43:33 -0500 Subject: [PATCH] Updated readme, container --- .../.devcontainer/devcontainer.json | 39 +++++++++++++++++++ .../.devcontainer/spfx-startup.sh | 33 ++++++++++++++++ samples/react-azure-openai-api-stream/.nvmrc | 1 + .../react-azure-openai-api-stream/README.md | 35 ++++++++++------- .../assets/sample.json | 4 +- .../package-lock.json | 2 +- .../package.json | 4 +- 7 files changed, 99 insertions(+), 19 deletions(-) create mode 100644 samples/react-azure-openai-api-stream/.devcontainer/devcontainer.json create mode 100644 samples/react-azure-openai-api-stream/.devcontainer/spfx-startup.sh create mode 100644 samples/react-azure-openai-api-stream/.nvmrc diff --git a/samples/react-azure-openai-api-stream/.devcontainer/devcontainer.json b/samples/react-azure-openai-api-stream/.devcontainer/devcontainer.json new file mode 100644 index 0000000000..1d500d525b --- /dev/null +++ b/samples/react-azure-openai-api-stream/.devcontainer/devcontainer.json @@ -0,0 +1,39 @@ +// For more information on how to run this SPFx project in a VS Code Remote Container, please visit https://aka.ms/spfx-devcontainer +{ + "name": "SPFx 1.18.2", + "image": "docker.io/m365pnp/spfx:1.18.2", + "customizations": { + "vscode": { + "extensions": [ + "editorconfig.editorconfig", + "dbaeumer.vscode-eslint" + ] + } + }, + "forwardPorts": [ + 4321, + 35729, + 5432 + ], + "portsAttributes": { + "4321": { + "protocol": "https", + "label": "Manifest", + "onAutoForward": "silent", + "requireLocalPort": true + }, + "5432": { + "protocol": "https", + "label": "Workbench", + "onAutoForward": "silent" + }, + "35729": { + "protocol": "https", + "label": "LiveReload", + "onAutoForward": "silent", + "requireLocalPort": true + } + }, + "postCreateCommand": "bash .devcontainer/spfx-startup.sh", + "remoteUser": "node" +} \ No newline at end of file diff --git a/samples/react-azure-openai-api-stream/.devcontainer/spfx-startup.sh b/samples/react-azure-openai-api-stream/.devcontainer/spfx-startup.sh new file mode 100644 index 0000000000..456d6aea8b --- /dev/null +++ b/samples/react-azure-openai-api-stream/.devcontainer/spfx-startup.sh @@ -0,0 +1,33 @@ +echo +echo -e "\e[1;94mInstalling Node dependencies\e[0m" +npm install + +## commands to create dev certificate and copy it to the root folder of the project +echo +echo -e "\e[1;94mGenerating dev certificate\e[0m" +gulp trust-dev-cert + +# Convert the generated PEM certificate to a CER certificate +openssl x509 -inform PEM -in ~/.rushstack/rushstack-serve.pem -outform DER -out ./spfx-dev-cert.cer + +# Copy the PEM ecrtificate for non-Windows hosts +cp ~/.rushstack/rushstack-serve.pem ./spfx-dev-cert.pem + +## add *.cer to .gitignore to prevent certificates from being saved in repo +if ! grep -Fxq '*.cer' ./.gitignore + then + echo "# .CER Certificates" >> .gitignore + echo "*.cer" >> .gitignore +fi + +## add *.pem to .gitignore to prevent certificates from being saved in repo +if ! grep -Fxq '*.pem' ./.gitignore + then + echo "# .PEM Certificates" >> .gitignore + echo "*.pem" >> .gitignore +fi + +echo +echo -e "\e[1;92mReady!\e[0m" + +echo -e "\n\e[1;94m**********\nOptional: if you plan on using gulp serve, don't forget to add the container certificate to your local machine. Please visit https://aka.ms/spfx-devcontainer for more information\n**********" \ No newline at end of file diff --git a/samples/react-azure-openai-api-stream/.nvmrc b/samples/react-azure-openai-api-stream/.nvmrc new file mode 100644 index 0000000000..0c19c7b446 --- /dev/null +++ b/samples/react-azure-openai-api-stream/.nvmrc @@ -0,0 +1 @@ +v16.18.1 diff --git a/samples/react-azure-openai-api-stream/README.md b/samples/react-azure-openai-api-stream/README.md index 267acca16c..2a08e52761 100644 --- a/samples/react-azure-openai-api-stream/README.md +++ b/samples/react-azure-openai-api-stream/README.md @@ -2,13 +2,27 @@ ## Summary -This webpart shows how you can call Azure OpenAI API in Streaming mode, so the webpart shows the data coming from the API in chunks, giving a much better user experience, so you are not waiting for the entire response. It also shows how you can cancel the streaming response at any point, which is useful to safe some tokens (hence money), if the generating response does not look good to you (like when getting AI hallucinations). +This web part shows how you can call Azure OpenAI API in Streaming mode, so the web part shows the data coming from the API in chunks, giving a much better user experience, so you are not waiting for the entire response. It also shows how you can cancel the streaming response at any point, which is useful to safe some tokens (hence money), if the generating response does not look good to you (like when getting AI hallucinations). ![./assets/react-azure-openai-api-stream.gif](./assets/react-azure-openai-api-stream.gif) -## Used SharePoint Framework Version +## Compatibility -![version](https://img.shields.io/badge/version-1.18.2-green.svg) +| :warning: Important | +|:---------------------------| +| Every SPFx version is optimally compatible with specific versions of Node.js. In order to be able to build this sample, you need to ensure that the version of Node on your workstation matches one of the versions listed in this section. This sample will not work on a different version of Node.| +|Refer to for more information on SPFx compatibility. | + +This sample is optimally compatible with the following environment configuration: + +![SPFx 1.18.2](https://img.shields.io/badge/SPFx-1.18.2-green.svg) +![Node.js v16 | v18](https://img.shields.io/badge/Node.js-v16%20%7C%20v18-green.svg) +![Compatible with SharePoint Online](https://img.shields.io/badge/SharePoint%20Online-Compatible-green.svg) +![Does not work with SharePoint 2019](https://img.shields.io/badge/SharePoint%20Server%202019-Incompatible-red.svg "SharePoint Server 2019 requires SPFx 1.4.1 or lower") +![Does not work with SharePoint 2016 (Feature Pack 2)](https://img.shields.io/badge/SharePoint%20Server%202016%20(Feature%20Pack%202)-Incompatible-red.svg "SharePoint Server 2016 Feature Pack 2 requires SPFx 1.1") +![Local Workbench Unsupported](https://img.shields.io/badge/Local%20Workbench-Unsupported-red.svg "Local workbench is no longer available as of SPFx 1.13 and above") +![Hosted Workbench Compatible](https://img.shields.io/badge/Hosted%20Workbench-Compatible-green.svg) +![Compatible with Remote Containers](https://img.shields.io/badge/Remote%20Containers-Compatible-green.svg) ## Applies to @@ -28,11 +42,9 @@ This webpart shows how you can call Azure OpenAI API in Streaming mode, so the w - Grab the Azure OpenAI Key, Endpoint and the deployment model created in previous step (go to your _Azure OpenAI service -> Keys and Endpoint_) -## Solution +## Contributors -| Solution | Author(s) | -| ----------- | ------------------------------------------------------- | -| react-azure-openai-api-stream | [Luis Mañez](https://github.com/luismanez) | +- [Luis Mañez](https://github.com/luismanez) | ## Version history @@ -40,22 +52,17 @@ This webpart shows how you can call Azure OpenAI API in Streaming mode, so the w | ------- | ---------------- | --------------- | | 1.0 | January 2, 2024 | Initial release | -## Disclaimer - -**THIS CODE IS PROVIDED _AS IS_ WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.** - ---- ## Minimal Path to Awesome -- Install the MS Graph Toolkit for SPFx package. [Follow this](https://learn.microsoft.com/graph/toolkit/get-started/mgt-spfx) +- [Install the MS Graph Toolkit for SPFx package](https://learn.microsoft.com/graph/toolkit/get-started/mgt-spfx). - Clone this repository - Ensure that you are at the solution folder - in the command-line run: - `npm install` - `gulp serve` - Add the web part in the SharePoint workbench or any SharePoint page (appending _?debug=true&noredir=true&debugManifestsFile=_ to the page URL) -- Edit the webpart with your Azure OpenAI API values (see _prerequisites_ section) +- Edit the web part with your Azure OpenAI API values (see _prerequisites_ section) ## Features diff --git a/samples/react-azure-openai-api-stream/assets/sample.json b/samples/react-azure-openai-api-stream/assets/sample.json index d1b306a95e..554b84f91d 100644 --- a/samples/react-azure-openai-api-stream/assets/sample.json +++ b/samples/react-azure-openai-api-stream/assets/sample.json @@ -3,11 +3,11 @@ "name": "pnp-sp-dev-spfx-web-parts-react-azure-openai-api-stream", "source": "pnp", "title": "Calling Azure OpenAI API in stream mode", - "shortDescription": "This webpart shows how you can call Azure OpenAI API in Streaming mode", + "shortDescription": "This web part shows how you can call Azure OpenAI API in Streaming mode", "url": "https://github.com/pnp/sp-dev-fx-webparts/tree/main/samples/react-azure-openai-api-stream", "downloadUrl": "https://pnp.github.io/download-partial/?url=https://github.com/pnp/sp-dev-fx-webparts/tree/main/samples/react-azure-openai-api-stream", "longDescription": [ - "This webpart shows how you can call Azure OpenAI API in Streaming mode, so the webpart shows the data coming from the API in chunks, giving a much better user experience, so you are not waiting for the entire response. It also shows how you can cancel the streaming response at any point, which is useful to safe some tokens (hence money), if the generating response does not look good to you (like when getting AI hallucinations)." + "This web part shows how you can call Azure OpenAI API in Streaming mode, so the web part shows the data coming from the API in chunks, giving a much better user experience, so you are not waiting for the entire response. It also shows how you can cancel the streaming response at any point, which is useful to safe some tokens (hence money), if the generating response does not look good to you (like when getting AI hallucinations)." ], "creationDateTime": "2024-01-02", "updateDateTime": "2024-01-02", diff --git a/samples/react-azure-openai-api-stream/package-lock.json b/samples/react-azure-openai-api-stream/package-lock.json index 11d958e0d4..46c5b81cd3 100644 --- a/samples/react-azure-openai-api-stream/package-lock.json +++ b/samples/react-azure-openai-api-stream/package-lock.json @@ -11,7 +11,7 @@ "@fluentui/react": "^8.106.4", "@microsoft/fetch-event-source": "^2.0.1", "@microsoft/mgt-react": "^3.0.1", - "@microsoft/mgt-spfx": "^3.0.1", + "@microsoft/mgt-spfx": "^3.1.3", "@microsoft/sp-component-base": "1.18.2", "@microsoft/sp-core-library": "1.18.2", "@microsoft/sp-lodash-subset": "1.18.2", diff --git a/samples/react-azure-openai-api-stream/package.json b/samples/react-azure-openai-api-stream/package.json index 8c7c33f3c9..026d171daa 100644 --- a/samples/react-azure-openai-api-stream/package.json +++ b/samples/react-azure-openai-api-stream/package.json @@ -13,9 +13,9 @@ }, "dependencies": { "@fluentui/react": "^8.106.4", - "@microsoft/mgt-react": "^3.0.1", - "@microsoft/mgt-spfx": "^3.0.1", "@microsoft/fetch-event-source": "^2.0.1", + "@microsoft/mgt-react": "^3.0.1", + "@microsoft/mgt-spfx": "^3.1.3", "@microsoft/sp-component-base": "1.18.2", "@microsoft/sp-core-library": "1.18.2", "@microsoft/sp-lodash-subset": "1.18.2",