Portia SDK Python 安装与配置指南

1. 项目基础介绍

Portia SDK Python 是 Portia AI 提供的一个开源开发框架，用于创建具有状态、经过身份验证的智能自动化工作流。该框架的核心产品可以通过附加的云功能进行扩展，以简化生产部署。Portia SDK Python 支持多种机器学习模型，并提供了与多种流行 SaaS 提供商的集成。

主要编程语言：Python

2. 项目使用的关键技术和框架

• Python：作为主要编程语言，Python 提供了易于理解和使用的语法，非常适合快速开发和原型设计。
• 多代理计划：项目使用开源的多代理提示器来指导语言模型生成包含相关工具、输入和输出的计划。
• 状态跟踪：通过 PlanRun 执行生成的计划，并跟踪其状态，以便在需要时进行干预或纠正。
• 即时身份验证：项目支持扩展的工具抽象，并提供了经过身份验证的即插即用工具库。

3. 项目安装和配置准备工作

在开始安装前，请确保您的系统满足以下要求：

• Python 3.11 或更高版本
• Git 版本控制系统

详细安装步骤

1. 安装 Python

   如果您的系统中没有安装 Python，或者版本低于 3.11，请访问 Python 官方网站下载并安装最新版本的 Python。

   python --version
   

2. 安装 Portia SDK Python

   使用 pip 命令安装 Portia SDK Python。pip 是 Python 的包管理器，用于安装和管理 Python 包。

   pip install portia-sdk-python
   

   如果您需要使用特定的机器学习模型，如 MistralAI 或 Google Generative AI，可以在安装时添加对应的 extras：

   pip install portia-sdk-python[mistral]
   # 或者
   pip install portia-sdk-python[google]
   

   如果您想一次性安装所有依赖项，可以使用：

   pip install portia-sdk-python[all]
   

3. 设置环境变量

   在您的系统中设置环境变量，以便 Portia SDK Python 可以使用您的 API 密钥。

   export OPENAI_API_KEY='your-api-key-here'
   # 如果使用其他模型，还需要设置相应的 API 密钥
   

   将 your-api-key-here 替换为您从 OpenAI 或其他模型提供商获取的 API 密钥。

4. 验证安装

   使用 Portia CLI 运行一个简单的数学提示，以验证您的安装是否成功。

   portia-cli run "add 1 + 2"
   

   如果使用其他模型，您可能需要添加对应的参数：

   portia-cli run --llm-provider="anthropic" "add 1 + 2"
   # 或者
   portia-cli run --llm-provider="mistralai" "add 1 + 2"
   

完成以上步骤后，您就可以开始使用 Portia SDK Python 进行开发了。如果您需要使用 Portia 的云存储和其他功能，请访问 Portia 官方网站获取 API 密钥，并将其设置为环境变量 PORTIA_API_KEY。