Portia AI: Ein Python-Toolkit zur Erstellung intelligenter automatisierter Arbeitsabläufe

Portia AI ist ein Open Source Python Software Development Kit (SDK), das Entwicklern hilft, intelligente, automatisierte Workflows zu erstellen. Portia AI unterstützt Entwickler bei der Anpassung von Arbeitsabläufen und bietet zuverlässige Unterstützung für Produktionsumgebungen. Benutzer können damit eine Verbindung zu einer Vielzahl von Tools wie Kalendern, E-Mails und Zahlungssystemen herstellen, um Aufgaben schnell zu automatisieren. Die offizielle Dokumentation und der Community-Support sind ideal für Entwickler, die ihre Entwicklung effizient automatisieren müssen. Das Projekt wird auf GitHub gehostet und folgt Open-Source-Protokollen, um Beiträge und Feedback der Community zu fördern.

Funktionsliste

• Multi-Intelligenz-WorkflowUnterstützung der Schaffung und Verwaltung von mehreren Intelligenzen zur Zusammenarbeit bei komplexen Aufgaben.
• Planung und Durchführung von MissionenEingabe von Aufgaben über natürliche Sprache und automatische Erstellung von Ausführungsplänen.
• WerkzeugintegrationUnterstützt die Verbindung mit externen Tools wie Google Calendar, Stripe usw. zur Erweiterung der Funktionalität.
• StatusverfolgungPlanRunState: Bereitstellung der Funktion PlanRunState zur Überwachung des Fortschritts der Aufgabenausführung in Echtzeit.
• ImplementierungshakenErmöglicht Entwicklern das Einfügen benutzerdefinierter Logik in die Aufgabenausführung und gewährleistet so Flexibilität.
• Open Source und Unterstützung durch die GemeinschaftAusführliche Dokumentation und die Discord-Community erleichtern das Lernen und die Kommunikation.
• Optimierung der ProduktionsumgebungSchwerpunkt auf Zuverlässigkeit und geringe Latenzzeiten für groß angelegte Einsätze.

Hilfe verwenden

Einbauverfahren

Um das Portia AI Python SDK zu verwenden, müssen Sie zunächst Python 3.11 oder höher installieren. Die Installation und Konfiguration kann anhand der folgenden Schritte vorgenommen werden:

1. Überprüfen der Python-Version::
   Überprüfen Sie die Python-Version, indem Sie den folgenden Befehl in einem Terminal ausführen:

   python --version
   

   Wenn Sie eine Version kleiner als 3.11 haben, besuchen Sie Python.org, um die neueste Version herunterzuladen und zu installieren.

2. Installieren des Portia SDK::
   Installieren Sie das Portia SDK mit pip. Führen Sie den folgenden Befehl aus:

   pip install portia
   

3. Portia API-Schlüssel erhalten::
   • Besuchen Sie die Portia-Website (app.portialabs.ai), registrieren Sie sich und erhalten Sie Ihren kostenlosen Portia-API-Schlüssel.
   • Setzen Sie den Schlüssel als Umgebungsvariable. Führen Sie es im Terminal aus:

     export PORTIA_API_KEY='你的API密钥'
     

     Oder verwenden Sie Pythons dotenv Das Modul lädt den Schlüssel:

     from dotenv import load_dotenv
     load_dotenv(override=True)
     

4. Installation der abhängigen Werkzeuge::
   Installieren Sie bei Bedarf zusätzliche Toolkits, wie z. B. Google Calendar oder die Python-Bibliothek von Stripe. Beachten Sie die offizielle Dokumentation (docs.portialabs.ai), um spezifische Abhängigkeiten zu erhalten.

Grundlegende Verwendung

Die Kernfunktion von Portia AI ist die automatische Generierung und Ausführung von Workflows durch die Beschreibung von Aufgaben in natürlicher Sprache. Nachfolgend finden Sie ein einfaches Beispiel für die Planung von Kalenderereignissen mit Portia AI:

1. Initialisierung Portia::
   Erstellen Sie eine einfache Portia-Instanz, konfigurieren Sie Standardwerkzeuge und führen Sie Hooks aus:

   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. Definition der Aufgaben::
   Verwenden Sie natürliche Sprache, um Aufgaben zu beschreiben. Zum Beispiel eine Besprechung vereinbaren:

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

3. Laufende Aufgaben::
   Portia's anrufen run Methode, um die Aufgabe auszuführen:

   plan = portia.run(task)
   

