SQL AI Agent 노드 문서

n8n의 AI Agent 노드에서 SQL Agent를 사용하는 방법을 배웁니다. SQL Agent를 워크플로우에 통합하기 위한 기술 문서를 따라 하세요.

기능 제거됨 n8n은 2025년 2월에 이 기능을 제거했습니다. SQL Agent는 SQL 데이터베이스를 데이터 소스로 사용합니다. 자연어 질문을 이해하고, SQL 쿼리로 변환하며, 쿼리를 실행하고, 결과를 사용자 친화적인 형식으로 제공할 수 있습니다. 이 Agent는 데이터베이스에 대한 자연어 인터페이스를 구축하는 데 유용합니다. AI Agent 노드 자체에 대한 자세한 내용은 AI Agent 를 참고하세요. 노드 파라미터 # 다음 파라미터를 사용하여 SQL Agent를 구성합니다. Data Source # 노드의 데이터 소스로 사용할 데이터베이스를 선택합니다. 옵션은 다음과 같습니다: MySQL : MySQL 데이터베이스를 사용하려면 이 옵션을 선택합니다. Credential for MySQL 도 선택합니다. SQLite : SQLite 데이터베이스를 사용하려면 이 옵션을 선택합니다. SQLite 파일을 읽기 위해 Agent 앞에 Read/Write File From Disk 노드를 추가해야 합니다. Read/Write File From Disk 노드에서 들어오는 SQLite 파일의 Input Binary Field 이름도 입력합니다. Postgres : Postgres 데이터베이스를 사용하려면 이 옵션을 선택합니다. Credential for Postgres 도 선택합니다. Postgres 및 MySQL Agents Postgres 또는 MySQL 을 사용하는 경우, 이 Agent는 credential 터널 옵션을 지원하지 않습니다. Prompt # 노드가 프롬프트(사용자의 쿼리 또는 채팅에서의 입력)를 구성하는 방법을 선택합니다. 다음 중에서 선택합니다: Take from previous node automatically : 이 옵션을 선택하면 노드가 chatInput 이라는 이전 노드의 입력을 기대합니다. Define below : 이 옵션을 선택하면 Prompt (User Message) 필드에 프롬프트로 사용할 정적 텍스트 또는 동적 콘텐츠를 위한 표현식을 제공합니다. 노드 옵션 # 다음 옵션을 사용하여 SQL Agent 노드의 동작을 세부 조정합니다: Ignored Tables # 노드가 데이터베이스의 특정 테이블을 무시하도록 하려면, 무시할 테이블의 쉼표로 구분된 목록을 입력합니다. 비워두면 Agent는 어떤 테이블도 무시하지 않습니다. Include Sample Rows # Agent에 대한 프롬프트에 포함할 샘플 행 수를 입력합니다. 기본값은 3 입니다. 샘플 행은 Agent가 데이터베이스의 스키마를 이해하는 데 도움이 되지만, 사용되는 토큰 수도 늘어납니다. Included Tables # 데이터베이스에서 특정 테이블만 포함하려면, 포함할 테이블의 쉼표로 구분된 목록을 입력합니다. 비워두면 Agent는 모든 테이블을 포함합니다. Prefix Prompt # Prompt 텍스트 앞에 Agent에게 보낼 메시지를 입력합니다. 이 초기 메시지는 Agent에게 무엇을 할 수 있고 없는지, 응답 형식을 어떻게 지정할지에 대한