Tools AI Agent 노드 문서
n8n v2.29Tools Agent는 외부 도구1와 API를 사용하여 작업을 수행하고 정보를 검색합니다. 이 에이전트는 도구를 다루는 능력이 향상되었으며 표준 출력 형식을 보장할 수 있습니다. Tools Agent는 Langchain의 tool calling 인터페이스를 구현합니다.
Tools Agent는 외부 도구1와 API를 사용하여 작업을 수행하고 정보를 검색합니다. 다양한 도구의 기능을 이해하고 작업에 따라 어떤 도구를 사용할지 결정할 수 있습니다. 이 에이전트는 LLM을 다양한 외부 서비스 및 데이터베이스와 통합하는 데 도움이 됩니다.
이 에이전트는 도구를 다루는 능력이 향상되었으며 표준 출력 형식을 보장할 수 있습니다.
Tools Agent는 Langchain의 tool calling 인터페이스를 구현합니다. 이 인터페이스는 사용 가능한 도구와 그 스키마를 설명합니다. 또한 이 에이전트는 파서를 포맷팅 도구로 모델에 전달하므로 출력 파싱 기능도 향상되었습니다.
AI Agent 노드 자체에 대한 자세한 내용은 AI Agent를 참조하세요.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
이 에이전트는 다음 채팅 모델을 지원합니다.
- 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
- 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
- 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#
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
Require Specific Output Format#
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
노드 옵션#
다음 옵션을 사용하여 Tools Agent 노드의 동작을 세부 조정합니다.
System Message#
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
Max Iterations#
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
Return Intermediate Steps#
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
Tracing Metadata#
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
Automatically Passthrough Binary Images#
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
Enable Streaming#
이 옵션을 활성화하면 AI Agent는 답변을 생성하는 동안 실시간으로 데이터를 사용자에게 다시 전송합니다. 이는 장시간 실행되는 생성 작업에 유용합니다. 이 옵션은 기본적으로 활성화되어 있습니다.
스트리밍 요구 사항
스트리밍이 작동하려면 워크플로에서 스트리밍 응답을 지원하는 트리거를 사용해야 합니다. 예를 들어 Chat Trigger 또는 Response Mode가 Streaming으로 설정된 Webhook 노드가 있습니다.
템플릿 및 예시#
메인 AI Agent 노드의 템플릿 및 예시 섹션을 참조하세요.
$fromAI()를 사용한 도구의 동적 매개변수#
앱 노드 도구의 매개변수를 동적으로 채우는 방법을 알아보려면 $fromAI()로 AI가 도구 매개변수를 지정하도록 하기를 참조하세요.
도구 호출에 대한 사람 검토#
AI Agent가 특정 도구를 실행하기 전에 사람의 승인을 요구할 수 있습니다. 이는 메시지 전송, 레코드 수정, 데이터 삭제와 같이 민감한 작업을 수행하는 도구에 유용합니다.
사람 검토 단계를 추가하려면 다음과 같이 하세요.
- AI Agent 노드에서 도구 커넥터를 클릭합니다.
- Tools Panel에서 Human review 섹션을 찾습니다.
- 원하는 승인 채널(Chat, Slack, Telegram 등)을 선택하고 구성합니다.
- 승인이 필요한 도구를 사람 검토 단계에 연결합니다.
AI가 게이트가 설정된 도구를 사용하려고 하면 워크플로가 일시 중지되고 선택한 채널을 통해 승인 요청을 전송합니다. 수신자는 승인(도구 실행)하거나 거부(작업 취소)할 수 있습니다.
자세한 설정 지침과 모범 사례는 AI 도구 호출을 위한 Human-in-the-loop를 참조하세요.
일반적인 문제#
일반적인 질문이나 문제와 제안된 해결책은 일반적인 문제를 참조하세요.
Footnotes
-
AI 맥락에서 도구는 요청에 응답할 때 AI가 특정 정보나 기능을 참조할 수 있는 부가 리소스입니다. AI 모델은 도구를 사용하여 외부 시스템과 상호 작용하거나 특정한 집중 작업을 완료할 수 있습니다. ↩