Portia SDK Python 使用教程

1. 项目介绍

Portia SDK Python 是一个开源的开发者框架，用于构建具有状态性和认证功能的代理工作流。它提供了一个核心产品，可以通过附加的云功能进行扩展，这些云功能旨在简化生产部署过程。Portia AI 支持多代理计划，能够跟踪任务执行过程中的状态，并提供即时认证的工具调用，同时保证用户体验。

2. 项目快速启动

在开始之前，请确保您已经安装了 Python 3.11 或更高版本。然后按照以下步骤进行操作：

# 安装 Portia Python SDK
pip install portia-sdk-python

# 设置环境变量
export OPENAI_API_KEY='your-api-key-here'

# 验证安装
portia-cli run "add 1 + 2"

如果需要使用其他模型，例如 Anthropic 或 Mistral AI，请确保设置了相关的 API 密钥，并在 CLI 命令中指定 --llm-provider 参数。

3. 应用案例和最佳实践

以下是一个端到端的示例，展示了如何使用 Portia SDK Python 生成和执行计划：

from dotenv import load_dotenv
from portia import Portia, default_config, example_tool_registry

# 加载环境变量
load_dotenv()

# 实例化 Portia 客户端
portia = Portia(config=default_config(), tools=example_tool_registry)

# 根据用户查询生成计划
plan = portia.plan('哪个股票在 2024 年增长得更快，亚马逊还是谷歌？')
print(plan.model_dump_json(indent=2))

# 从生成的计划创建并执行运行
plan_run = portia.run_plan(plan)
print(plan_run.model_dump_json(indent=2))

确保在 .env 文件中设置了 OPENAI_API_KEY 和 TAVILY_API_KEY 环境变量。

4. 典型生态项目

Portia SDK Python 的生态系统包括了多种工具和服务，这些工具和服务可以通过 SDK 集成到代理工作流中。以下是一些典型的生态项目：

• Portia Cloud：提供云存储服务，允许轻松存储和检索计划，访问云托管工具，并使用 Portia 仪表板查看计划运行、澄清和工具调用日志。
• 认证工具库：包含多种流行的 SaaS 提供商（如 Google、Zendesk、Hubspot、Github 等）的即时光认证工具。

通过这些工具和服务，开发者可以构建强大的代理工作流，满足各种复杂场景的需求。