เซิร์ฟเวอร์ Databricks Genie MCP | คู่มือ n8n ภาษาไทย

Cluster nodes · AI และองค์ประกอบย่อย · Databricks Genie MCP server

เชื่อมต่อเอเจนต์ n8n AI กับ Databricks Genie ผ่านเซิร์ฟเวอร์ Databricks Genie MCP ในรีจีสทรีเซิร์ฟเวอร์ MCP ของ n8n และปรับแต่งเอเจนต์สำหรับการโพลของ Genie

ที่ Databricks Genie ไทล์ใน n8n's เซิร์ฟเวอร์ MCP รีจิสตรีเชื่อมต่อ AI Agent กับ เซิร์ฟเวอร์ Genie MCP ในพื้นที่ทำงาน Databricks ของคุณ Genie ตอบคำถามที่เป็นภาษาธรรมชาติเกี่ยวกับข้อมูลของคุณโดยการสร้างและเรียกใช้ SQL กับตารางในพื้นที่ Genie ของคุณ กระเบื้องมีป้ายกำกับ ขับเคลื่อนโดยจีนี่ (Powered by Genie) และทุกคำตอบจะเชื่อมโยงกลับไปยังการสนทนาใน Databricks

ในหน้านี้ คุณจะพบข้อกำหนดเบื้องต้น ขั้นตอนการตั้งค่า การตั้งค่าตัวแทน และปัญหาที่ทราบในการใช้ Genie กับตัวแทน n8n

Credentials

กระเบื้องใช้ก credentials Databricks OAuth2 ด้วยการเข้าสู่ระบบของผู้ใช้ ไม่มีบริการหลักหรือ token การเข้าถึงส่วนบุคคล

ข้อกำหนดเบื้องต้น

ผู้ดูแลบัญชี Databricks มี สร้างการเชื่อมต่อแอป OAuth ที่กำหนดเอง ซึ่งมีขอบเขตครอบคลุมคำขอของไทล์ กระเบื้องร้องขอการ genie และ offline_access ขอบเขต การเชื่อมต่อแอพที่มีเพียงสองขอบเขตนั้นเป็นการตั้งค่าที่แคบที่สุด และ n8n จะแนะนำเมื่อการเชื่อมต่อให้บริการเฉพาะ Genie เท่านั้น All APIs ยังครอบคลุมถึงคำขอในการทดสอบของ n8n ด้วย ใช้เฉพาะเมื่อการเชื่อมต่อแอปเดียวกันให้บริการ node Databricks หรือ node Databricks Chat Model ที่ต้องการ หากการเชื่อมต่อล้มเหลวด้วย genie ข้อผิดพลาดของขอบเขต ผู้ดูแลระบบ เพิ่ม genie ขอบเขต สู่การเชื่อมต่อแอพ
คุณมี CAN RUN บนพื้นที่ Genie และ CAN USE บนคลังสินค้า SQL อ้างถึง สิทธิ์ Databricks ที่จำเป็น .
รูปแบบการแชทที่เรียกใช้เครื่องมือได้อย่างน่าเชื่อถือ n8n ขอแนะนำ Databricks Chat Model node ที่มี Llama 3.3 70B หรือ Qwen 3.5 อ้างถึง เลือกรุ่นสำหรับตัวแทน .

เชื่อมต่อ Genie กับตัวแทน

เซิร์ฟเวอร์ Genie MCP ใช้การรับรองความถูกต้องประเภทเดียว นั่นคือการเข้าสู่ระบบของผู้ใช้ เอเจนต์ถามคำถาม Genie ในฐานะผู้ใช้ Databricks ที่เชื่อมต่อข้อมูลประจำตัว ดังนั้นผู้ใช้ n8n แต่ละคนจึงสร้างข้อมูลประจำตัวของตนเอง

เปิดอัน AI Agent node บนผืนผ้าใบและเลือก + บนมัน Tool ขั้วต่อ
ค้นหา Databricks Genie หรือเปิด MCP Servers ส่วนเพื่อเรียกดูรีจิสทรี
เลือก Databricks Genie กระเบื้อง n8n เพิ่ม node Databricks Genie ให้กับเอเจนต์และเปิดการตั้งค่า
ภายใต้ Credential to connect with ให้เลือก Create new credential.
ป้อน URL ของพื้นที่ทำงานของคุณเป็น Host ตัวอย่างเช่น https://adb-1234567890123456.7.azuredatabricks.net.
ป้อน Client ID และ Client Secret จากการเชื่อมต่อแอป OAuth แบบกำหนดเองที่ผู้ดูแลระบบของคุณสร้างขึ้น
เลือก Connect my account และลงชื่อเข้าใช้ Databricks
ใน Tools to Include เก็บไว้ All เพื่อให้ตัวแทนสามารถสอบถาม สำรวจ ดึงผลลัพธ์ และยกเลิกได้ อ้างถึง เครื่องมือ .
กำหนดตัวแทน Max Iterations ตัวเลือกถึง 30 หรือมากกว่า อ้างถึง กำหนดค่าตัวแทนสำหรับ Genie .

