Connect Pi

Gunakan Pi dengan model dan keterampilan melalui Unity Gateway. Unity Gateway CLI (ug) menangani proses masuk dan konfigurasi ruang kerja, atau Anda dapat mengonfigurasi koneksi secara manual. Pi tidak memiliki klien MCP bawaan, sehingga alat MCP memerlukan ekstensi Pi terpisah.

Prerequisites

Anda membutuhkan URL workspace Azure Databricks Anda dan akses ke model serta keterampilan yang ingin Anda gunakan. Untuk pengaturan manual, instal Pi dan miliki Azure Databricks personal access token.

Untuk konfigurasi manual, ganti <workspace-hostname> dengan hostname workspace Azure Databricks Anda dan <databricks-pat> dengan token Anda. Gunakan nama model lengkap yang tersedia di ruang kerja Anda, dan gabungkan entri konfigurasi ke dalam file yang ada, dengan tetap mempertahankan pengaturan yang tidak terkait.

Jika admin Anda sudah mengonfigurasi perangkat, ikuti instruksi pengaturan organisasi Anda.

Gunakan CLI Unity Gateway

Instal, uglalu jalankan perintah ini dari direktori proyek Anda:

ug pi

Pilih ruang kerja Anda dan masuk saat diminta. Perintah ini membuka Pi dengan model gateway yang telah Anda konfigurasikan. Mulai coding, atau masukkan /model untuk memilih model konfigurasi lain.

Konfigurasikan model secara manual

Instal Pi, lalu gabungkan konfigurasi ini ke dalam ~/.pi/agent/models.json:

{
  "providers": {
    "databricks-claude": {
      "baseUrl": "https://<workspace-hostname>/ai-gateway/anthropic",
      "api": "anthropic-messages",
      "apiKey": "<databricks-pat>",
      "authHeader": true,
      "compat": {
        "supportsEagerToolInputStreaming": false
      },
      "models": [{ "id": "system.ai.claude-sonnet-4-6" }]
    }
  }
}

Mulai pi dan pilih model dengan /model. Gunakan supportsEagerToolInputStreaming: false untuk model Claude melalui gateway.

Untuk keluarga model lain, tambahkan penyedia dengan API dan URL dasar yang sesuai. Gunakan field authHeader dan apiKey yang sama, lalu daftarkan ID model yang tersedia bagi Anda:

Model api baseUrl
GPT openai-responses https://<workspace-hostname>/ai-gateway/codex/v1
Gemini google-generative-ai https://<workspace-hostname>/ai-gateway/gemini/v1beta

Lihat dokumentasi konfigurasi model Pi.

Menambahkan keterampilan

Gunakan CLI Unity Gateway

Unduh keterampilan yang dipublikasikan:

ug skills add

Pilih keterampilan Anda, lalu mulai ulang Pi. Ia membaca unduhan dari ~/.agents/skills/. Minta Pi untuk menggunakan keahlian atau memanggil /skill:<name> dengan menggunakan nama yang ada di SKILL.md.

Konfigurasikan keterampilan secara manual

Untuk berkas yang sudah Anda miliki, tempatkan setiap folder skill yang lengkap di ~/.agents/skills/ atau di .pi/skills/ proyek Anda. Lihat dokumentasi keterampilan Pi.

Dukungan MCP

Pi tidak memiliki klien MCP bawaan, dan ug mcp add tidak mendukung Pi. Gunakan keterampilan yang diunduh; Layanan MCP dan registri keterampilan memerlukan ekstensi Pi terpisah. Lihat dokumentasi ekstensi Pi.

Keterampilan Unity Gateway masih dalam tahap Beta. Lihat Mengatur keterampilan untuk pemberdayaan dan izin.

Troubleshooting

Permintaan model gagal: Periksa URL gateway, kedaluwarsa token, nama model, dan izin.

Skill yang diunduh hilang: Periksa bahwa folder lengkapnya ada SKILL.md di direktori yang didukung. Jalankan kembali ug skills add dengan opsi yang sama untuk memperbarui skill yang diunduh.

Untuk masalah saat masuk ke ruang kerja atau penyiapan ug, jalankan ug doctor.

Langkah berikutnya

  • Terakhir diperbarui pada