에이전트

에이전트 도구

FlowHunt AI Studio에서 AI 에이전트가 호출할 수 있는 도구를 선택하고, MCP 서버를 연결하며, 계정이 필요한 도구를 해결하는 방법을 알아보세요.

Open in ChatGPT Open in Claude

도구는 에이전트가 텍스트로만 답하는 대신 세상에 작용하는 방식입니다. 에이전트는 대화 중에 도구의 설명과 시스템 메시지를 바탕으로 도구를 호출할지 결정합니다. 빌더에서 도구는 Preferences 탭의 Apps 섹션에 있습니다.

작게 시작하세요

에이전트에게는 그 업무에 필요한 도구만 제공하세요. 도구가 적을수록 더 빠르고 예측하기 쉬워집니다.

새 에이전트가 가진 것#

새 에이전트는 세 가지 도구로 시작합니다:

원하지 않는 도구는 제거하세요.

도구 추가하기#

  1. Apps에서 Add app을 클릭합니다. 아직 앱이 없으면 해당 섹션에 No apps yet과 동일한 버튼이 표시됩니다.
  2. 대화 상자 상단의 전환 스위치에는 두 가지 소스가 있습니다: Use FlowHunt tools와 Connect your MCP.
  3. Use FlowHunt tools에서 **Search tools…**로 검색하고 도구를 선택합니다. 에이전트 빌더에서는 Connected 필터가 켜진 상태로 대화 상자가 열리므로, 목록은 워크스페이스에서 이미 사용할 수 있는 도구부터 시작합니다. Connected를 클릭하면 필터가 꺼지고 나머지 도구가 표시됩니다.
  4. 매개변수가 있는 도구의 경우, Configure Tool 단계에서 각 매개변수를 AI가 결정할지(AI Decides) 아니면 직접 고정할지(User-defined) 정할 수 있습니다. 잠근 매개변수는 에이전트가 편집할 수 없습니다. 기본값을 유지하려면 Skip & Add를, 직접 지정한 값을 사용하려면 Add with Config를 선택하세요.

각 앱은 도구, 상태, 그리고 App actions라는 점 세 개 메뉴가 있는 행으로 표시됩니다. 다시 제거하려면 Remove app을 사용하세요.

에이전트를 위해 도구 이름 바꾸기#

도구 구성의 Advanced Settings에서 에이전트가 보는 Tool Name과 Tool Description을 재정의할 수 있습니다. 서로 다른 작업을 위해 같은 도구를 두 번 추가할 때 이렇게 하세요. 이름에는 문자, 숫자, 밑줄을 사용할 수 있으며, 두 도구의 이름이 충돌하면 FlowHunt가 고유한 이름을 요청합니다. 설명은 “이럴 때 이 도구를 사용하세요…“라고 알려줄 수 있는 곳입니다.

MCP 서버 연결하기#

대화 상자에서 Connect your MCP를 선택하면 Model Context Protocol 서버를 추가할 수 있습니다. 에이전트의 모든 MCP 서버는 하나의 MCP Client 항목에 함께 저장됩니다. 서버 행에는 상태가 표시됩니다:

  • Connected: 서버가 설정되어 사용할 준비가 되었습니다.
  • Authorized: OAuth로 로그인했습니다.
  • Connect: 서버에 자격 증명이 필요합니다. Configure connection을 사용하세요.

자체 서버를 호스팅하려면 hosted MCP servers를 참고하세요.

계정이 필요한 도구 해결하기#

Connect로 표시된 도구 행에는 통합이 필요합니다. 클릭하여 연결 대화 상자를 열고 로그인하면 상태가 Connected로 바뀝니다. connecting accounts를 참고하세요.

문제가 생겼을 때#

  • 에이전트가 도구를 전혀 사용하지 않는다면 System Message에서 도구 이름을 언급하고 도구 설명을 구체적으로 작성하세요.
  • 실행 중에 도구가 실패한다면 원인은 보통 연결이 끊긴 계정입니다. integration disconnected를 참고하세요.

다음 단계#

기본 설정 에이전트가 언제 도구를 사용해야 하는지 알려주는 시스템 메시지를 작성하세요. 통합 사용하기 에이전트가 작동할 수 있는 서비스를 연결하세요.