Rube MCP를 통한 Agentql 자동화
Composio의 Agentql 툴킷을 Rube MCP를 통해 Agentql 작업을 자동화합니다.
툴킷 문서: composio.dev/toolkits/agentql
사전 요구 사항
- Rube MCP가 연결되어 있어야 함 (
RUBE_SEARCH_TOOLS사용 가능) RUBE_MANAGE_CONNECTIONS를 통해agentql툴킷으로 활성화된 Agentql 연결이 필요함- 항상
RUBE_SEARCH_TOOLS를 먼저 호출하여 최신 도구 스키마를 가져오세요
설정
Rube MCP 가져오기: 클라이언트 설정에서 MCP 서버로 https://rube.app/mcp를 추가하세요. API 키는 필요 없으며, 엔드포인트만 추가하면 작동합니다.
RUBE_SEARCH_TOOLS가 응답하는지 확인하여 Rube MCP가 사용 가능한지 확인RUBE_MANAGE_CONNECTIONS를agentql툴킷으로 호출- 연결이 ACTIVE 상태가 아니면 반환된 인증 링크를 따라 설정을 완료
- 워크플로우를 실행하기 전에 연결 상태가 ACTIVE인지 확인
도구 검색
워크플로우를 실행하기 전에 항상 사용 가능한 도구를 검색하세요:
RUBE_SEARCH_TOOLS
queries: [{use_case: "Agentql 작업", known_fields: ""}]
session: {generate_id: true}
이 호출은 사용 가능한 도구 슬러그, 입력 스키마, 권장 실행 계획 및 알려진 함정을 반환합니다.
핵심 워크플로우 패턴
1단계: 사용 가능한 도구 검색
RUBE_SEARCH_TOOLS
queries: [{use_case: "특정 Agentql 태스크"}]
session: {id: "기존_세션_id"}
2단계: 연결 확인
RUBE_MANAGE_CONNECTIONS
toolkits: ["agentql"]
session_id: "세션_id"
3단계: 도구 실행
RUBE_MULTI_EXECUTE_TOOL
tools: [{
tool_slug: "검색_결과의_TOOL_SLUG",
arguments: {/* 검색 결과에서 얻은 스키마 호환 인자 */}
}]
memory: {}
session_id: "세션_id"
알려진 함정
- 항상 먼저 검색하세요: 도구 스키마는 변경됩니다.
RUBE_SEARCH_TOOLS를 호출하지 않고 도구 슬러그나 인자를 하드코딩하지 마세요 - 연결 확인: 도구를 실행하기 전에
RUBE_MANAGE_CONNECTIONS가 ACTIVE 상태를 표시하는지 확인 - 스키마 준수: 검색 결과에서 정확한 필드 이름과 유형을 사용하세요
- memory 매개변수:
RUBE_MULTI_EXECUTE_TOOL호출에는 항상memory를 포함하세요. 비어 있어도 ({}) 괜찮습니다 - 세션 재사용: 워크플로우 내에서는 세션 ID를 재사용하고, 새로운 워크플로우에는 새 ID를 생성하세요
- 페이지네이션: 응답에서 페이지네이션 토큰을 확인하고, 완료될 때까지 계속 가져오세요
빠른 참조
| 작업 | 접근 방식 |
|---|---|
| 도구 찾기 | Agentql 관련 사용 사례로 RUBE_SEARCH_TOOLS |
| 연결 | agentql 툴킷으로 RUBE_MANAGE_CONNECTIONS |
| 실행 | 검색된 도구 슬러그로 RUBE_MULTI_EXECUTE_TOOL |
| 대량 작업 | run_composio_tool()을 사용한 RUBE_REMOTE_WORKBENCH |
| 전체 스키마 | schemaRef가 있는 도구에 RUBE_GET_TOOL_SCHEMAS |
Composio 제공