ส่งคำถามเกี่ยวกับข้อมูลของคุณให้กับตัวแทน เช่น "ตารางการเดินทางมีกี่เที่ยว" คำตอบรวมถึงคำตอบของ Genie และ Explore in Databricks ลิงค์

เครื่องมือ

จีนี่เปิดเผยเครื่องมือสี่อย่าง Databricks เลือกพื้นที่ Genie ดังนั้นจึงไม่มี parameter ช่องว่าง ตารางแสดงชื่อเครื่องมือแบบสั้นของ Databricks ใน n8n เอเจนต์จะเห็นแต่ละชื่อนำหน้าด้วยชื่อเซิร์ฟเวอร์ เป็นต้น Databricks_Genie_MCP_genie_ask ดังนั้นอย่าอ้างอิงชื่อย่อในข้อความแจ้ง

เครื่องมือ	มันทำอะไร
`genie_ask`	เริ่มการสนทนา Genie ด้วยคำถาม หรือสนทนาต่อด้วย a `conversation_id` . คืนสถานะโดยไม่ต้องรอคำตอบ
`genie_poll_response`	ตรวจสอบว่า Genie เสร็จสิ้นแล้วหรือไม่ Databricks แนะนำให้รอ 2 ถึง 5 วินาทีระหว่างโพล
`genie_get_query_result`	ดึงข้อมูลแถวผลลัพธ์ทั้งหมดของ SQL Genie ที่รัน เมื่อสรุปคำตอบยังไม่เพียงพอ
`genie_cancel_response`	ยกเลิกเทิร์น Genie ที่กำลังรันอยู่

กำหนดค่าตัวแทนสำหรับ Genie

Genie ตอบแบบอะซิงโครนัส ตัวแทนโทรมา genie_ask แล้วโทร genie_poll_response จนกระทั่งจินนี่รายงานว่ามันเสร็จสิ้นแล้ว การสำรวจความคิดเห็นแต่ละครั้งมีค่าใช้จ่ายในการทำซ้ำตัวแทนหนึ่งครั้ง: genie_poll_response โทรบวกโมเดลเทิร์นที่ตัดสินใจโพลอีกครั้ง Databricks ระบุว่าโดยทั่วไปแล้ว Genie จะเปลี่ยนตัวเสร็จภายใน 70 ถึง 260 วินาที และแนะนำ 2 ถึง 5 วินาทีระหว่างโพล ดังนั้น หนึ่งคำตอบอาจใช้เวลาตั้งแต่ 14 ถึง 130 รอบ

