n8n의 MCP 서버 레지스트리에 있는 Databricks Genie 타일은 AI 에이전트를 Databricks 워크스페이스의 Genie MCP 서버에 연결합니다. Genie는 Genie 스페이스에 있는 테이블을 대상으로 SQL을 생성하고 실행하여 데이터에 대한 자연어 질문에 답합니다. 이 타일에는 Powered by Genie 라벨이 붙어 있으며, 모든 답변에는 Databricks의 대화로 돌아가는 링크가 포함됩니다.

이 페이지에서는 n8n 에이전트와 함께 Genie를 사용하기 위한 사전 요구 사항, 설정 단계, 에이전트 설정, 알려진 문제를 설명합니다.

사전 요구 사항#

• Databricks 계정 관리자가 타일의 요청을 포함하는 범위로 사용자 지정 OAuth 앱 연결을 생성했습니다. 타일은 genie와 offline_access 범위를 요청합니다. 이 두 범위만 있는 앱 연결이 가장 좁은 설정이며, 연결이 Genie에만 사용되는 경우 n8n이 이를 권장합니다. n8n 테스트에서는 All APIs도 요청을 포함했습니다. 같은 앱 연결이 이를 필요로 하는 Databricks 노드나 Databricks Chat Model 노드에도 사용되는 경우에만 사용하세요. 연결이 genie 범위 오류로 실패하면 관리자가 앱 연결에 genie 범위를 추가합니다.
• Genie 스페이스에 대한 CAN RUN 권한과 해당 SQL 웨어하우스에 대한 CAN USE 권한이 있습니다. 필요한 Databricks 권한을 참조하세요.
• 도구를 안정적으로 호출하는 채팅 모델. n8n은 Llama 3.3 70B 또는 Qwen 3.5와 함께 Databricks Chat Model 노드를 사용할 것을 권장합니다. 에이전트용 모델 선택을 참조하세요.

Genie를 에이전트에 연결#

Genie MCP 서버는 사용자 로그인이라는 하나의 인증 유형을 사용합니다. 에이전트는 자격 증명을 연결한 Databricks 사용자로서 Genie에 질문하므로, n8n 사용자마다 자신의 자격 증명을 생성해야 합니다.

