ปลั๊กอิน Ollama

ปลั๊กอิน Ollama มีอินเทอร์เฟซให้กับ LLM ภายในเครื่องที่ Ollama รองรับ

การติดตั้ง

npm i --save genkitx-ollama

การกำหนดค่า

คุณต้องติดตั้งและเรียกใช้เซิร์ฟเวอร์ ollama ก่อน จึงจะใช้ปลั๊กอินนี้ได้ คุณสามารถทำตามวิธีการที่ https://ollama.com/download

คุณใช้ Ollama CLI เพื่อดาวน์โหลดโมเดลที่สนใจได้ ตัวอย่างเช่น

ollama pull gemma

หากต้องการใช้ปลั๊กอินนี้ ให้ระบุปลั๊กอินเมื่อโทรหา configureGenkit()

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
    }),
  ],
});

การตรวจสอบสิทธิ์

หากต้องการเข้าถึงการทำให้ ollama ใช้งานได้จากระยะไกลซึ่งต้องใช้ส่วนหัวที่กำหนดเอง (แบบคงที่ เช่น คีย์ API หรือแบบไดนามิก เช่น ส่วนหัวการตรวจสอบสิทธิ์) คุณสามารถระบุข้อกำหนดดังกล่าวในปลั๊กอินการกำหนดค่า ollama ได้โดยทำดังนี้

ส่วนหัวแบบคงที่:

ollama({
  models: [{ name: 'gemma'}],
  requestHeaders: {
    'api-key': 'API Key goes here'
  },
  serverAddress: 'https://my-deployment',
}),

นอกจากนี้ คุณยังสามารถตั้งค่าส่วนหัวต่อคำขอแบบไดนามิก ต่อไปนี้คือตัวอย่างวิธีตั้งค่าโทเค็นรหัสโดยใช้ไลบรารีการตรวจสอบสิทธิ์ของ Google

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) => ({
    Authorization: `Bearer ${await getIdToken(params.serverAddress)}`,
  }),
} as OllamaPluginParams;

export default configureGenkit({
  plugins: [
    ollama(isDevEnv() ? ollamaDev: ollamaProd),
  ],
});

export async function getIdToken(url: string): Promise<string> {
  const auth = getAuthClient();
  const client = await auth.getIdTokenClient(url);
  return client.idTokenProvider.fetchIdToken(url);
}

let auth: GoogleAuth;
function getAuthClient() {
  // Lazy load GoogleAuth client.
  if (!auth) {
    auth = new GoogleAuth();
  }
  return auth;
}

การใช้งาน

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

const llmResponse = await generate({
  model: 'ollama/gemma',
  prompt: 'Tell me a joke.',
});