Easy Agents: criação rápida de agentes automatizados inteligentes usando linguagem natural

O Easy Agents é uma estrutura de código aberto projetada para ajudar os usuários a criar e implementar rapidamente agentes de automação inteligentes por meio de comandos simples de linguagem natural. Ele facilita a definição de fluxos de trabalho complexos para pessoas não técnicas e reduz o incômodo de escrever códigos manualmente. Os usuários só precisam usar linguagem natural para descrever a tarefa, a estrutura pode gerar automaticamente o agente de automação correspondente, adequado para operações de segurança, suporte ao cliente e cenários de gerenciamento de TI, etc. O Easy Agents é baseado no FastAPI e no MCP (Model Context Protocol), fornecendo métodos eficientes de integração e implementação de ferramentas. A documentação oficial fornece quatro exemplos de como automatizar tarefas complexas com comandos simples. O projeto é mantido por Kyle Polley no GitHub e recebe código e feedback da comunidade.

Lista de funções

• Suporta a definição do comportamento do agente em linguagem natural sem código complexo.
• integrado (como em um circuito integrado) MCP para se conectar facilmente a ferramentas e APIs externas.
• Fornece endpoints FastAPI e acionadores cron para simplificar a implementação do agente.
• Inclui ferramentas de UV para gerenciar as dependências do projeto e garantir um ambiente consistente.
• Oferece suporte à criação de servidores MCP personalizados para ampliar a funcionalidade do proxy.
• Fornece exemplos de fluxos de trabalho para demonstrar cenários, como análise de alertas de segurança, geração de relatórios, etc.
• Suporte à comunidade de código aberto que permite aos usuários enviar problemas e melhorias no código.

Usando a Ajuda

Processo de instalação

Para começar a usar o Easy Agents, os usuários precisam clonar o repositório e configurar o ambiente. Abaixo estão as etapas detalhadas de instalação:

1. armazém de clones
   Execute o seguinte comando em um terminal para clonar o repositório do Easy Agents localmente:

   git clone https://github.com/kpolley/easy-agents.git
   cd easy-agents
   

2. Instalação de dependências
   Fácil utilização dos agentes uv para gerenciar as dependências. Certifique-se de que o Python e o uve depois executar:

   uv sync
   

   Isso instalará automaticamente todos os pacotes dependentes exigidos pelo projeto, como o FastAPI e as bibliotecas relacionadas.

3. Iniciando o servidor de desenvolvimento
   Após a conclusão da instalação, inicie o FastAPI Development Server:

   uv run fastapi dev main.py
   

   Depois que o servidor for iniciado, ele poderá ser acessado por meio de um navegador http://localhost:8000 Exibir pontos de extremidade da API.

4. Ambiente de configuração
   Se você precisar se conectar a uma ferramenta externa, como o GitHub ou o Slack, será necessário definir o endereço do servidor MCP no arquivo de configuração do projeto. Consulte mcps/github_extended.py exemplo, configurar um servidor MCP personalizado.

Criação de um proxy

A criação de um novo agente é muito simples e requer apenas as seguintes etapas:

1. Definição do comportamento do proxy
   No arquivo de configuração no diretório do projeto, descreva as tarefas do agente em linguagem natural. Exemplo:

   你是一个负责调查安全警报的专家代理。任务步骤：
   1. 根据警报 ID 查询详细信息
   2. 深入分析警报内容
   3. 生成详细报告
   4. 如果警报有效，将报告发送到 Slack 的 #security-alerts 频道
   

   Essas instruções são analisadas pela estrutura em fluxos de trabalho executáveis.

2. Especificar o servidor MCP
   Especifique no arquivo de configuração o endereço do servidor MCP que o agente precisa acessar. Por exemplo, para se conectar à API do GitHub, você pode usar o servidor MCP oficial do GitHub ou um servidor personalizado.
3. Agente de implementação
   Os agentes podem ser implementados por meio de pontos de extremidade FastAPI ou acionadores cron. Execute o seguinte comando para configurar uma tarefa cronometrada:

   uv run python scripts/run_agent.py
   

   ou acionar a execução do agente por meio de uma chamada de API.

