Portia AI：インテリジェントな自動ワークフロー構築のためのPythonツールキット

Portia AIはオープンソースのPythonソフトウェア開発キット（SDK）であり、開発者がインテリジェントな自動ワークフローを構築することを支援することに重点を置いている。Portia AIは、開発者によるワークフローのカスタマイズをサポートし、本番環境のための信頼性の高いサポートを提供する。ユーザーはPortia AIを使って、カレンダー、電子メール、決済システムなど様々なツールに接続し、タスクを素早く自動化することができる。公式ドキュメントとコミュニティ・サポートは、開発を効率的に自動化する必要のある開発者に最適だ。プロジェクトはGitHubでホストされ、コミュニティへの貢献とフィードバックを奨励するオープンソースプロトコルに従っている。

機能一覧

• マルチ・インテリジェンス・ワークフロー複雑なタスクに共同で取り組むために、複数のインテリジェンスの創造と管理をサポート。
• ミッションの計画と実行自然言語でタスクを入力し、実行計画を自動生成します。
• ツール統合Google CalendarやStripeなどの外部ツールとの接続に対応し、機能を拡張。
• ステータス追跡タスクの実行状況をリアルタイムで監視するPlanRunState関数を提供する。
• 実装フック開発者がタスク実行にカスタムロジックを挿入できるようにし、柔軟性を確保。
• オープンソースとコミュニティ・サポート詳細なドキュメントとDiscordコミュニティは、学習とコミュニケーションを促進するために提供されています。
• 生産環境の最適化大規模展開のための信頼性と低遅延を重視。

ヘルプの使用

設置プロセス

Portia AI Python SDKを使用するには、まずPython 3.11以上をインストールする必要があります。インストールと設定は以下の手順で行うことができます：

1. Pythonバージョンの確認::
   ターミナルで以下のコマンドを実行して、Pythonのバージョンを確認する：

   python --version
   

   3.11より低いバージョンを使っている場合は、Python.orgで最新版をダウンロードしてインストールしてください。

2. Portia SDKのインストール::
   pipを使用してPortia SDKをインストールします：

   pip install portia
   

3. ポーシャのAPIキーを取得する::
   • ポーシャのウェブサイト(app.portialabs.ai)に登録し、無料のポーシャAPIキーを入手してください。
   • キーを環境変数に設定する。ターミナルで実行する：

     export PORTIA_API_KEY='你的API密钥'
     

     または、Pythonの dotenv モジュールはキーをロードする：

     from dotenv import load_dotenv
     load_dotenv(override=True)
     

4. 依存ツールのインストール::
   Google CalendarやStripeのPythonライブラリなど、必要に応じて追加のツールキットをインストールしてください。公式ドキュメント (docs.portialabs.ai)を使って特定の依存関係を得ることができる。

基本的な使い方

Portia AIのコア機能は、タスクを自然言語で記述することでワークフローを自動生成し、実行することである。以下は、Portia AIを使ってカレンダーのイベントをスケジュールする簡単な例です：

1. 初期化 ポーシャ::
   基本的なPortiaインスタンスを作成し、デフォルトのツールを設定し、フックを実行する：

   from portia import Config, Portia, DefaultToolRegistry
   from portia.cli import CLIExecutionHooks
   config = Config.from_default()
   portia = Portia(
   config=config,
   tools=DefaultToolRegistry(config=config),
   execution_hooks=CLIExecutionHooks(),
   )
   

2. タスクの定義::
   自然言語を使用してタスクを記述する。例えば、会議の手配：

   recipient_email = input("请输入要安排会议的邮箱地址：\n")
   task = f"""
   请帮助我完成以下任务：
   - 检查明天 8:00 到 8:30 的 Google 日历空闲时间
   - 如果有空，安排一个 30 分钟的会议，标题为“Portia AI 演示”，描述为“测试演示”，与 {recipient_email} 共享
   """
   

3. タスクの実行::
   ポーシャを呼ぶ run メソッドでタスクを実行する：

   plan = portia.run(task)
   

