ใช้งาน GearMind บน Node.js

คู่มือการใช้งาน GearMind SDK

ยินดีต้อนรับสู่ GearMind SDK! แพ็คเกจนี้ถูกออกแบบมาเพื่อให้นักพัฒนา Node.js สามารถใช้งาน GearMind API ได้อย่างง่ายดาย ด้วย SDK นี้ คุณสามารถผสานความสามารถของ GearMind เข้ากับแอปพลิเคชันของคุณได้อย่างราบรื่น ไม่ว่าจะเป็นแชทบอท ระบบตอบคำถามอัตโนมัติ หรือระบบสร้างเนื้อหา

การติดตั้ง

npm install gearmind-sdk

การเริ่มต้นใช้งาน

1. ขอรับ API Key: คุณสามารถหา API Key ได้ที่ จัดการคีย์ API

2. สร้างอินสแตนซ์ของ GearMindSDK:

import { GearMindSDK } from 'gearmind-sdk';

const gearmind = new GearMindSDK({ 
  apiKey: 'YOUR_API_KEY' 
});

หมายเหตุ:

• แทนที่ "YOUR_API_KEY" ด้วย API Key จริงของคุณ

• เพื่อความปลอดภัย แนะนำให้เก็บ API Key ไว้ใน environment variable และไม่ควร hardcode ไว้ในโค้ดโดยตรง

การใช้งานพื้นฐาน

การส่งข้อความและรับคำตอบ

ฟังก์ชันหลักของ SDK คือ chat() ซึ่งช่วยให้คุณส่งชุดข้อความไปยัง GearMind และรับคำตอบ

async function chatWithGearMind() {
  const messages = [
    { role: 'user', content: 'สวัสดีครับ' },
    { role: 'assistant', content: 'สวัสดีเช่นกัน! 😊' },
    { role: 'user', content: 'ค้นหาวิธีแก้ไข Error... ให้หน่อย' }
  ];

  try {
    const response = await gearmind.chat(messages);
    console.log(response.content); //  แสดงผลข้อความจาก GearMind
  } catch (error) {
    // ... จัดการข้อผิดพลาด
  }
}

chatWithGearMind();

ในตัวอย่างนี้:

1. เราสร้างอาร์เรย์ messages ซึ่งเก็บประวัติการสนทนาระหว่างผู้ใช้และ GearMind

2. เรียกใช้ gearmind.chat(messages) เพื่อส่งประวัติการสนทนาไปยัง GearMind

3. response.content จะประกอบด้วยข้อความตอบกลับจาก GearMind

โครงสร้างข้อความ

ข้อความแต่ละข้อความในอาร์เรย์ messages จะมีโครงสร้างดังนี้:

interface Message {
  role: 'user' | 'assistant';
  content: string;
}

• role: ระบุบทบาทของผู้ส่งข้อความ ('user' สำหรับผู้ใช้ 'assistant' สำหรับ GearMind)

• content: ข้อความที่ต้องการส่ง

การจัดการข้อผิดพลาด

GearMindSDK อาจ throw ข้อผิดพลาดประเภท GearMindError ได้ ซึ่งมีคุณสมบัติ message และ statusCode เพื่อช่วยในการระบุข้อผิดพลาด

try {
  // ... GearMind API call
} catch (error) {
  if (error instanceof GearMindError) {
    console.error(`GearMind API Error: ${error.message} (Status: ${error.statusCode})`);
  } else {
    console.error('An error occurred:', error);
  }
}

ตัวอย่างการใช้งานเพิ่มเติม

สร้างแชทบอทง่ายๆ

import { GearMindSDK, Message } from 'gearmind-sdk';
import * as readline from 'readline';

const gearmind = new GearMindSDK({ apiKey: 'YOUR_API_KEY' });

const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout
});

const messages: Message[] = [];

function sendMessageToGearMind(message: string) {
  messages.push({ role: 'user', content: message });

  gearmind.chat(messages)
    .then(response => {
      console.log(`GearMind: ${response.content}`);
      messages.push({ role: 'assistant', content: response.content });
      rl.prompt();
    })
    .catch(error => {
      console.error('เกิดข้อผิดพลาด:', error);
      rl.prompt();
    });
}

rl.question('คุณ: ', sendMessageToGearMind);

สร้างระบบสรุปข้อความ

import { GearMindSDK } from 'gearmind-sdk';

const gearmind = new GearMindSDK({ apiKey: 'YOUR_API_KEY' });

async function summarizeText(text: string) {
  const messages = [
    { role: 'user', content: `ช่วยสรุปข้อความนี้ให้หน่อย:\n\n${text}` }
  ];

  try {
    const response = await gearmind.chat(messages);
    return response.content;
  } catch (error) {
    // ... จัดการข้อผิดพลาด
  }
}

const textToSummarize = "GearMind SDK ช่วยให้การใช้งาน GearMind ง่ายขึ้นมาก";
summarizeText(textToSummarize)
  .then(summary => console.log('สรุป:', summary))
  .catch(error => console.error('เกิดข้อผิดพลาด:', error));

API Reference

class GearMindSDK

• Constructor:

  • apiKey: string - API Key ของคุณ

  • baseURL?: string - (optional) URL ของ GearMind API (ค่าเริ่มต้น: https://gearmind.geworn.cloud/api/v1)

• Methods:

  • chat(messages: Message[]): Promise<ChatResponse> - ส่งข้อความไปยัง GearMind และรับคำตอบ

interface Message

• role: 'user' | 'assistant' - ระบุบทบาทของผู้ส่งข้อความ

• content: string - ข้อความ

interface ChatResponse

• role: 'assistant' - บทบาทของผู้ส่งข้อความ (GearMind)

• content: string - ข้อความตอบกลับ

class GearMindError

• Properties:

  • message: string - ข้อความแสดงข้อผิดพลาด

  • statusCode?: number - (optional) HTTP status code (ถ้ามี)