Raise Max Iterations. ค่าเริ่มต้นของ AI Agent คือ 10 ล้มเหลวสำหรับคำถามที่สมจริง ชุด Max Iterations ถึง 30 หรือมากกว่า คำถามที่อยู่ปลายสุดช้าของช่วงของ Databricks ยังสามารถถึงขีดจำกัดได้ ดังนั้นควรเพิ่มคำถามให้มากขึ้นหากคุณเห็นจุดตัด
รู้ว่าจุดตัดมีลักษณะอย่างไร. (Know how the cutoff looks.) node AI Agent เวอร์ชัน 3 ล้มเหลวในการดำเนินการด้วย Max iterations (30) reached . AI Agent เวอร์ชันเก่าประสบความสำเร็จในการตอบกลับ Agent stopped due to max iterations. ซึ่งดูเหมือนคำตอบแต่ไม่ใช่คำตอบเดียว Genie วิ่งต่อไปทางฝั่ง Databricks หลังจากถูกตัดออก
นำทางโมเดล (Guide the model.) ข้อความของระบบดังต่อไปนี้ทำให้การวนซ้ำแน่นและรักษาลิงก์การระบุแหล่งที่มา:
```
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 และไม่มีการรันเครื่องมือ
ดูขีดจำกัดอัตราโมเดลการแชท (Watch chat model rate limits.) Genie เองไม่ได้เร่งรัดในการทดสอบของ n8n แต่จุดสิ้นสุดโมเดลแบบจ่ายต่อ token ทำได้ การเรียกใช้ตัวแทนพร้อมกันสามครั้งนั้นเพียงพอที่จะทำให้การดำเนินการล้มเหลวโดยมีข้อผิดพลาดขีดจำกัดอัตราจากโมเดลการแชท ใช้ปลายทางการรับส่งข้อมูลที่จัดเตรียมไว้หรือรักษาการทำงานพร้อมกันให้ต่ำ

การระบุแหล่งที่มาของยีน

Databricks ต้องการการบูรณาการที่ขับเคลื่อนโดย Genie เพื่อระบุ Genie ใน n8n:

ไทล์ในแผง node และคำอธิบายของ node จะมี ขับเคลื่อนโดยจีนี่ (Powered by Genie) ฉลาก
ทุกคำตอบของ Genie ที่กรอกเสร็จแล้วจะมี Explore in Databricks ลิงก์ที่เปิดการสนทนาใน Genie ในพื้นที่ทำงานของคุณ เพื่อให้ผู้ใช้สามารถตรวจสอบ SQL และผลลัพธ์ได้ Genie สั่งให้โมเดลเรนเดอร์ลิงก์นี้ทุกคำ และ n8n จะส่งผ่านผลลัพธ์ของเครื่องมือโดยไม่มีการเปลี่ยนแปลง อย่าตัดลิงก์ในข้อความระบบหรือการแยกวิเคราะห์ output

ทรัพยากรที่เกี่ยวข้อง

Databricks credentials รวมถึง genie การตั้งค่าขอบเขตสำหรับผู้ดูแลระบบ
Databricks Chat Model
Databricks สำหรับการเรียก Genie REST API โดยตรงโดยไม่ต้องใช้ตัวแทน
เซิร์ฟเวอร์ MCP สำหรับวิธีการทำงานของรีจิสทรี
เซิร์ฟเวอร์ Genie MCP ในเอกสารประกอบของ Databricks

ปัญหาทั่วไป

การเชื่อมต่อล้มเหลวโดยมีข้อผิดพลาดเกี่ยวกับขอบเขตจินนี่ (Connect fails with a genie scope error)

การเลือก Connect my account ล้มเหลวด้วย:

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

การเชื่อมต่อแอป OAuth ที่กำหนดเองไม่มี genie ขอบเขตและในบัญชี Databricks นี้ All APIs ไม่ยืนหยัดเพื่อมัน ผู้ดูแลระบบบัญชี Databricks จำเป็นต้อง เพิ่ม genie ขอบเขต กับการเชื่อมต่อแอป ในเครื่องมือเลือกขอบเขตของคอนโซลบัญชี หรือด้วย Databricks CLI

ถึงการทำซ้ำสูงสุดแล้ว (Max iterations reached)

การดำเนินการล้มเหลวด้วย Max iterations (10) reached หรือตัวแทนตอบกลับ Agent stopped due to max iterations. . Genie ยังเล่นไม่จบเมื่อตัวแทนหมดการวนซ้ำ ยก Max Iterations ถึง 30 หรือมากกว่าบน node AI Agent อ้างถึง กำหนดค่าตัวแทนสำหรับ Genie .

เจ้าหน้าที่ไม่เคยโทรหาจีนี่เลย (The agent never calls Genie)

เอเจนต์ใช้การวนซ้ำทั้งหมดโดยไม่ต้องเรียกใช้เครื่องมือแม้แต่ครั้งเดียว สาเหตุสองประการมีลักษณะเหมือนกันในบันทึกการดำเนินการ:

ข้อความระบบของคุณระบุชื่อเครื่องมือต่างๆ เป็นต้น genie_ask . โมเดลเรียกชื่อแบบสั้น ซึ่งไม่ตรงกับชื่อที่นำหน้ารีจิสเตอร์ n8n และไม่มีเครื่องมือใดทำงาน อธิบายโฟลว์โดยไม่มีชื่อเครื่องมือ เช่น กำหนดค่าตัวแทนสำหรับ Genie .
โมเดลการแชทไม่ส่งคืนการเรียกเครื่องมือที่ตัวแทนสามารถดำเนินการได้ สลับไปใช้รุ่นที่เรียกใช้เครื่องมือได้อย่างน่าเชื่อถือ เช่น Llama 3.3 70B หรือ Qwen 3.5 ผ่าน โมเดลการแชท Databricks node

Genie รายงานข้อผิดพลาด SQL หรือสิทธิ์ (Genie reports a SQL or permission error)

Genie ส่งคืนข้อความแสดงข้อผิดพลาดของตัวเอง [TABLE_OR_VIEW_NOT_FOUND] The table or view samples.nyctaxi.does_not_exist cannot be found และตัวแทนก็ถ่ายทอดมัน แก้ไขปัญหาข้อมูลพื้นฐานหรือการให้สิทธิ์ใน Databricks ความต้องการของผู้ใช้ที่เชื่อมต่อ CAN RUN บนพื้นที่ Genie และสิทธิ์ Unity Catalog บนตารางที่พื้นที่ใช้