](https://mseep.ai/app/femto-minion-agent)
    
小黄特工
一个功能强大的代理框架，具有增强的功能，包括浏览器自动化、代码执行、MCP工具支持和深入研究。 现在默认为EXTERNAL_MINIO_AGENT框架 以获得卓越的性能和功能。
🎬 演示视频
快速开始
Minion Agent现在默认为强大的 EXTERNAL_MINION_AGENT 框架，提供增强的代码执行、浏览器自动化和开箱即用的高级规划功能。
安装
pip install minion-agent-x或来源
git clone git@github.com:femto/minion-agent.git
cd minion-agent
pip install -e .用法
下面是一个如何使用Minion Agent的简单示例：
import asyncio
import os
from dotenv import load_dotenv
from minion_agent import MinionAgent, AgentConfig, AgentFramework
from minion.agents import CodeAgent
import minion_agent
load_dotenv()
async def main():
# Configure the agent (using EXTERNAL_MINION_AGENT as default)
agent_config = AgentConfig(
model_id=os.environ.get("AZURE_DEPLOYMENT_NAME"),
name="research_assistant",
description="A helpful research assistant",
model_args={
"azure_endpoint": os.environ.get("AZURE_OPENAI_ENDPOINT"),
"api_key": os.environ.get("AZURE_OPENAI_API_KEY"),
"api_version": os.environ.get("OPENAI_API_VERSION"),
"model": "gpt-4o", # Actual model to use in minion framework
},
tools=[
minion_agent.tools.browser_tool.browser,
],
agent_type=CodeAgent, # Default agent type for EXTERNAL_MINION_AGENT
)
# Create agent with EXTERNAL_MINION_AGENT framework (default)
agent = await MinionAgent.create_async(AgentFramework.EXTERNAL_MINION_AGENT, agent_config)
# Run the agent with a question
result = await agent.run_async("What are the latest developments in AI?")
print("Agent's response:", result.final_output.content)
if __name__ == "__main__":
asyncio.run(main())参见示例.py 请参阅示例_browser_use.py 请参阅示例_with_managed_agents.py 请参阅example_deep_research.py 请参阅example_reason.py
代理框架
Minion Agent支持多种代理框架。默认框架为 EXTERNAL_MINION_AGENT，它提供了增强的功能，包括：
- 代码生成和执行：具有内置执行功能的高级代码生成
- 浏览器自动化：集成浏览器控制和web交互
- MCP工具支持：完整的模型上下文协议集成
- 强化规划：复杂的任务规划和执行
可用框架
EXTERNAL_MINION_AGENT（默认）：具有代码执行和浏览器功能的增强框架SMOLAGENTS：HuggingFace的罩衫框架，提供规划支持LANGCHAIN：基于LangChain的代理商OPENAI：OpenAI的助手APIBROWSER_USE：专门用于浏览器自动化任务DEEP_RESEARCH：针对研究和信息收集进行了优化
特定于框架的代理类型
使用时 EXTERNAL_MINION_AGENT，您可以指定不同的代理类型：
from minion.agents import CodeAgent, ToolCallingAgent
agent_config = AgentConfig(
# ... other config ...
agent_type=CodeAgent, # For code generation and execution
# or
# agent_type=ToolCallingAgent, # For general tool calling
)配置
这 AgentConfig 类接受以下参数：
model_id：要使用的模型的ID（例如“gpt-4”）name：代理的名称（默认：“Minion”）description：代理的可选描述instructions：代理的可选系统说明tools：代理可以使用的工具列表model_type：底层代理框架的模型类型model_args：模型特定参数的可选字典agent_type：底层代理框架的代理类型agent_args：代理特定参数的可选字典
MCP工具支持
Minion Agent支持模型上下文协议（MCP）工具。以下是如何使用它们：
标准MCP工具
from minion_agent.config import MCPTool
agent_config = AgentConfig(
# ... other config options ...
tools=[
minion_agent.tools.browser_tool.browser, # Regular tools
MCPTool(
command="npx",
args=["-y", "@modelcontextprotocol/server-filesystem", "/path/to/workspace"]
) # MCP tool
]
)基于SSE的MCP工具
您还可以通过服务器发送事件（SSE）使用MCP工具。这对于连接到远程MCP服务器非常有用：
from minion_agent.config import MCPTool
agent_config = AgentConfig(
# ... other config options ...
tools=[
MCPTool({"url": "http://localhost:8000/sse"}), # SSE-based tool
]
)⚠️ 安全警告：在SSE上使用MCP服务器时，请务必谨慎，只连接到受信任和经过验证的服务器。在连接之前，始终验证任何MCP服务器的来源和安全性。
您还可以同时使用多个MCP工具：
tools=[
MCPTool(command="npx", args=["..."]), # Standard MCP tool
MCPTool({"url": "http://localhost:8000/sse"}), # SSE-based tool
MCPTool({"url": "http://localhost:8001/sse"}) # Another SSE-based tool
]烟雾中的规划支持
您可以通过设置来启用自动计划 planning_interval 在 agent_args （烟雾）：
agent_config = AgentConfig(
# ... other config options ...
agent_args={
"planning_interval": 3, # Agent will create a plan every 3 steps
"additional_authorized_imports": "*"
}
)这 planning_interval 参数决定代理应多久创建一次新计划。当设置为3时，代理将：
- 为任务制定初步计划
- 根据计划执行3个步骤
- 根据进展重新评估并制定新计划
- 重复，直到任务完成
环境变量
确保在 .env 文件：
# For Azure OpenAI (recommended for EXTERNAL_MINION_AGENT)
AZURE_DEPLOYMENT_NAME=your_deployment_name
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/
AZURE_OPENAI_API_KEY=your_azure_api_key
OPENAI_API_VERSION=2024-02-15-preview
# Or for OpenAI
OPENAI_API_KEY=your_openai_api_key
# Optional: For other providers via LiteLLM
# ANTHROPIC_API_KEY=your_anthropic_key
# GOOGLE_API_KEY=your_google_key发展
为发展而设立：
# Clone the repository
git clone https://github.com/yourusername/minion-agent.git
cd minion-agent
# Create a virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install development dependencies
pip install -e ".[dev]"深入研究
看 深度研究文档 了解使用说明。
社区
加入我们的微信讨论组，与其他用户联系并获得帮助：
群聊: minion-agent讨论群
许可证
MIT许可证