RunAgent: uma ferramenta de implantação para simplificar o desenvolvimento de agentes de IA

O RunAgent é uma ferramenta de código aberto projetada para ajudar os desenvolvedores a desenvolver e implantar agentes de IA com mais facilidade. Ele oferece suporte à criação de agentes de IA em Python e rompe as barreiras de idioma ao permitir chamadas entre idiomas por meio de um SDK multilíngue (por exemplo, JavaScript, Rust, Go etc.). Os desenvolvedores podem usar o ambiente de desenvolvimento completo localmente ou implantá-lo na futura plataforma de nuvem sem servidor. O runAgent oferece uma interface de linha de comando (CLI) avançada e recursos de implantação automatizada para uma ampla variedade de cenários, desde a prototipagem até ambientes de produção em grande escala. Sua natureza agnóstica de estrutura permite que os desenvolvedores escolham livremente LangChain, CrewAI e outras estruturas para simplificar o processo de desenvolvimento.

Lista de funções

• Suporte para escrever agentes de IA em Python, permitindo chamadas entre idiomas por meio de SDKs multilíngues (por exemplo, JavaScript, Rust, Go).
• Oferece um servidor de desenvolvimento local que inclui recursos de hot reloading e depuração em tempo real.
• Plataforma de nuvem sem servidor que suporta a implantação com um clique em ambientes de produção (em breve).
• Resposta de streaming integrada e gerenciamento de fluxo de trabalho complexo para tarefas de agentes de IA em várias etapas.
• Fornecer modelos independentes de estrutura, suportar LangChain, CrewAI e outras estruturas de IA convencionais.
• Inclui ferramentas de registro, monitoramento e depuração em tempo real para aumentar a eficiência do desenvolvimento.
• Suporte a webhooks para arquiteturas orientadas por eventos.

Usando a Ajuda

Processo de instalação

A instalação do RunAgent é muito simples e é feita principalmente por meio do instrumento de linha de comando (CLI). Veja a seguir as etapas detalhadas da instalação:

1. Instalação da CLI
   Certifique-se de ter o Python 3.8 ou superior instalado em seu sistema. Abra um terminal e execute o seguinte comando para instalar o RunAgent CLI:

   pip install runagent
   

   Após a conclusão da instalação, você pode verificar se a instalação foi bem-sucedida usando o seguinte comando:

   runagent --version
   

2. Projeto de inicialização
   Em seu diretório de trabalho, execute o seguinte comando para criar um novo projeto RunAgent:

   runagent init <project_name>
   

   Isso gera um arquivo contendo o runagent.config.json que define os pontos de entrada e outras configurações do agente.

3. Iniciando o servidor de desenvolvimento local
   Vá para o diretório do projeto e execute o seguinte comando para iniciar o servidor FastAPI local:

   runagent serve <project_dir>
   

   Quando o servidor é iniciado, ele é executado por padrão no diretório http://localhost:8000Com o suporte a hot reloading, os desenvolvedores podem depurar o código em tempo real.

4. Implementação na nuvem (em breve)
   O RunAgent oferece implantação em um clique com suporte futuro para plataformas de nuvem sem servidor. Execute o seguinte comando para implementar:

   runagent deploy <project_dir>
   

   Após a implantação, o sistema retorna agent_id talvez host:portpara chamadas de SDK entre idiomas.

Uso das funções principais

A função principal do RunAgent é simplificar o desenvolvimento e a implantação de agentes de IA. Veja abaixo os detalhes de como funcionam os principais recursos:

1. Escrevendo agentes de IA
   No diretório do projeto, escreva a lógica do agente de IA em Python. O runAgent é compatível com várias estruturas, como LangChain ou CrewAI. Você pode encontrar mais informações sobre a lógica do agente de IA na seção runagent.config.json Defina o ponto de entrada do proxy na seção exemplo:

   {
   "entrypoints": {
   "main": "main.py:run_agent"
   }
   }
   

   existir main.py Escreva a lógica do agente no RunAgent, e o RunAgent a reconhecerá e carregará automaticamente.

2. chamada entre idiomas
   O RunAgent fornece SDKs multilíngues para Python, JavaScript, Rust e Go. Instale o SDK para a linguagem correspondente, como o SDK do Python:

   pip install runagent-client
   

   Use o SDK para chamar o agente. Por exemplo, em Python:

   from runagent_client import RunAgentClient
   client = RunAgentClient(agent_id="your_agent_id")
   result = client.call("main", input_data={"query": "Hello"})
   print(result)
   

   O SDK lida com a complexa lógica de comunicação e os desenvolvedores simplesmente a utilizam como se estivessem chamando uma função nativa.