4. Ausführungsergebnisse anzeigen::
   Portia überprüft automatisch den Kalender, plant Besprechungen und versendet E-Mail-Einladungen. Der Ausführungsfortschritt kann in Echtzeit über PlanRunState angezeigt werden.

Featured Function Bedienung

• Multi-Intelligenz-TeamarbeitPortia unterstützt das Zusammenwirken mehrerer Intelligenzen. Entwickler können mit dem PlanBuilder-Tool komplexe Arbeitsabläufe in einem Dialog gestalten. Zum Beispiel die Erstellung eines Arbeitsablaufs zur Kundenrückerstattung:

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

  Während der Ausführung können Entwickler über den ExecutionHook einen manuellen Bestätigungsschritt einfügen, um sicherzustellen, dass sensible Vorgänge (z. B. Erstattungen) sicher und kontrolliert ablaufen.

• StatusverfolgungPlanRunState: Verwenden Sie PlanRunState, um die Ausführung von Aufgaben zu verfolgen. Beispiel:

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

  So können Sie den Fortschritt der Aufgabenerledigung in Echtzeit verfolgen, was sich für Szenarien eignet, in denen Sie lange Aufgaben überwachen müssen.

• WerkzeugintegrationPortia unterstützt eine breite Palette von externen Werkzeugen. Der Entwickler kann ein externes Tool in der DefaultToolRegistry Fügen Sie ein benutzerdefiniertes Tool zu Ihrem System hinzu. Verbinden Sie zum Beispiel Stripe:

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

Erweiterte Nutzung

• Benutzerdefinierte AusführungshakenEntwickler können Hook-Funktionen definieren, um an kritischen Knotenpunkten der Aufgabenausführung Logik einzufügen. Zum Beispiel, um eine manuelle Bestätigung vor der Erstattung zu verlangen:

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

• Optimierung der Produktionsumgebung: Mit freundlicher Genehmigung von Portia StorageClass.CLOUD Option zur Speicherung des Aufgabenstatus, wodurch die Latenzzeit verringert und die Zuverlässigkeit erhöht wird. Methode zur Konfiguration:

  config = Config(storage_class=StorageClass.CLOUD)
  

Unterstützung der Gemeinschaft

Portia AI bietet eine ausführliche offizielle Dokumentation (docs.portialabs.ai) und Discord-Communities, in denen Entwickler Fragen stellen, Erfahrungen austauschen oder Probleme melden können. Es gibt auch ein Programm für bezahlte Beiträge, bei dem Entwickler für die Behebung von Problemen auf GitHub belohnt werden.

Anwendungsszenario

1. Automatisierte Kalenderverwaltung
   Entwickler können Portia AI nutzen, um automatisch die Verfügbarkeit von Terminen zu prüfen, Besprechungen zu planen und Einladungen zu versenden. Ideal für vielbeschäftigte Berufstätige oder Teammanager, um die Zeit für die manuelle Koordination zu reduzieren.
2. Automatisierung des Kundendienstes
   Portia AI kann intelligente Kundenservice-Systeme aufbauen, z. B. zur Automatisierung von Rückerstattungsanträgen. Entwickler können Workflows einrichten, um den Bestellstatus zu prüfen, Rückerstattungen durchzuführen und Kunden zu benachrichtigen, um die Effizienz zu verbessern.
3. Arbeitsablauf der Datenverarbeitung
   Portia AI ist für umfangreiche Datenverarbeitungsaufgaben geeignet. Entwickler können Multi-Intelligenz-Systeme entwerfen, die Daten automatisch bereinigen, analysieren und speichern und sich für Datenwissenschaftler oder Wirtschaftsanalysten eignen.

QA

1. Muss ich für Portia AI bezahlen?
   Portia AI bietet kostenlose API-Schlüssel, so dass Nutzer es ohne Bezahlung nutzen können. Für einige Premium-Funktionen können zusätzliche Gebühren für Cloud-Dienste anfallen; Einzelheiten finden Sie auf der Website.
2. Welche externen Tools werden unterstützt?
   Portia AI unterstützt Tools wie Google Calendar, Stripe usw. Entwickler können die Funktionalität auch erweitern, indem sie die Tools anpassen, siehe die offizielle Dokumentation.
3. Wie kann ich mich an den Beiträgen der Gemeinschaft beteiligen?
   Besuchen Sie GitHub auf portiaAI/portia-sdk-python Repository, sehen Sie sich die Richtlinien für Beiträge an. Entwickler können sich beteiligen, indem sie Probleme beheben oder neue Funktionen einreichen und haben die Chance, Belohnungen zu gewinnen.