Tools Agent는 외부 도구(tool)와 API를 사용하여 작업을 수행하고 정보를 검색합니다. 다양한 도구의 기능을 이해하고, 작업에 따라 적절한 도구를 선택하여 사용할 수 있습니다. 이 에이전트는 LLM을 다양한 외부 서비스 및 데이터베이스와 통합하는 데 도움을 줍니다.

이 에이전트는 도구 사용 능력이 향상되었으며, 표준 출력 형식을 보장할 수 있습니다.

Tools Agent는 Langchain의 tool calling 인터페이스를 구현합니다. 이 인터페이스는 사용 가능한 도구와 해당 스키마를 기술합니다. 또한 에이전트는 파서를 포맷팅 도구로 모델에 전달하여 출력 파싱 능력이 향상되었습니다.

AI Agent 노드 자체에 대한 자세한 내용은 AI Agent를 참고하세요.

이 에이전트는 Chat Trigger 노드와 함께 사용할 수 있습니다. 메모리 서브 노드를 연결하면 사용자가 여러 쿼리로 대화를 이어갈 수 있습니다. 메모리는 세션 간에 유지되지 않습니다.

이 에이전트는 다음 채팅 모델을 지원합니다:

• OpenAI Chat Model
• Groq Chat Model
• Mistral Cloud Chat Model
• Anthropic Chat Model
• Azure OpenAI Chat Model

Tools Agent에서 사용할 수 있는 도구 목록...

• Call n8n Workflow
• Code
• HTTP Request
• Action Network
• ActiveCampaign
• Affinity
• Agile CRM
• Airtable
• APITemplate.io
• Asana
• AWS Lambda
• AWS S3
• AWS SES
• AWS Textract
• AWS Transcribe
• Baserow
• Bubble
• Calculator
• ClickUp
• CoinGecko
• Compression
• Crypto
• DeepL
• DHL
• Discord
• Dropbox
• Elasticsearch
• ERPNext
• Facebook Graph API
• FileMaker
• Ghost
• Git
• GitHub
• GitLab
• Gmail
• Google Analytics
• Google BigQuery
• Google Calendar
• Google Chat
• Google Cloud Firestore
• Google Cloud Realtime Database
• Google Contacts
• Google Docs
• Google Drive
• Google Sheets
• Google Slides
• Google Tasks
• Google Translate
• Google Workspace Admin
• Gotify
• Grafana
• GraphQL
• Hacker News
• Home Assistant
• HubSpot
• Jenkins
• Jira Software
• JWT
• Kafka
• LDAP
• Line
• LinkedIn
• Mailcheck
• Mailgun
• Mattermost
• Mautic
• Medium
• Microsoft Excel 365
• Microsoft OneDrive
• Microsoft Outlook
• Microsoft SQL
• Microsoft Teams
• Microsoft To Do
• Monday.com
• MongoDB
• MQTT
• MySQL
• NASA
• Nextcloud
• NocoDB
• Notion
• Odoo
• OpenWeatherMap
• Pipedrive
• Postgres
• Pushover
• QuickBooks Online
• QuickChart
• RabbitMQ
• Reddit
• Redis
• RocketChat
• S3
• Salesforce
• Send Email
• SendGrid
• SerpApi (Google Search)
• Shopify
• Slack
• Spotify
• Stripe
• Supabase
• Telegram
• Todoist
• TOTP
• Trello
• Twilio
• urlscan.io
• Vector Store
• Webflow
• Wikipedia
• Wolfram|Alpha
• WooCommerce
• Wordpress
• X (Formerly Twitter)
• YouTube
• Zendesk
• Zoho CRM
• Zoom

노드 파라미터#

다음 파라미터를 사용하여 Tools Agent를 구성합니다.

Prompt#

노드가 프롬프트(사용자의 쿼리 또는 채팅에서의 입력)를 구성하는 방법을 선택합니다.

다음 중에서 선택합니다:

• Take from previous node automatically: 이 옵션을 선택하면 노드가 chatInput이라는 이전 노드의 입력을 기대합니다.
• Define below: 이 옵션을 선택하면 Prompt (User Message) 필드에 프롬프트로 사용할 정적 텍스트 또는 동적 콘텐츠를 위한 표현식을 제공합니다.

Require Specific Output Format#

이 파라미터는 노드가 특정 출력 형식을 요구할지 여부를 제어합니다. 켜면 n8n이 다음 출력 파서 중 하나를 노드에 연결하도록 요청합니다:

• Auto-fixing Output Parser
• Item List Output Parser
• Structured Output Parser

노드 옵션#

다음 옵션을 사용하여 Tools Agent 노드의 동작을 세부 조정합니다:

System Message#

대화가 시작되기 전에 에이전트에게 메시지를 보내려면 보낼 메시지를 입력합니다.

이 옵션을 사용하여 에이전트의 의사 결정을 안내합니다.

Max Iterations#

사용자의 프롬프트에서 좋은 답변을 생성하기 위해 모델이 실행해야 하는 횟수를 입력합니다.

기본값은 10입니다.

Return Intermediate Steps#

에이전트가 수행한 중간 단계를 최종 출력에 포함할지(켜짐) 여부(꺼짐)를 선택합니다.

에이전트가 수행한 단계를 기반으로 에이전트의 동작을 추가로 개선하는 데 유용할 수 있습니다.

Tracing Metadata#

이 에이전트의 추적 이벤트에 커스텀 키-값 메타데이터를 추가합니다. LangSmith와 같은 추적 도구에서 실행을 필터링하고 디버깅하는 데 유용합니다.

키 또는 값이 비어 있는 항목은 무시됩니다.

Automatically Passthrough Binary Images#

이 옵션을 사용하여 바이너리 이미지를 자동으로 이미지 타입 메시지로 에이전트에 전달할지(켜짐) 여부(꺼짐)를 제어합니다.

Enable Streaming#

활성화하면 AI Agent가 답변을 생성하면서 실시간으로 데이터를 사용자에게 전송합니다. 오래 걸리는 생성 작업에 유용합니다. 기본값은 활성화입니다.

템플릿 및 예제#

메인 AI Agent 노드의 템플릿 및 예제 섹션을 참고하세요.

$fromAI()를 사용한 도구의 동적 파라미터#

앱 노드 도구의 파라미터를 동적으로 채우는 방법은 $fromAI()로 AI가 도구 파라미터 지정하기를 참고하세요.

도구 호출에 대한 사람의 검토#

AI Agent가 특정 도구를 실행하기 전에 사람의 승인을 요구할 수 있습니다. 메시지 전송, 레코드 수정, 데이터 삭제 등 민감한 작업을 수행하는 도구에 유용합니다.

사람의 검토 단계를 추가하려면:

1. AI Agent 노드의 tool connector를 클릭합니다.
2. Tools Panel에서 Human review 섹션을 찾습니다.
3. 원하는 승인 채널(Chat, Slack, Telegram 등)을 선택하고 구성합니다.
4. 승인이 필요한 도구를 human review 단계에 연결합니다.

AI가 게이팅된 도구를 사용하려 하면, 워크플로가 일시 중지되고 선택한 채널을 통해 승인 요청을 전송합니다. 수신자는 승인(도구 실행) 또는 거부(작업 취소)할 수 있습니다.

자세한 설정 방법과 모범 사례는 AI 도구 호출을 위한 Human-in-the-loop를 참고하세요.

공통 문제#

자주 묻는 질문, 문제 및 제안 솔루션은 공통 문제를 참고하세요.