Promptflow examples

Get started

Install dependencies

• Bootstrap your python environment.
  • e.g: create a new conda environment. conda create -n pf-examples python=3.9.
  • install required packages in python environment : pip install -r requirements.txt
    • show installed sdk: pip show promptflow

Quick start

path	status	description
quickstart.ipynb		A quickstart tutorial to run a flow and evaluate it.
quickstart-azure.ipynb		A quickstart tutorial to run a flow in Azure AI and evaluate it.

CLI examples

Tutorials (tutorials)

path	status	description
chat-with-pdf		Retrieval Augmented Generation (or RAG) has become a prevalent pattern to build intelligent application with Large Language Models (or LLMs) since it can infuse external knowledge into the model, which is not trained with those up-to-date or proprietary information
azure-app-service		This example demos how to deploy a flow using Azure App Service
docker		This example demos how to deploy flow as a docker app
kubernetes		This example demos how to deploy flow as a Kubernetes app

Flows (flows)

Standard flows

path	status	description
autonomous-agent		This is a flow showcasing how to construct a AutoGPT agent with promptflow to autonomously figures out how to apply the given functions to solve the goal, which is film trivia that provides accurate and up-to-date information about movies, directors, actors, and more in this sample
basic		A basic standard flow using custom python tool that calls Azure OpenAI with connection info stored in environment variables
basic-with-builtin-llm		A basic standard flow that calls Azure OpenAI with builtin llm tool
basic-with-connection		A basic standard flow that using custom python tool calls Azure OpenAI with connection info stored in custom connection
conditional-flow-for-if-else		This example is a conditional flow for if-else scenario
conditional-flow-for-switch		This example is a conditional flow for switch scenario
customer-intent-extraction		This sample is using OpenAI chat model(ChatGPT/GPT4) to identify customer intent from customer's question
flow-with-additional-includes		User sometimes need to reference some common files or folders, this sample demos how to solve the problem using additional_includes
flow-with-symlinks		User sometimes need to reference some common files or folders, this sample demos how to solve the problem using symlinks
gen-docstring		This example can help you automatically generate Python code's docstring and return the modified code
maths-to-code		Math to Code is a project that utilizes the power of the chatGPT model to generate code that models math questions and then executes the generated code to obtain the final numerical answer
named-entity-recognition		A flow that perform named entity recognition task
web-classification		This is a flow demonstrating multi-class classification with LLM

Evaluation flows

path	status	description
eval-basic		This example shows how to create a basic evaluation flow
eval-classification-accuracy		This is a flow illustrating how to evaluate the performance of a classification system
eval-entity-match-rate		This is a flow evaluates: entity match rate
eval-groundedness		This is a flow leverage llm to eval groundedness: whether answer is stating facts that are all present in the given context
eval-perceived-intelligence		This is a flow leverage llm to eval perceived intelligence

Chat flows

path	status	description
basic-chat		This example shows how to create a basic chat flow
chat-with-pdf		This is a simple flow that allow you to ask questions about the content of a PDF file and get answers
chat-with-wikipedia		This flow demonstrates how to create a chatbot that can remember previous interactions and use the conversation history to generate next message

Connections (connections)

path	status	description
connections		This folder contains example YAML files for creating connection using pf cli

SDK examples

path	status	description
quickstart.ipynb		A quickstart tutorial to run a flow and evaluate it.
quickstart-azure.ipynb		A quickstart tutorial to run a flow in Azure AI and evaluate it.
cloud-run-management.ipynb		Flow run management in Azure AI
connection.ipynb		Manage various types of connections using sdk
chat-with-pdf-azure.ipynb		A tutorial of chat-with-pdf flow that executes in Azure AI
chat-with-pdf.ipynb		A tutorial of chat-with-pdf flow that allows user ask questions about the content of a PDF file and get answers

Contributing

We welcome contributions and suggestions! Please see the contributing guidelines for details.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. Please see the code of conduct for details.

Reference

• Promptflow documentation