1. 캔버스에서 AI Agent 노드를 열고 Tool 커넥터의 **+**를 선택합니다.
2. Databricks Genie를 검색하거나 MCP Servers 섹션을 열어 레지스트리를 둘러봅니다.
3. Databricks Genie 타일을 선택합니다. n8n이 에이전트에 Databricks Genie 노드를 추가하고 해당 설정을 엽니다.
4. Credential to connect with에서 Create new credential을 선택합니다.
5. Host에 워크스페이스 URL을 입력합니다(예: https://adb-1234567890123456.7.azuredatabricks.net).
6. 관리자가 만든 사용자 지정 OAuth 앱 연결의 Client ID와 Client Secret을 입력합니다.
7. Connect my account를 선택하고 Databricks에 로그인합니다.
8. Tools to Include에서 에이전트가 질문하고, 폴링하고, 결과를 가져오고, 취소할 수 있도록 All을 유지합니다. 도구를 참조하세요.
9. 에이전트의 Max Iterations 옵션을 30 이상으로 설정합니다. Genie용 에이전트 구성을 참조하세요.

에이전트에 데이터에 대한 질문을 보내 보세요(예: "How many trips are in the trips table?"). 응답에는 Genie의 답변과 Explore in Databricks 링크가 포함됩니다.

도구#

Genie는 네 가지 도구를 제공합니다. Genie 스페이스는 Databricks가 선택하므로 스페이스 매개변수는 없습니다. 표에는 Databricks의 짧은 도구 이름이 나와 있습니다. n8n에서 에이전트는 각 이름 앞에 서버 이름이 붙은 형태로 보게 됩니다(예: Databricks_Genie_MCP_genie_ask). 따라서 프롬프트에서 짧은 이름을 참조하지 마세요.

Genie용 에이전트 구성#

Genie는 비동기로 응답합니다. 에이전트는 genie_ask를 호출한 다음, Genie가 완료되었다고 보고할 때까지 genie_poll_response를 호출합니다. 폴링할 때마다 에이전트 반복이 한 번 소모됩니다. genie_poll_response 호출과, 다시 폴링하기로 결정하는 모델 턴이 합쳐 한 번입니다. Databricks는 Genie 턴이 보통 70260초 안에 완료되며 폴링 사이에 25초를 권장한다고 밝히고 있으므로, 하나의 답변에 14~130회의 반복이 필요할 수 있습니다.

• Max Iterations를 높입니다. AI Agent의 기본값인 10으로는 현실적인 질문에서 실패합니다. Max Iterations를 30 이상으로 설정하세요. Databricks 범위에서 느린 쪽에 해당하는 질문은 여전히 제한에 걸릴 수 있으므로, 중간에 끊기는 것이 보이면 더 높이세요.

• 중단되는 모습을 알아 둡니다. AI Agent 노드 버전 3은 Max iterations (30) reached와 함께 실행이 실패합니다. 이전 AI Agent 버전은 Agent stopped due to max iterations.라는 응답과 함께 성공하는데, 이는 답변처럼 보이지만 답변이 아닙니다. 중단된 후에도 Genie는 Databricks 쪽에서 해당 턴을 계속 실행합니다.

• 모델을 안내합니다. 다음과 같은 시스템 메시지는 반복을 짧게 유지하고 출처 링크를 보존합니다.

  To answer data questions, ask Genie the question, then poll until the status is completed.
  Fetch the full result rows only if you need them.
  Include any [Explore in Databricks](url) link from the tool result in your reply, verbatim.
  

  시스템 메시지에 도구 이름을 쓰지 마세요. 프롬프트를 문자 그대로 따르는 모델이 n8n이 등록한 이름과 일치하지 않는 짧은 이름을 호출하게 되어 어떤 도구도 실행되지 않습니다.

• 채팅 모델의 속도 제한을 주시합니다. n8n 테스트에서 Genie 자체는 제한을 걸지 않았지만, 토큰 종량제 모델 엔드포인트는 제한을 겁니다. 에이전트를 동시에 세 개 실행하는 것만으로도 채팅 모델의 속도 제한 오류로 실행이 실패할 수 있습니다. 프로비저닝된 처리량 엔드포인트를 사용하거나 동시 실행 수를 낮게 유지하세요.

Genie 출처 표시#

Databricks는 Genie 기반 통합이 Genie를 식별하도록 요구합니다. n8n에서는 다음과 같이 처리됩니다.

• 노드 패널의 타일과 노드 설명에 Powered by Genie 라벨이 표시됩니다.
• 완료된 모든 Genie 답변에는 워크스페이스의 Genie에서 대화를 여는 Explore in Databricks 링크가 포함되어, 사용자가 SQL과 결과를 확인할 수 있습니다. Genie는 모델에 이 링크를 그대로 출력하도록 지시하며, n8n은 도구 결과를 변경 없이 전달합니다. 시스템 메시지나 출력 파싱에서 이 링크를 제거하지 마세요.

관련 리소스#

• 관리자를 위한 genie 범위 설정을 포함한 Databricks 자격 증명
• Databricks Chat Model 노드
• 에이전트 없이 Genie REST API를 직접 호출하는 Databricks 노드
• 레지스트리가 작동하는 방식에 대한 MCP 서버
• Databricks 문서의 Genie MCP 서버

일반적인 문제#

연결이 genie 범위 오류로 실패함#

Connect my account를 선택하면 다음 오류와 함께 실패합니다.

access_denied: Scopes 'genie' are not assigned to the client <client-id>

사용자 지정 OAuth 앱 연결에 genie 범위가 없으며, 이 Databricks 계정에서는 All APIs가 이를 대신하지 못합니다. Databricks 계정 관리자가 계정 콘솔의 범위 선택기에서 또는 Databricks CLI로 앱 연결에 genie 범위를 추가해야 합니다.

Max iterations에 도달함#

실행이 Max iterations (10) reached와 함께 실패하거나 에이전트가 Agent stopped due to max iterations.라고 응답합니다. 에이전트가 반복 횟수를 모두 소진했을 때 Genie가 아직 끝나지 않은 상태였습니다. AI Agent 노드에서 Max Iterations를 30 이상으로 높이세요. Genie용 에이전트 구성을 참조하세요.

에이전트가 Genie를 호출하지 않음#

에이전트가 도구를 한 번도 호출하지 않고 모든 반복을 소진합니다. 실행 로그에서는 똑같아 보이는 두 가지 원인이 있습니다.

• 시스템 메시지에 genie_ask와 같은 도구 이름이 들어 있습니다. 모델이 n8n이 등록한 접두사 붙은 이름과 일치하지 않는 짧은 이름을 호출하여 어떤 도구도 실행되지 않습니다. Genie용 에이전트 구성에서처럼 도구 이름 없이 흐름을 설명하세요.
• 채팅 모델이 에이전트가 실행할 수 있는 도구 호출을 반환하지 않습니다. Databricks Chat Model 노드를 통한 Llama 3.3 70B 또는 Qwen 3.5처럼 도구를 안정적으로 호출하는 모델로 바꾸세요.

Genie가 SQL 또는 권한 오류를 보고함#

Genie는 자체 오류 텍스트를 반환하며(예: [TABLE_OR_VIEW_NOT_FOUND] The table or view samples.nyctaxi.does_not_exist cannot be found), 에이전트가 이를 그대로 전달합니다. Databricks에서 근본적인 데이터 문제나 권한 부여 문제를 해결하세요. 연결된 사용자에게는 Genie 스페이스에 대한 CAN RUN 권한과 스페이스가 사용하는 테이블에 대한 Unity Catalog 권한이 필요합니다.