Conectar Pi
Use o Pi com modelos e habilidades por meio do Unity Gateway. A CLI do Unity Gateway (ug) gerencia o login e a configuração do workspace, ou você pode configurar a conexão manualmente. O Pi não tem um cliente MCP integrado, portanto, as ferramentas MCP exigem uma extensão separada do Pi.
Antes de começar
You need your Databricks workspace URL and access to the models and skills you want to use. For manual setup, install Pi and have a Databricks personal access token.
Para configuração manual, substitua <workspace-hostname> pelo hostname do seu workspace do Databricks e <databricks-pat> pelo seu token. Use nomes de modelo completos disponíveis no seu workspace e faça o merge das entradas de configuração nos arquivos existentes, mantendo as configurações não relacionadas.
If your admin has already configured your device, follow your organization's setup instructions.
Use a CLI do Unity Gateway
Instale o ug e execute a execução deste comando no diretório do seu projeto:
ug pi
Selecione seu workspace e faça login quando solicitado. O comando abre o Pi com seus modelos de gateway configurados. Comece a codificar ou insira /model para escolher outro modelo configurado.
Configurar modelos manualmente
Instale Pi e faça merge desta configuração em ~/.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" }]
}
}
}
Inicie pi e selecione o modelo com /model. Mantenha supportsEagerToolInputStreaming: false para os modelos Claude por meio do gateway.
Para outras famílias de modelos, adicione um provedor com a API e a URL base correspondentes. Use os mesmos campos apiKey e authHeader e liste os IDs de modelo disponíveis para você:
Modelos |
|
|
|---|---|---|
GPT |
|
|
Gemini |
|
|
Consulte a documentação de configuração de modelo do Pi.
Adicionar habilidades
Use a CLI do Unity Gateway
Fazer download de habilidades publicadas:
ug skills add
Escolha suas habilidades e reinicie o Pi. Ele lê os downloads de ~/.agents/skills/. Peça ao Pi para usar uma habilidade ou invocar /skill:<name>, usando o nome em SKILL.md.
Configure skills manually
Para os arquivos que você já tem, coloque cada pasta de skill completa em ~/.agents/skills/ ou no .pi/skills/ do seu projeto. Consulte a documentação de skills do Pi.
Suporte MCP
O Pi não tem nenhum cliente MCP integrado e o ug mcp add não aceita o Pi. Use habilidades download; os serviços MCP e o registro de habilidades exigem uma extensão do Pi separada. Consulte a documentação da extensão do Pi.
As funcionalidades do Unity Gateway estão em Beta. Consulte Reger habilidades para ativação e permissões.
Solução de problemas
Uma solicitação de modelo falha: verifique a URL do gateway, a expiração do token, o nome do modelo e as permissões.
Uma habilidade baixada está ausente: verifique se a pasta completa contém SKILL.md em um diretório compatível. Execute ug skills add novamente com as mesmas opções para refresh nas habilidades download.
Para problemas de login no workspace ou configuração de ug, execute ug doctor.