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도 선택합니다.

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에게 무엇을 할 수 있고 없는지, 응답 형식을 어떻게 지정할지에 대한 더 많은 컨텍스트와 지침을 제공할 수 있습니다.

n8n이 이 필드에 예시를 채워넣습니다.

Suffix Prompt#

Prompt 텍스트 뒤에 Agent에게 보낼 메시지를 입력합니다.

사용 가능한 LangChain 표현식:

• {chatHistory}: 이 대화의 메시지 기록으로, 컨텍스트를 유지하는 데 유용합니다.
• {input}: 사용자 프롬프트를 포함합니다.
• {agent_scratchpad}: 다음 반복을 위해 기억할 정보입니다.

n8n이 이 필드에 예시를 채워넣습니다.

Limit#

반환할 최대 결과 수를 입력합니다.

기본값은 10입니다.

Tracing Metadata#

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

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

템플릿 및 예제#

메인 AI Agent 노드의 Templates and examples 섹션을 참고하세요.

일반적인 문제#

자주 묻는 질문이나 문제 및 제안된 해결책은 Common issues를 참고하세요.