Connect Pi

Gebruik Pi met modellen en vaardigheden via Unity Gateway. De Unity Gateway CLI (ug) verzorgt het aanmelden bij de werkruimte en de configuratie ervan, of je kunt de verbinding handmatig configureren. Pi heeft geen ingebouwde MCP-client, dus MCP-tools vereisen een aparte Pi-extensie.

Prerequisites

Je hebt je Azure Databricks workspace-URL nodig en toegang tot de modellen en vaardigheden die je wilt gebruiken. Voor handmatige opstelling installeer je Pi en heb je een Azure Databricks persoonlijke toegangstoken.

Voor handmatige configuratie vervang <workspace-hostname> het met de hostnaam van je Azure Databricks workspace en <databricks-pat> met je token. Gebruik volledige modelnamen die beschikbaar zijn in je werkruimte en voeg configuratie-entries samen met bestaande bestanden, waarbij je niet-gerelateerde instellingen behoudt.

Als je beheerder je apparaat al heeft geconfigureerd, volg dan de installatie-instructies van je organisatie.

Gebruik de Unity Gateway CLI

Installeer ugen voer vervolgens dit commando uit vanuit je projectmap:

ug pi

Selecteer je werkruimte en meld je aan wanneer daarom wordt gevraagd. Met dit commando open je Pi met je geconfigureerde gatewaymodellen. Begin met coderen, of ga in /model om een ander geconfigureerd model te kiezen.

Modellen handmatig configureren

Installeer Pi en voeg deze configuratie samen in ~/.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" }]
    }
  }
}

Begin pi en selecteer het model met /model. Gebruik supportsEagerToolInputStreaming: false voor Claude-modellen via de gateway.

Voor andere modelfamilies voeg je een provider toe met de bijbehorende API en basis-URL. Gebruik dezelfde apiKey en-velden authHeader en vermeld de model-ID's die voor je beschikbaar zijn:

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

Zie de documentatie voor modelconfiguratie van Pi.

Vaardigheden toevoegen

Gebruik de Unity Gateway CLI

Download gepubliceerde vaardigheden:

ug skills add

Kies je vaardigheden en start Pi dan opnieuw. Het leest de downloads van ~/.agents/skills/. Vraag Pi om een vaardigheid te gebruiken of /skill:<name> aan te roepen, met de naam in de SKILL.md.

Configureer vaardigheden handmatig

Voor bestanden die je al hebt, plaats je elke volledige skillmap in ~/.agents/skills/ of in de map .pi/skills/ van je project. Zie de documentatie over Pi's vaardigheden.

MCP-ondersteuning

Pi heeft geen ingebouwde MCP-client en ug mcp add ondersteunt Pi niet. Gebruik gedownloade vaardigheden; MCP-diensten en het vaardigheidsregister vereisen een aparte Pi-extensie. Zie de documentatie van Pi's extensie.

Unity Gateway-vaardigheden bevinden zich in de bètafase. Zie Vaardigheden beheren voor inschakelen en machtigingen.

Troubleshooting

Een modelverzoek faalt: Controleer de gateway-URL, tokenvervaldatum, modelnaam en permissies.

Een gedownloade vaardigheid ontbreekt: Controleer of de volledige map SKILL.md bevat en zich in een ondersteunde map bevindt. Speel ug skills add opnieuw met dezelfde opties om gedownloade vaardigheden te verversen.

Voor aanmeldings- of installatieproblemen met de werkruimte, voer ug doctor uit.

Volgende stappen 

  • Laatst bijgewerkt om