통합 도구 개요

통합 도구 개요 (Integration Tools Overview)

CrewAI의 통합(Integration) 도구들은 에이전트가 작업을 다른 자동화 플랫폼이나 관리형 AI 서비스에 넘겨줄 수 있게 해주는 도구 모음이에요. 기존 CrewAI 배포를 호출하거나 Amazon Bedrock 같은 제공업체에 특수 작업을 위임해야 하는 워크플로에서 사용하면 좋답니다.

출처: 문서

본문

통합 도구는 에이전트가 작업을 다른 자동화 플랫폼과 관리형 AI 서비스로 넘겨줄 수 있게 해줍니다. 기존 CrewAI 배포를 호출하거나 Amazon Bedrock 같은 제공업체에 특수 작업을 위임해야 하는 워크플로에서 사용하세요.

사용 가능한 도구 (Available Tools)

Merge Agent Handler Tool

Merge의 통합 API를 통해 Linear, GitHub, Slack 등 수백 개의 서드파티 도구에 안전하게 접근할 수 있어요.

CrewAI Run Automation Tool

에이전트에서 직접 라이브 CrewAI Platform 자동화를 호출하고, 커스텀 입력을 전달하고, 결과를 폴링(polling)해서 가져올 수 있어요.

Bedrock Invoke Agent Tool

크루(crew)에서 Amazon Bedrock Agents를 호출하고, AWS 가드레일을 재사용하고, 응답을 워크플로로 다시 스트리밍할 수 있습니다.

일반적인 사용 사례 (Common Use Cases)

자동화 체이닝: 다른 크루나 플로우 안에서 기존 CrewAI 배포를 시작(kick off)하기
엔터프라이즈 핸드오프: 회사 로직과 가드레일을 이미 담고 있는 Bedrock Agents에 작업 라우팅하기
하이브리드 워크플로: CrewAI 추론과 자체 에이전트 API를 노출하는 다운스트림 시스템을 결합하기
장기 실행 작업: 외부 자동화를 폴링하고 최종 결과를 현재 실행으로 병합하기

빠른 시작 예시 (Quick Start Example)

from crewai import Agent, Task, Crew
from crewai_tools import InvokeCrewAIAutomationTool
from crewai_tools.aws.bedrock.agents.invoke_agent_tool import BedrockInvokeAgentTool

# 외부 자동화
analysis_automation = InvokeCrewAIAutomationTool(
    crew_api_url="https://analysis-crew.acme.crewai.com",
    crew_bearer_token="YOUR_BEARER_TOKEN",
    crew_name="Analysis Automation",
    crew_description="Runs the production-grade analysis pipeline",
)

# Bedrock의 관리형 에이전트
knowledge_router = BedrockInvokeAgentTool(
    agent_id="bedrock-agent-id",
    agent_alias_id="prod",
)

automation_strategist = Agent(
    role="Automation Strategist",
    goal="Orchestrate external automations and summarise their output",
    backstory="You coordinate enterprise workflows and know when to delegate tasks to specialised services.",
    tools=[analysis_automation, knowledge_router],
    verbose=True,
)

execute_playbook = Task(
    description="Run the analysis automation and ask the Bedrock agent for executive talking points.",
    agent=automation_strategist,
)

Crew(agents=[automation_strategist], tasks=[execute_playbook]).kickoff()

모범 사례 (Best Practices)

자격 증명 보호: API 키와 bearer 토큰은 환경변수나 시크릿 매니저에 저장하세요
지연 시간 대비: 외부 자동화는 더 오래 걸릴 수 있으니 적절한 폴링 간격과 타임아웃을 설정하세요
세션 재사용: Bedrock Agents는 세션 ID를 지원하므로 여러 도구 호출에 걸쳐 컨텍스트를 유지할 수 있어요
응답 검증: 원격 출력(JSON, 텍스트, 상태 코드)을 다운스트림 작업으로 전달하기 전에 정규화하세요
사용량 모니터링: CrewAI Platform이나 AWS CloudWatch에서 감사 로그를 추적해 할당량 제한과 실패에 선제적으로 대응하세요

통합 도구 개요