Das Ollama-Plug-in bietet Schnittstellen zu allen lokalen LLMs, die von Ollama unterstützt werden.
Installation
npm i --save genkitx-ollama
Konfiguration
Für dieses Plug-in müssen Sie zuerst den Ollama-Server installieren und ausführen. Sie können diesem die Anleitung unter https://ollama.com/download
Sie können das gewünschte Modell mit der Ollama-Befehlszeile herunterladen. Beispiel:
ollama pull gemma
Geben Sie dieses Plug-in an, wenn Sie configureGenkit()
aufrufen, um es zu verwenden.
import { ollama } from 'genkitx-ollama';
export default configureGenkit({
plugins: [
ollama({
models: [
{
name: 'gemma',
type: 'generate', // type: 'chat' | 'generate' | undefined
},
],
serverAddress: 'http://127.0.0.1:11434', // default local address
}),
],
});
Authentifizierung
Wenn Sie auf Remote-Bereitstellungen von ollama zugreifen möchten, für die benutzerdefinierte Header erforderlich sind (statische, z. B. API-Schlüssel, oder dynamische, z. B. Authentifizierungs-Header), können Sie diese im Konfigurations-Plug-in von ollama angeben:
Statische Überschriften:
ollama({
models: [{ name: 'gemma'}],
requestHeaders: {
'api-key': 'API Key goes here'
},
serverAddress: 'https://my-deployment',
}),
Sie können Header auch dynamisch pro Anfrage festlegen. Hier ist ein Beispiel dafür, wie du ein ID-Token mit der Google Auth-Bibliothek festlegst:
import { GoogleAuth } from 'google-auth-library';
import { ollama, OllamaPluginParams } from 'genkitx-ollama';
import { configureGenkit, isDevEnv } from '@genkit-ai/core';
const ollamaCommon = { models: [{ name: 'gemma:2b' }] };
const ollamaDev = {
...ollamaCommon,
serverAddress: 'http://127.0.0.1:11434',
} as OllamaPluginParams;
const ollamaProd = {
...ollamaCommon,
serverAddress: 'https://my-deployment',
requestHeaders: async (params) => {
const headers = await fetchWithAuthHeader(params.serverAddress);
return { Authorization: headers['Authorization'] };
},
} as OllamaPluginParams;
export default configureGenkit({
plugins: [
ollama(isDevEnv() ? ollamaDev : ollamaProd),
],
});
// Function to lazily load GoogleAuth client
let auth: GoogleAuth;
function getAuthClient() {
if (!auth) {
auth = new GoogleAuth();
}
return auth;
}
// Function to fetch headers, reusing tokens when possible
async function fetchWithAuthHeader(url: string) {
const client = await getIdTokenClient(url);
const headers = await client.getRequestHeaders(url); // Auto-manages token refresh
return headers;
}
async function getIdTokenClient(url: string) {
const auth = getAuthClient();
const client = await auth.getIdTokenClient(url);
return client;
}
Nutzung
Mit diesem Plug-in werden Modellreferenzen nicht statisch exportiert. Geben Sie eine der Modelle, die Sie mit einer String-ID konfiguriert haben:
const llmResponse = await generate({
model: 'ollama/gemma',
prompt: 'Tell me a joke.',
});