Portia AI: um kit de ferramentas Python para criar fluxos de trabalho automatizados inteligentes

O Portia AI é um kit de desenvolvimento de software (SDK) Python de código aberto voltado para ajudar os desenvolvedores a criar fluxos de trabalho inteligentes e automatizados. O Portia AI permite que os desenvolvedores personalizem os fluxos de trabalho e oferece suporte confiável para ambientes de produção. Os usuários podem usá-lo para se conectar a uma variedade de ferramentas, como calendários, e-mails e sistemas de pagamento, para automatizar tarefas rapidamente. A documentação oficial e o suporte da comunidade são perfeitos para os desenvolvedores que precisam automatizar seu desenvolvimento com eficiência. O projeto está hospedado no GitHub e segue protocolos de código aberto para incentivar as contribuições e o feedback da comunidade.

Lista de funções

• fluxo de trabalho de inteligência múltiplaSuporte à criação e ao gerenciamento de várias inteligências para colaborar em tarefas complexas.
• Planejamento e execução da missãoTarefas de entrada por meio de linguagem natural e geração automática de planos de execução.
• integração de ferramentasSuporte à conexão com ferramentas externas, como Google Calendar, Stripe, etc., para ampliar a funcionalidade.
• Rastreamento de statusFunção PlanRunState: fornece a função PlanRunState para monitorar o progresso da execução da tarefa em tempo real.
• Ganchos de implementaçãoPermite que os desenvolvedores insiram lógica personalizada na execução da tarefa, garantindo flexibilidade.
• Código aberto e suporte da comunidadeDocumentação detalhada e a comunidade Discord são fornecidas para facilitar o aprendizado e a comunicação.
• Otimização do ambiente de produçãoÊnfase na confiabilidade e na baixa latência para implementações em grande escala.

Usando a Ajuda

Processo de instalação

Para usar o Portia AI Python SDK, você precisa primeiro instalar o Python 3.11 ou superior. A instalação e a configuração podem ser feitas seguindo as etapas abaixo:

1. Verificação da versão do Python::
   Confirme a versão do Python executando o seguinte comando em um terminal:

   python --version
   

   Se você tiver uma versão inferior à 3.11, acesse Python.org para fazer o download e instalar a versão mais recente.

2. Instalando o SDK do Portia::
   Instale o Portia SDK usando o pip. Execute o seguinte comando:

   pip install portia
   

3. Obter a chave de API da Portia::
   • Visite o site da Portia (app.portialabs.ai), registre-se e obtenha sua chave de API Portia gratuita.
   • Defina a chave como uma variável de ambiente. Execute-o no terminal:

     export PORTIA_API_KEY='你的API密钥'
     

     Ou use a função dotenv O módulo carrega a chave:

     from dotenv import load_dotenv
     load_dotenv(override=True)
     

4. Instalação de ferramentas dependentes::
   Instale kits de ferramentas adicionais conforme necessário, como o Google Calendar ou a biblioteca Python do Stripe. Consulte a documentação oficial (docs.portialabs.ai) para obter dependências específicas.

Uso básico

A principal funcionalidade do Portia AI é gerar e executar fluxos de trabalho automaticamente, descrevendo tarefas por meio de linguagem natural. Abaixo está um exemplo simples que mostra como agendar eventos de calendário usando o Portia AI:

1. Inicialização Portia::
   Crie uma instância básica do Portia, configure ferramentas padrão e execute hooks:

   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. Definição de tarefas::
   Use linguagem natural para descrever tarefas. Por exemplo, organizar uma reunião:

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

3. Execução de tarefas::
   Chamando a Portia's run para executar a tarefa:

   plan = portia.run(task)
   

4. Exibir resultados de execução::
   O Portia verifica automaticamente o calendário, agenda reuniões e envia convites por e-mail. O progresso da execução pode ser visualizado em tempo real por meio do PlanRunState.

Operação da função em destaque

• trabalho em equipe com inteligência múltiplaPortia oferece suporte a várias inteligências trabalhando juntas. Os desenvolvedores podem projetar fluxos de trabalho complexos de forma dialógica com a ferramenta PlanBuilder. Por exemplo, criar um fluxo de trabalho de reembolso ao cliente:

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

  Durante a execução, os desenvolvedores podem inserir uma etapa de confirmação manual por meio do ExecutionHook para garantir que as operações confidenciais (por exemplo, reembolsos) sejam seguras e controladas.

• Rastreamento de statusUse PlanRunState para rastrear a execução da tarefa. Exemplo:

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

  Isso permite que você visualize o progresso da conclusão da tarefa em tempo real, o que é adequado para cenários em que é necessário monitorar tarefas longas.

• integração de ferramentasPortia oferece suporte a uma ampla gama de ferramentas externas. O desenvolvedor pode configurar uma ferramenta externa na seção DefaultToolRegistry Adicione uma ferramenta personalizada ao seu sistema. Por exemplo, conecte o Stripe:

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

Uso avançado

• Ganchos de execução personalizadosFunções de gancho: Os desenvolvedores podem definir funções de gancho para inserir lógica em nós críticos da execução da tarefa. Por exemplo, solicitar confirmação manual antes do reembolso:

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

• Otimização do ambiente de produção: Cortesia de Portia StorageClass.CLOUD para armazenar o estado da tarefa, reduzindo a latência e aumentando a confiabilidade. Método de configuração:

  config = Config(storage_class=StorageClass.CLOUD)
  

Suporte à comunidade

O Portia AI fornece documentação oficial detalhada (docs.portialabs.ai) e comunidades do Discord, onde os desenvolvedores podem fazer perguntas, compartilhar experiências ou relatar problemas. Há também um programa de contribuição paga em que os desenvolvedores são recompensados por corrigir problemas no GitHub.

cenário do aplicativo

1. Gerenciamento automatizado de calendário
   Os desenvolvedores podem usar o Portia AI para verificar automaticamente a disponibilidade do calendário, agendar reuniões e enviar convites. Ideal para profissionais ocupados ou gerentes de equipe, reduza o tempo gasto com a coordenação manual.
2. Automação do atendimento ao cliente
   O Portia AI pode criar sistemas inteligentes de atendimento ao cliente, como a automatização de solicitações de reembolso. Os desenvolvedores podem configurar fluxos de trabalho para verificar o status do pedido, realizar reembolsos e notificar os clientes para aumentar a eficiência.
3. Fluxo de trabalho de processamento de dados
   O Portia AI é adequado para tarefas de processamento de dados em grande escala. Os desenvolvedores podem projetar sistemas de inteligência múltipla que limpam, analisam e armazenam dados automaticamente, adequados para cientistas de dados ou analistas de negócios.

QA

1. Preciso pagar pelo Portia AI?
   O Portia AI oferece chaves de API gratuitas para que os usuários possam começar a usá-lo sem pagar. Alguns recursos premium podem exigir taxas adicionais de serviço de nuvem; verifique o site para obter detalhes.
2. Quais ferramentas externas são compatíveis?
   O Portia AI é compatível com ferramentas como Google Calendar, Stripe, etc. Os desenvolvedores também podem ampliar a funcionalidade personalizando as ferramentas; consulte a documentação oficial.
3. Como posso me envolver em contribuições para a comunidade?
   Visite o GitHub em portiaAI/portia-sdk-python Repositório, confira as diretrizes de contribuição. Os desenvolvedores podem participar corrigindo problemas ou enviando novos recursos e têm a chance de ganhar recompensas.