4. 実行結果を見る::
   Portiaは自動的にカレンダーをチェックし、会議をスケジュールし、招待メールを送信します。実行の進捗状況は、PlanRunStateでリアルタイムに確認できます。

注目の機能操作

• マルチインテリジェンス・チームワークPortiaは、複数のインテリジェンスの協働をサポートします。開発者は、PlanBuilderツールを使って、対話形式で複雑なワークフローを設計することができます。例えば、顧客返金ワークフローを作成します：

  task = """
  检查用户订单状态，如果订单有效，使用 Stripe 执行退款，完成后发送确认邮件
  """
  plan = portia.run(task)
  

  実行中、開発者はExecutionHookを介して手動確認ステップを挿入し、機密性の高い操作（払い戻しなど）を安全かつ確実に管理することができます。

• ステータス追跡PlanRunState を使用してタスクの実行を追跡します。例

  state = plan.get_state()
  print(state.progress)
  

  これにより、タスク完了の進捗状況をリアルタイムで見ることができ、長いタスクを監視する必要があるシナリオに適しています。

• ツール統合Portiaは、様々な外部ツールをサポートしています。開発者は外部ツールを DefaultToolRegistry システムにカスタムツールを追加します。例えば、Stripeを接続する：

  from portia.tools import StripeTool
  tools = DefaultToolRegistry(config=config).add(StripeTool(api_key='你的Stripe密钥'))
  portia = Portia(config=config, tools=tools)
  

高度な使用

• カスタム実行フック開発者は、タスク実行の重要なノードにロジックを挿入するフック関数を定義できます。例えば、払い戻しの前に手動で確認を求めるなど：

  class CustomHook(CLIExecutionHooks):
  def before_execution(self, task):
  print(f"即将执行任务：{task}")
  return input("是否继续？(y/n) ") == "y"
  portia = Portia(config=config, execution_hooks=CustomHook())
  

• 生産環境の最適化提供：ポーシャ StorageClass.CLOUD タスクの状態を保存するためのオプションで、待ち時間を短縮し、信頼性を高めます。設定方法：

  config = Config(storage_class=StorageClass.CLOUD)
  

地域支援

Portia AIは、詳細な公式文書(docs.portialabs.ai) や Discord コミュニティがあり、開発者はそこで質問したり、経験を共有したり、問題を報告したりすることができる。また、開発者が GitHub 上で問題を修正すると報酬がもらえる有償貢献プログラムもある。

アプリケーションシナリオ

1. 自動カレンダー管理
   開発者はPortia AIを使って、カレンダーの空き状況を自動的にチェックし、会議のスケジュールや招待状を送ることができます。多忙なプロフェッショナルやチームマネージャーに最適で、手作業での調整に費やす時間を削減します。
2. カスタマーサービス・オートメーション
   Portia AIは、返金リクエストの自動化など、インテリジェントな顧客サービスシステムを構築できる。開発者は、注文状況の確認、返金の実行、顧客への通知などのワークフローを設定し、効率を向上させることができる。
3. データ処理ワークフロー
   Portia AIは大規模なデータ処理タスクに適している。開発者は、データサイエンティストやビジネスアナリストに適した、データを自動的にクリーニング、分析、保存するマルチインテリジェンスシステムを設計することができる。

品質保証

1. ポーシャAIにお金を払う必要はありますか？
   Portia AIは無料のAPIキーを提供しているので、ユーザーはお金を払うことなく使い始めることができる。一部のプレミアム機能については、別途クラウドサービス利用料が必要となる場合がある。
2. どのような外部ツールがサポートされていますか？
   Portia AIは、Googleカレンダー、Stripeなどのツールをサポートしています。開発者は、ツールをカスタマイズすることで機能を拡張することもできます。
3. 地域貢献に参加するには？
   GitHubにアクセスする portiaAI/portia-sdk-python リポジトリへの貢献ガイドラインをご覧ください。開発者は問題を修正したり新機能を提出することで参加でき、報酬を獲得するチャンスがあります。