3. resposta de streaming
   O RunAgent oferece suporte a respostas de streaming e é adequado para o processamento de dados em tempo real ou de tarefas longas. Cliente assíncrono usando o SDK:

   async def main():
   async for response in client.stream("main", {"query": "Stream data"}):
   print(response)
   

   Isso é útil para aplicativos que exigem atualizações em tempo real, como chatbots.

4. Depuração e monitoramento
   O servidor local do RunAgent tem ferramentas integradas de registro e monitoramento. Depois de iniciar o servidor, acesse a seção http://localhost:8000/docs Visualize a documentação da API e os registros em tempo real. Os desenvolvedores podem usar os registros para analisar o estado de execução do agente e localizar rapidamente os problemas.
5. Suporte a webhooks
   O RunAgent é compatível com uma arquitetura orientada por eventos e pode ser configurado com um webhook para acionar o agente. Por exemplo, na seção runagent.config.json Adicione um ponto de extremidade de webhook ao

   {
   "webhooks": {
   "event_name": "http://your-server/webhook"
   }
   }
   

   Quando um evento for acionado, o RunAgent chamará automaticamente a lógica do agente correspondente.

Operação da função em destaque

• independência da estrutura
  O RunAgent não restringe os desenvolvedores ao uso de uma estrutura específica. Você pode escolher LangChain, CrewAI ou uma estrutura personalizada. Os modelos podem ser usados ao inicializar um projeto:

  runagent init <project_name> --template langchain
  

  Isso gera uma estrutura de projeto baseada em LangChain com código de amostra.

• Implementação em um clique
  A implementação na nuvem é simplesmente uma questão de executar runagent deploy. O sistema lida automaticamente com a configuração do ambiente, o empacotamento de dependências e o balanceamento de carga (disponível depois que a plataforma de nuvem entra em operação). O desenvolvimento local e a implantação na nuvem são perfeitos, e os desenvolvedores não precisam ajustar manualmente o código.
• depuração em tempo real
  O servidor local suporta hot reloading, sem necessidade de reiniciar após modificar o código. A ferramenta de registro grava cada chamada ao agente, incluindo métricas de entrada/saída e de desempenho, facilitando a otimização do código para os desenvolvedores.

cenário do aplicativo

1. Prototipagem rápida
   Os desenvolvedores podem criar rapidamente protótipos de agentes de IA localmente e depurá-los usando o servidor local do RunAgent. Ideal para startups ou desenvolvedores individuais para validar ideias.
2. Integração de projetos em vários idiomas
   Em projetos com uma pilha de tecnologia multilíngue, o RunAgent permite que os agentes de IA escritos em Python sejam chamados diretamente do front-end (JavaScript), back-end (Go) ou sistemas incorporados (Rust), simplificando o processo de integração.
3. Implementação do ambiente de produção
   A plataforma de nuvem sem servidor do RunAgent (em breve) oferece suporte ao dimensionamento automático e é adequada para aplicativos de negócios que precisam lidar com solicitações altamente simultâneas, como atendimento inteligente ao cliente ou sistemas de recomendação.
4. aplicativo orientado a eventos
   Com suporte a webhook, o RunAgent pode ser usado em cenários de processamento de dados em tempo real, como acionar o agente de IA para realizar a análise de inventário quando um novo pedido é recebido.

QA

1. Quais idiomas são suportados pelo RunAgent?
   Python, JavaScript, Rust e Go são suportados atualmente, com mais linguagens a serem adicionadas no futuro. Os desenvolvedores podem enviar solicitações ou contribuir com código via GitHub. [](https://github.com/runagent-dev/runagent)
2. Como depurar um agente de IA desenvolvido localmente?
   Depois de iniciar o servidor local, acesse o arquivo http://localhost:8000/docs Visualize os registros e a documentação da API. Os registros mostram informações detalhadas sobre cada chamada.
3. A implementação na nuvem já está disponível?
   Os recursos de implantação na nuvem ainda não estão disponíveis, mas o desenvolvimento local e a auto-hospedagem estão totalmente disponíveis. Espera-se que a plataforma de nuvem ofereça implantação com um clique e dimensionamento automático. [](https://github.com/runagent-dev/runagent)
4. O RunAgent requer uma estrutura de IA específica?
   Não é necessário. O RunAgent é compatível com qualquer estrutura Python, como LangChain, CrewAI ou código personalizado.