MultiOn Tool

MultiOn Tool

MultiOnTool은 자연어 지시를 통해 웹을 탐색하고 상호작용할 수 있는 능력을 CrewAI 에이전트에게 부여합니다.

출처: 문서

본문

개요 (Overview)

MultiOnTool은 MultiOn의 웹 브라우징 기능을 감싸서, CrewAI 에이전트가 자연어 지시로 웹 브라우저를 제어할 수 있게 해줍니다. 이 도구는 매끄러운 웹 브라우징을 가능하게 하며, 동적 웹 데이터 상호작용과 웹 기반 태스크 자동화가 필요한 프로젝트에 필수적인 자산입니다.

설치 (Installation)

이 도구를 사용하려면 MultiOn 패키지를 설치해야 합니다:

uv add multion

또한 MultiOn 브라우저 확장 프로그램을 설치하고 API 사용을 활성화해야 합니다.

시작하기 위한 단계 (Steps to Get Started)

MultiOnTool을 효과적으로 사용하려면 다음 단계를 따라주세요:

  • CrewAI 설치 — Python 환경에 crewai[tools] 패키지가 설치되어 있는지 확인하세요.
  • MultiOn 설치 및 사용 — MultiOn 문서를 따라 MultiOn 브라우저 확장 프로그램을 설치하세요.
  • API 사용 활성화 — 브라우저의 확장 프로그램 폴더에서 MultiOn 확장 프로그램(웹 페이지에 떠 있는 MultiOn 아이콘이 아니라)을 클릭해 확장 설정을 여세요. API Enabled 토글을 클릭해 API를 활성화하세요.

예제 (Example)

다음 예제는 도구를 초기화하고 웹 브라우징 태스크를 실행하는 방법을 보여줍니다:

from crewai import Agent, Task, Crew
from crewai_tools import MultiOnTool

# Initialize the tool
multion_tool = MultiOnTool(api_key="YOUR_MULTION_API_KEY", local=False)

# Define an agent that uses the tool
browser_agent = Agent(
    role="Browser Agent",
    goal="Control web browsers using natural language",
    backstory="An expert browsing agent.",
    tools=[multion_tool],
    verbose=True,
)

# Example task to search and summarize news
browse_task = Task(
    description="Summarize the top 3 trending AI News headlines",
    expected_output="A summary of the top 3 trending AI News headlines",
    agent=browser_agent,
)

# Create and run the crew
crew = Crew(agents=[browser_agent], tasks=[browse_task])
result = crew.kickoff()

파라미터 (Parameters)

MultiOnTool은 초기화 시 다음 파라미터를 받습니다:

  • api_key: 선택. MultiOn API 키 지정. 제공되지 않으면 MULTION_API_KEY 환경 변수를 찾습니다.
  • local: 선택. True로 설정하면 에이전트를 브라우저에서 로컬로 실행합니다. MultiOn 브라우저 확장 프로그램이 설치되어 있고 API Enabled가 체크되어 있어야 합니다. 기본값은 False.
  • max_steps: 선택. MultiOn 에이전트가 한 명령에 대해 취할 수 있는 최대 단계 수. 기본값은 3.

사용법 (Usage)

MultiOnTool을 사용할 때 에이전트가 제공하는 자연어 지시를 도구가 웹 브라우징 액션으로 변환합니다. 도구는 브라우징 세션의 결과와 상태(status)를 반환합니다.

# Example of using the tool with an agent
browser_agent = Agent(
    role="Web Browser Agent",
    goal="Search for and summarize information from the web",
    backstory="An expert at finding and extracting information from websites.",
    tools=[multion_tool],
    verbose=True,
)

# Create a task for the agent
search_task = Task(
    description="Search for the latest AI news on TechCrunch and summarize the top 3 headlines",
    expected_output="A summary of the top 3 AI news headlines from TechCrunch",
    agent=browser_agent,
)

# Run the task
crew = Crew(agents=[browser_agent], tasks=[search_task])
result = crew.kickoff()

반환된 상태가 CONTINUE라면, 에이전트에게 동일한 지시를 다시 내려 실행을 계속하도록 해야 합니다.

구현 세부사항 (Implementation Details)

MultiOnTool은 CrewAI의 BaseTool의 하위 클래스로 구현됩니다. 웹 브라우징 기능을 제공하기 위해 MultiOn 클라이언트를 감쌉니다:

class MultiOnTool(BaseTool):
    """Tool to wrap MultiOn Browse Capabilities."""

    name: str = "Multion Browse Tool"
    description: str = """Multion gives the ability for LLMs to control web browsers using natural language instructions.
            If the status is 'CONTINUE', reissue the same instruction to continue execution
        """
    
    # Implementation details...
    
    def _run(self, cmd: str, *args: Any, **kwargs: Any) -> str:
        """
        Run the Multion client with the given command.
        
        Args:
            cmd (str): The detailed and specific natural language instruction for web browsing
            *args (Any): Additional arguments to pass to the Multion client
            **kwargs (Any): Additional keyword arguments to pass to the Multion client
        """
        # Implementation details...

결론 (Conclusion)

MultiOnTool은 웹 브라우징 기능을 CrewAI 에이전트에 통합하는 강력한 방법을 제공합니다. 에이전트가 자연어 지시로 웹사이트와 상호작용할 수 있게 함으로써, 데이터 수집과 연구에서 웹 서비스와의 자동화된 상호작용에 이르기까지 웹 기반 태스크의 다양한 가능성을 열어줍니다.

더 알아보기 (Learn more)