Operação da função em destaque

programação em linguagem natural

A principal funcionalidade do Easy Agents é permitir que os usuários definam tarefas complexas em linguagem natural. Por exemplo, criar um agente que gere relatórios semanais de projetos:

每周日，代理会检查 Linear 的任务和项目，生成团队项目进展报告，列出本周完成的任务和负责人。

A estrutura analisa automaticamente os comandos, chama as APIs relevantes (por exemplo, a API Linear) e gera relatórios. O usuário não precisa escrever código, basta descrever os requisitos.

Integração de ferramentas externas

O Easy Agents facilita a integração de ferramentas externas por meio do protocolo MCP. Por exemplo, conectar-se ao Slack para enviar notificações:

1. Adicione o endereço do servidor Slack MCP ao arquivo de configuração.
2. Inclua no comando do agente uma etapa para enviar uma notificação, por exemplo, "Send report to channel #team-updates" (Enviar relatório para o canal #team-updates).
3. Depois que o agente é implantado, os relatórios são enviados automaticamente para o canal Slack especificado.

Personalização do servidor MCP

Os usuários podem criar servidores MCP personalizados se a ferramenta padrão não atender às suas necessidades. Consulte mcps/github_extended.pySiga as etapas abaixo:

1. Crie um novo arquivo Python que defina a lógica do servidor MCP.
2. Permite a interação com APIs externas, como a busca de dados do repositório do GitHub.
3. Faça referência a esse endereço de servidor na configuração do proxy.
4. Uma vez implantado, o agente pode invocar a ferramenta personalizada.

Depuração e extensão

• ajustar os componentes durante o testeLogs: O servidor FastAPI fornece logs que registram cada etapa da execução do agente. Os usuários podem verificar a execução das tarefas por meio dos logs.
• extensõesOs usuários podem ampliar a funcionalidade enviando uma solicitação pull ou modificando o código. Por exemplo, adicionar novos servidores MCP para oferecer suporte a outras ferramentas.

advertência

• Certifique-se de que a conexão de rede esteja estável e que o servidor MCP precise acessar APIs externas.
• sonda uv Compatibilidade de versão, recomenda-se a versão mais recente.
• Atualize regularmente o repositório para obter os recursos mais recentes contribuídos pela comunidade.

cenário do aplicativo

1. Operação e manutenção de segurança (O&M)
   O Easy Agents pode ser usado para automatizar o processamento de alertas de segurança. Os agentes podem consultar alertas, analisar ameaças, gerar relatórios e enviar os resultados para as ferramentas de comunicação da equipe, reduzindo o tempo manual.
2. Suporte ao cliente
   Os agentes podem responder automaticamente a perguntas comuns dos clientes, reunir tíquetes de suporte e gerar relatórios resumidos para melhorar a eficiência do atendimento ao cliente.
3. Gerenciamento de TI
   Para monitoramento automatizado de servidores, análise de registros ou alocação de recursos. Os agentes podem executar tarefas com base em comandos de linguagem natural, como "verificar o status do servidor e enviar relatório todos os dias".
4. gerenciamento de projetos
   Gere automaticamente relatórios semanais sobre o andamento do projeto, analise a conclusão das tarefas e notifique a equipe, o que é adequado para equipes de desenvolvimento ágil.

QA

1. O Easy Agents é adequado para usuários sem experiência em programação?
   Sim, o Easy Agents permite que os usuários definam tarefas em linguagem natural, sem necessidade de conhecimento de programação. Pessoas sem conhecimentos técnicos podem começar a trabalhar rapidamente.
2. Como posso ampliar a funcionalidade do agente?
   Os usuários podem ampliar a funcionalidade criando servidores MCP personalizados ou modificando o código. Referências mcps/github_extended.py Exemplo.
3. Quais ambientes são necessários para implantar agentes?
   Requer Python, ferramentas uv e uma conexão com a Internet. Recomendado para execução em Linux ou macOS.
4. Quais ferramentas externas são compatíveis?
   Oferece suporte a ferramentas como GitHub, Slack etc. e pode ser estendido a qualquer ferramenta que ofereça suporte a APIs por meio do protocolo MCP.