SQL Agent는 SQL 데이터베이스를 데이터 소스로 사용합니다. 자연어 질문을 이해하고, 이를 SQL 쿼리로 변환하여 실행한 다음, 결과를 사용자 친화적인 형식으로 제공할 수 있습니다. 이 에이전트는 데이터베이스에 대한 자연어 인터페이스를 구축하는 데 유용합니다.

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

노드 매개변수#

다음 매개변수를 사용하여 SQL Agent를 구성합니다.

Data Source#

노드의 데이터 소스로 사용할 데이터베이스를 선택합니다. 옵션은 다음과 같습니다.

• MySQL: MySQL 데이터베이스를 사용하려면 이 옵션을 선택합니다.
  • Credential for MySQL도 선택합니다.
• SQLite: SQLite 데이터베이스를 사용하려면 이 옵션을 선택합니다.
  • SQLite 파일을 읽으려면 Agent 앞에 디스크에서 파일 읽기/쓰기 노드를 추가해야 합니다.
  • Read/Write File From Disk 노드에서 전달되는 SQLite 파일의 Input Binary Field 이름도 입력합니다.
• Postgres: Postgres 데이터베이스를 사용하려면 이 옵션을 선택합니다.
  • Credential for Postgres도 선택합니다.

Prompt#

노드 옵션#

다음 옵션을 사용하여 SQL Agent 노드의 동작을 조정합니다.

Ignored Tables#

노드가 데이터베이스의 특정 테이블을 무시하도록 하려면, 무시할 테이블 이름을 쉼표로 구분하여 입력합니다.

비워두면 에이전트는 어떤 테이블도 무시하지 않습니다.

Include Sample Rows#

에이전트에게 보내는 프롬프트에 포함할 샘플 행의 수를 입력합니다. 기본값은 3입니다.

샘플 행은 에이전트가 데이터베이스의 스키마를 이해하는 데 도움이 되지만, 사용되는 토큰 수도 늘어납니다.

Included Tables#

데이터베이스의 특정 테이블만 포함하려면, 포함할 테이블 이름을 쉼표로 구분하여 입력합니다.

비워두면 에이전트는 모든 테이블을 포함합니다.

Prefix Prompt#

Prompt 텍스트 앞에 에이전트로 보낼 메시지를 입력합니다. 이 초기 메시지는 에이전트에게 할 수 있는 것과 할 수 없는 것, 그리고 응답 형식을 지정하는 방법에 대한 더 많은 맥락과 지침을 제공할 수 있습니다.

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

Suffix Prompt#

Prompt 텍스트 뒤에 에이전트로 보낼 메시지를 입력합니다.

사용 가능한 LangChain 표현식:

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

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

Limit#

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

기본값은 10입니다.

Tracing Metadata#

템플릿 및 예시#

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

일반적인 문제#

일반적인 질문이나 문제, 그리고 권장 해결 방법은 일반적인 문제를 참고하세요.