Files
2026-07-13 13:31:35 +08:00

64 KiB
Raw Permalink Blame History

การสร้างไคลเอนต์ด้วย LLM

จนถึงตอนนี้ คุณได้เห็นวิธีการสร้างเซิร์ฟเวอร์และไคลเอนต์มาแล้ว ไคลเอนต์สามารถเรียกเซิร์ฟเวอร์โดยตรงเพื่อแสดงรายการเครื่องมือ, ทรัพยากร และพรอมต์ต่าง ๆ ได้ อย่างไรก็ตาม นี่ไม่ใช่วิธีที่ใช้งานได้จริงมากนัก ผู้ใช้ของคุณอยู่ในยุคของเอเจนต์และคาดหวังที่จะใช้พรอมต์และสื่อสารกับ LLM แทน พวกเขาไม่สนใจว่าคุณจะใช้ MCP ในการจัดเก็บความสามารถของคุณหรือไม่ พวกเขาเพียงแค่คาดหวังจะโต้ตอบโดยใช้ภาษาธรรมชาติ ดังนั้นเราจะแก้ปัญหานี้อย่างไร? วิธีแก้คือการเพิ่ม LLM เข้าไปในไคลเอนต์

ภาพรวม

ในบทเรียนนี้เราจะเน้นการเพิ่ม LLM เข้าไปในไคลเอนต์ และแสดงให้เห็นว่านี่ช่วยให้ประสบการณ์ของผู้ใช้ดีขึ้นอย่างไร

วัตถุประสงค์การเรียนรู้

เมื่อจบบทเรียนนี้ คุณจะสามารถ:

  • สร้างไคลเอนต์ที่มี LLM
  • โต้ตอบกับเซิร์ฟเวอร์ MCP อย่างไร้รอยต่อโดยใช้ LLM
  • มอบประสบการณ์ที่ดียิ่งขึ้นให้กับผู้ใช้ปลายทางบนฝั่งไคลเอนต์

แนวทาง

ลองทำความเข้าใจแนวทางที่เราต้องใช้ การเพิ่ม LLM ฟังดูง่าย แต่เราจะทำจริงหรือไม่?

นี่คือวิธีที่ไคลเอนต์จะโต้ตอบกับเซิร์ฟเวอร์:

  1. สร้างการเชื่อมต่อกับเซิร์ฟเวอร์

  2. แสดงรายการความสามารถ, พรอมต์, ทรัพยากร และเครื่องมือ แล้วบันทึกสคีมาไว้

  3. เพิ่ม LLM และส่งต่อความสามารถที่บันทึกไว้พร้อมกับสคีมาในรูปแบบที่ LLM เข้าใจ

  4. จัดการพรอมต์ของผู้ใช้โดยส่งต่อไปยัง LLM พร้อมกับเครื่องมือที่ไคลเอนต์แสดงรายการไว้

ดีมาก ตอนนี้เราเข้าใจวิธีการทำงานในระดับสูงแล้ว ลองทำแบบฝึกหัดด้านล่างนี้กัน

แบบฝึกหัด: การสร้างไคลเอนต์ด้วย LLM

ในการฝึกนี้ เราจะเรียนรู้การเพิ่ม LLM เข้าไปในไคลเอนต์ของเรา

การตรวจสอบสิทธิ์โดยใช้ GitHub Personal Access Token

การสร้างโทเค็น GitHub เป็นกระบวนการที่ตรงไปตรงมา ทำตามขั้นตอนนี้:

  • ไปที่การตั้งค่า GitHub – คลิกที่รูปโปรไฟล์ของคุณที่มุมขวาบน แล้วเลือก Settings
  • ไปที่ Developer Settings – เลื่อนลงมาแล้วคลิก Developer Settings
  • เลือก Personal Access Tokens คลิกที่ Fine-grained tokens แล้วกด Generate new token
  • กำหนดค่าของโทเค็น – เพิ่มบันทึกเพื่ออ้างอิง, ตั้งค่าหมดอายุ, และเลือกสโคปที่จำเป็น (สิทธิ์การเข้าถึง) ในกรณีนี้ตรวจสอบให้แน่ใจว่าได้เพิ่มสิทธิ์ Models แล้ว
  • สร้างและคัดลอกโทเค็น – คลิก Generate token และอย่าลืมคัดลอกทันทีเพราะจะไม่สามารถดูได้อีกครั้ง

-1- เชื่อมต่อกับเซิร์ฟเวอร์

เริ่มจากสร้างไคลเอนต์ของเราก่อน:

TypeScript

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
import OpenAI from "openai";
import { z } from "zod"; // นำเข้า zod สำหรับการตรวจสอบรูปแบบข้อมูล

class MCPClient {
    private openai: OpenAI;
    private client: Client;
    constructor(){
        this.openai = new OpenAI({
            baseURL: "https://models.inference.ai.azure.com", 
            apiKey: process.env.GITHUB_TOKEN,
        });

        this.client = new Client(
            {
                name: "example-client",
                version: "1.0.0"
            },
            {
                capabilities: {
                prompts: {},
                resources: {},
                tools: {}
                }
            }
            );    
    }
}

ในโค้ดก่อนหน้านี้เราได้:

  • นำเข้าห้องสมุดที่จำเป็น
  • สร้างคลาสที่มีสมาชิกสองตัว คือ client และ openai ที่ช่วยจัดการไคลเอนต์และโต้ตอบกับ LLM ตามลำดับ
  • กำหนดค่าอินสแตนซ์ LLM ของเราให้ใช้ GitHub Models โดยตั้งค่า baseUrl ให้ชี้ไปยัง API การคาดการณ์

Python

from mcp import ClientSession, StdioServerParameters, types
from mcp.client.stdio import stdio_client

# สร้างพารามิเตอร์เซิร์ฟเวอร์สำหรับการเชื่อมต่อ stdio
server_params = StdioServerParameters(
    command="mcp",  # ไฟล์ที่สามารถรันได้
    args=["run", "server.py"],  # อาร์กิวเมนต์บรรทัดคำสั่งแบบเลือกได้
    env=None,  # ตัวแปรสภาพแวดล้อมแบบเลือกได้
)


async def run():
    async with stdio_client(server_params) as (read, write):
        async with ClientSession(
            read, write
        ) as session:
            # เริ่มต้นการเชื่อมต่อ
            await session.initialize()


if __name__ == "__main__":
    import asyncio

    asyncio.run(run())

ในโค้ดก่อนหน้านี้เราได้:

  • นำเข้าห้องสมุดที่จำเป็นสำหรับ MCP
  • สร้างไคลเอนต์

.NET

using Azure;
using Azure.AI.Inference;
using Azure.Identity;
using System.Text.Json;
using ModelContextProtocol.Client;
using System.Text.Json;

var clientTransport = new StdioClientTransport(new()
{
    Name = "Demo Server",
    Command = "/workspaces/mcp-for-beginners/03-GettingStarted/02-client/solution/server/bin/Debug/net8.0/server",
    Arguments = [],
});

await using var mcpClient = await McpClient.CreateAsync(clientTransport);

Java

ก่อนอื่นคุณต้องเพิ่ม dependencies ของ LangChain4j ในไฟล์ pom.xml ของคุณ เพิ่ม dependencies เหล่านี้เพื่อเปิดใช้งานการรวม MCP และการสนับสนุน GitHub Models:

<properties>
    <langchain4j.version>1.0.0-beta3</langchain4j.version>
</properties>

<dependencies>
    <!-- LangChain4j MCP Integration -->
    <dependency>
        <groupId>dev.langchain4j</groupId>
        <artifactId>langchain4j-mcp</artifactId>
        <version>${langchain4j.version}</version>
    </dependency>
    
    <!-- OpenAI Official API Client -->
    <dependency>
        <groupId>dev.langchain4j</groupId>
        <artifactId>langchain4j-open-ai-official</artifactId>
        <version>${langchain4j.version}</version>
    </dependency>
    
    <!-- GitHub Models Support -->
    <dependency>
        <groupId>dev.langchain4j</groupId>
        <artifactId>langchain4j-github-models</artifactId>
        <version>${langchain4j.version}</version>
    </dependency>
    
    <!-- Spring Boot Starter (optional, for production apps) -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
</dependencies>

จากนั้นสร้างคลาสไคลเอนต์ Java:

import dev.langchain4j.mcp.McpToolProvider;
import dev.langchain4j.mcp.client.DefaultMcpClient;
import dev.langchain4j.mcp.client.McpClient;
import dev.langchain4j.mcp.client.transport.McpTransport;
import dev.langchain4j.mcp.client.transport.http.HttpMcpTransport;
import dev.langchain4j.model.chat.ChatLanguageModel;
import dev.langchain4j.model.openaiofficial.OpenAiOfficialChatModel;
import dev.langchain4j.service.AiServices;
import dev.langchain4j.service.tool.ToolProvider;

import java.time.Duration;
import java.util.List;

public class LangChain4jClient {
    
    public static void main(String[] args) throws Exception {        // กำหนดค่า LLM ให้ใช้โมเดลของ GitHub
        ChatLanguageModel model = OpenAiOfficialChatModel.builder()
                .isGitHubModels(true)
                .apiKey(System.getenv("GITHUB_TOKEN"))
                .timeout(Duration.ofSeconds(60))
                .modelName("gpt-4.1-nano")
                .build();

        // สร้าง MCP transport สำหรับเชื่อมต่อกับเซิร์ฟเวอร์
        McpTransport transport = new HttpMcpTransport.Builder()
                .sseUrl("http://localhost:8080/sse")
                .timeout(Duration.ofSeconds(60))
                .logRequests(true)
                .logResponses(true)
                .build();

        // สร้าง MCP client
        McpClient mcpClient = new DefaultMcpClient.Builder()
                .transport(transport)
                .build();
    }
}

ในโค้ดก่อนหน้านี้เราได้:

  • เพิ่ม dependencies ของ LangChain4j: จำเป็นสำหรับการรวม MCP, ลูกค้า OpenAI อย่างเป็นทางการ และการสนับสนุน GitHub Models
  • นำเข้าห้องสมุด LangChain4j: สำหรับการรวม MCP และฟังก์ชันโมเดลแชทของ OpenAI
  • สร้าง ChatLanguageModel: กำหนดค่าให้ใช้ GitHub Models พร้อมโทเค็น GitHub ของคุณ
  • ตั้งค่า HTTP transport: ใช้ Server-Sent Events (SSE) เพื่อเชื่อมต่อกับเซิร์ฟเวอร์ MCP
  • สร้างไคลเอนต์ MCP: ที่จะจัดการการสื่อสารกับเซิร์ฟเวอร์
  • ใช้การสนับสนุน MCP ในตัวของ LangChain4j: ที่ช่วยให้ง่ายต่อการรวมระหว่าง LLM และเซิร์ฟเวอร์ MCP

Rust

ตัวอย่างนี้สมมติว่าคุณมีเซิร์ฟเวอร์ MCP ที่ใช้ Rust รันอยู่ หากยังไม่มี ให้กลับไปที่บทเรียน 01-first-server เพื่อสร้างเซิร์ฟเวอร์

เมื่อมีเซิร์ฟเวอร์ MCP Rust แล้ว ให้เปิดเทอร์มินัลและไปยังโฟลเดอร์เดียวกับเซิร์ฟเวอร์ จากนั้นรันคำสั่งนี้เพื่อสร้างโปรเจกต์ไคลเอนต์ LLM ใหม่:

mkdir calculator-llmclient
cd calculator-llmclient
cargo init

เพิ่ม dependencies ดังต่อไปนี้ในไฟล์ Cargo.toml ของคุณ:

[dependencies]
async-openai = { version = "0.29.0", features = ["byot"] }
rmcp = { version = "0.5.0", features = ["client", "transport-child-process"] }
serde_json = "1.0.141"
tokio = { version = "1.46.1", features = ["rt-multi-thread"] }

Note

ไม่มีไลบรารีอย่างเป็นทางการของ Rust สำหรับ OpenAI แต่ async-openai crate เป็น ไลบรารีที่ดูแลโดยชุมชน ที่นิยมใช้กัน

เปิดไฟล์ src/main.rs แล้วแทนที่เนื้อหาด้วยโค้ดดังนี้:

use async_openai::{Client, config::OpenAIConfig};
use rmcp::{
    RmcpError,
    model::{CallToolRequestParam, ListToolsResult},
    service::{RoleClient, RunningService, ServiceExt},
    transport::{ConfigureCommandExt, TokioChildProcess},
};
use serde_json::{Value, json};
use std::error::Error;
use tokio::process::Command;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    // ข้อความเริ่มต้น
    let mut messages = vec![json!({"role": "user", "content": "What is the sum of 3 and 2?"})];

    // ตั้งค่าไคลเอนต์ OpenAI
    let api_key = std::env::var("OPENAI_API_KEY")?;
    let openai_client = Client::with_config(
        OpenAIConfig::new()
            .with_api_base("https://models.github.ai/inference/chat")
            .with_api_key(api_key),
    );

    // ตั้งค่าไคลเอนต์ MCP
    let server_dir = std::path::Path::new(env!("CARGO_MANIFEST_DIR"))
        .parent()
        .unwrap()
        .join("calculator-server");

    let mcp_client = ()
        .serve(
            TokioChildProcess::new(Command::new("cargo").configure(|cmd| {
                cmd.arg("run").current_dir(server_dir);
            }))
            .map_err(RmcpError::transport_creation::<TokioChildProcess>)?,
        )
        .await?;

    // ที่ต้องทำ: รับรายการเครื่องมือ MCP

    // ที่ต้องทำ: การสนทนา LLM พร้อมการเรียกใช้เครื่องมือ

    Ok(())
}

โค้ดนี้ตั้งค่าแอปพลิเคชัน Rust พื้นฐานที่เชื่อมต่อกับเซิร์ฟเวอร์ MCP และ GitHub Models เพื่อโต้ตอบกับ LLM

Important

ให้ตั้งค่าตัวแปรสภาพแวดล้อม OPENAI_API_KEY เป็นโทเค็น GitHub ของคุณก่อนรันแอปพลิเคชัน

เยี่ยม ตอนนี้เรามาดูขั้นตอนถัดไป คือการแสดงรายการความสามารถของเซิร์ฟเวอร์

-2- แสดงรายการความสามารถของเซิร์ฟเวอร์

ตอนนี้เราจะเชื่อมต่อกับเซิร์ฟเวอร์และขอสอบถามความสามารถของมัน:

Typescript

ในคลาสเดียวกัน ให้เพิ่มเมธอดดังต่อไปนี้:

async connectToServer(transport: Transport) {
     await this.client.connect(transport);
     this.run();
     console.error("MCPClient started on stdin/stdout");
}

async run() {
    console.log("Asking server for available tools");

    // รายการเครื่องมือ
    const toolsResult = await this.client.listTools();
}

ในโค้ดก่อนหน้านี้เราได้:

  • เพิ่มโค้ดสำหรับเชื่อมต่อกับเซิร์ฟเวอร์ ด้วยเมธอด connectToServer
  • สร้างเมธอด run ที่รับผิดชอบจัดการลำดับการทำงานของแอป ตอนนี้ทำแค่แสดงรายการเครื่องมือ แต่เราจะเพิ่มความสามารถอื่น ๆ ในเร็วๆ นี้

Python

# แสดงรายการทรัพยากรที่มี
resources = await session.list_resources()
print("LISTING RESOURCES")
for resource in resources:
    print("Resource: ", resource)

# แสดงรายการเครื่องมือที่มี
tools = await session.list_tools()
print("LISTING TOOLS")
for tool in tools.tools:
    print("Tool: ", tool.name)
    print("Tool", tool.inputSchema["properties"])

ต่อไปนี้คือสิ่งที่เราเพิ่ม:

  • แสดงรายการทรัพยากรและเครื่องมือ พร้อมพิมพ์ออกมา สำหรับเครื่องมือเรายังแสดง inputSchema ซึ่งจะใช้ในภายหลัง

.NET

async Task<List<ChatCompletionsToolDefinition>> GetMcpTools()
{
    Console.WriteLine("Listing tools");
    var tools = await mcpClient.ListToolsAsync();

    List<ChatCompletionsToolDefinition> toolDefinitions = new List<ChatCompletionsToolDefinition>();

    foreach (var tool in tools)
    {
        Console.WriteLine($"Connected to server with tools: {tool.Name}");
        Console.WriteLine($"Tool description: {tool.Description}");
        Console.WriteLine($"Tool parameters: {tool.JsonSchema}");

        // TODO: convert tool definition from MCP tool to LLm tool     
    }

    return toolDefinitions;
}

ในโค้ดก่อนหน้านี้เราได้:

  • แสดงรายการเครื่องมือที่มีในเซิร์ฟเวอร์ MCP
  • สำหรับแต่ละเครื่องมือ แสดงชื่อ, คำอธิบาย และสคีมา ซึ่งเราจะใช้เรียกเครื่องมือต่อไป

Java

// สร้างผู้ให้บริการเครื่องมือที่ค้นหาเครื่องมือ MCP โดยอัตโนมัติ
ToolProvider toolProvider = McpToolProvider.builder()
        .mcpClients(List.of(mcpClient))
        .build();

// ผู้ให้บริการเครื่องมือ MCP จะจัดการโดยอัตโนมัติ:
// - แสดงรายการเครื่องมือที่มีจากเซิร์ฟเวอร์ MCP
// - แปลงสคีมาของเครื่องมือ MCP เป็นรูปแบบ LangChain4j
// - จัดการการทำงานของเครื่องมือและการตอบสนอง

ในโค้ดก่อนหน้านี้เราได้:

  • สร้าง McpToolProvider ที่ค้นหาและลงทะเบียนเครื่องมือทั้งหมดจากเซิร์ฟเวอร์ MCP โดยอัตโนมัติ
  • ผู้ให้บริการเครื่องมือนี้จัดการการแปลงระหว่างสคีมาเครื่องมือ MCP และรูปแบบเครื่องมือของ LangChain4j ภายใน
  • วิธีนี้ช่วยลดความยุ่งยากในการแสดงรายการและแปลงเครื่องมือด้วยตนเอง

Rust

การดึงเครื่องมือจากเซิร์ฟเวอร์ MCP ทำได้โดยใช้เมธอด list_tools ในฟังก์ชัน main หลังจากตั้งค่า MCP client แล้ว ให้เพิ่มโค้ดดังนี้:

// รับรายการเครื่องมือ MCP
let tools = mcp_client.list_tools(Default::default()).await?;

-3- แปลงความสามารถของเซิร์ฟเวอร์เป็นเครื่องมือสำหรับ LLM

ขั้นตอนถัดไปหลังจากแสดงรายชื่อความสามารถของเซิร์ฟเวอร์ คือการแปลงให้เป็นรูปแบบที่ LLM เข้าใจได้ เมื่อแปลงเสร็จเราจะให้ความสามารถเหล่านี้เป็นเครื่องมือกับ LLM

TypeScript

  1. เพิ่มโค้ดนี้เพื่อแปลงผลตอบกลับจาก MCP Server เป็นรูปแบบเครื่องมือที่ LLM ใช้ได้:

    openAiToolAdapter(tool: {
        name: string;
        description?: string;
        input_schema: any;
        }) {
        // สร้างสคีมา zod ตาม input_schema
        const schema = z.object(tool.input_schema);
    
        return {
            type: "function" as const, // ตั้งค่าประเภทเป็น "function" อย่างชัดเจน
            function: {
            name: tool.name,
            description: tool.description,
            parameters: {
            type: "object",
            properties: tool.input_schema.properties,
            required: tool.input_schema.required,
            },
            },
        };
    }
    
    

    โค้ดด้านบนจะรับข้อมูลตอบกลับจาก MCP Server และแปลงเป็นการกำหนดเครื่องมือในรูปแบบที่ LLM เข้าใจ

  2. อัปเดตเมธอด run เพื่อแสดงความสามารถของเซิร์ฟเวอร์:

    async run() {
        console.log("Asking server for available tools");
        const toolsResult = await this.client.listTools();
        const tools = toolsResult.tools.map((tool) => {
            return this.openAiToolAdapter({
            name: tool.name,
            description: tool.description,
            input_schema: tool.inputSchema,
            });
        });
    }
    

    ในโค้ดนี้เราอัปเดตเมธอด run ให้วนลูปผลลัพธ์และสำหรับแต่ละรายการเรียก openAiToolAdapter

Python

  1. เริ่มจากสร้างฟังก์ชันแปลงดังนี้

    def convert_to_llm_tool(tool):
        tool_schema = {
            "type": "function",
            "function": {
                "name": tool.name,
                "description": tool.description,
                "type": "function",
                "parameters": {
                    "type": "object",
                    "properties": tool.inputSchema["properties"]
                }
            }
        }
    
        return tool_schema
    

    ในฟังก์ชัน convert_to_llm_tools เรารับข้อมูลเครื่องมือ MCP และแปลงเป็นรูปแบบที่ LLM เข้าใจ

  2. ต่อมาอัปเดตโค้ดไคลเอนต์ให้ใช้ฟังก์ชันนี้:

    functions = []
    for tool in tools.tools:
        print("Tool: ", tool.name)
        print("Tool", tool.inputSchema["properties"])
        functions.append(convert_to_llm_tool(tool))
    

    ที่นี่เราเพิ่มการเรียก convert_to_llm_tool เพื่อแปลงข้อมูลเครื่องมือ MCP เป็นข้อมูลที่ให้กับ LLM ได้ในภายหลัง

.NET

  1. เพิ่มโค้ดเพื่อแปลงข้อมูลเครื่องมือ MCP เป็นรูปแบบที่ LLM เข้าใจ
ChatCompletionsToolDefinition ConvertFrom(string name, string description, JsonElement jsonElement)
{ 
    // convert the tool to a function definition
    FunctionDefinition functionDefinition = new FunctionDefinition(name)
    {
        Description = description,
        Parameters = BinaryData.FromObjectAsJson(new
        {
            Type = "object",
            Properties = jsonElement
        },
        new JsonSerializerOptions() { PropertyNamingPolicy = JsonNamingPolicy.CamelCase })
    };

    // create a tool definition
    ChatCompletionsToolDefinition toolDefinition = new ChatCompletionsToolDefinition(functionDefinition);
    return toolDefinition;
}

ในโค้ดนี้เราได้:

  • สร้างฟังก์ชัน ConvertFrom ที่ใช้ชื่อ, คำอธิบาย และสคีมาป้อนเข้า
  • กำหนดฟังก์ชันที่สร้าง FunctionDefinition ซึ่งถูกส่งต่อไปยัง ChatCompletionsDefinition ซึ่งเป็นรูปแบบที่ LLM เข้าใจ
  1. อัปเดตโค้ดที่มีอยู่เพื่อใช้ฟังก์ชันนี้:

    async Task<List<ChatCompletionsToolDefinition>> GetMcpTools()
    {
        Console.WriteLine("Listing tools");
        var tools = await mcpClient.ListToolsAsync();
    
        List<ChatCompletionsToolDefinition> toolDefinitions = new List<ChatCompletionsToolDefinition>();
    
        foreach (var tool in tools)
        {
            Console.WriteLine($"Connected to server with tools: {tool.Name}");
            Console.WriteLine($"Tool description: {tool.Description}");
            Console.WriteLine($"Tool parameters: {tool.JsonSchema}");
    
            JsonElement propertiesElement;
            tool.JsonSchema.TryGetProperty("properties", out propertiesElement);
    
            var def = ConvertFrom(tool.Name, tool.Description, propertiesElement);
            Console.WriteLine($"Tool definition: {def}");
            toolDefinitions.Add(def);
    
            Console.WriteLine($"Properties: {propertiesElement}");        
        }
    
        return toolDefinitions;
    }
    ```    In the preceding code, we've:
    
    - Update the function to convert the MCP tool response to an LLm tool. Let's highlight the code we added:
    
        ```csharp
        JsonElement propertiesElement;
        tool.JsonSchema.TryGetProperty("properties", out propertiesElement);
    
        var def = ConvertFrom(tool.Name, tool.Description, propertiesElement);
        Console.WriteLine($"Tool definition: {def}");
        toolDefinitions.Add(def);
        ```
    
        The input schema is part of the tool response but on the "properties" attribute, so we need to extract. Furthermore, we now call `ConvertFrom` with the tool details. Now we've done the heavy lifting, let's see how it call comes together as we handle a user prompt next.
    
    
    

Java

// สร้างอินเทอร์เฟซบอทสำหรับการโต้ตอบด้วยภาษาธรรมชาติ
public interface Bot {
    String chat(String prompt);
}

// กำหนดค่าบริการ AI ด้วยเครื่องมือ LLM และ MCP
Bot bot = AiServices.builder(Bot.class)
        .chatLanguageModel(model)
        .toolProvider(toolProvider)
        .build();

ในโค้ดนี้เราได้:

  • กำหนดอินเทอร์เฟซง่าย ๆ ชื่อ Bot สำหรับการโต้ตอบด้วยภาษาธรรมชาติ
  • ใช้ AiServices ของ LangChain4j เพื่อเชื่อมต่อ LLM กับ MCP tool provider โดยอัตโนมัติ
  • เฟรมเวิร์กจัดการการแปลงสคีมาเครื่องมือและฟังก์ชันเรียกใช้เบื้องหลัง
  • วิธีนี้ช่วยลดขั้นตอนการแปลงเครื่องมือด้วยมือ—LangChain4j ดูแลความซับซ้อนทั้งหมดของการแปลงเครื่องมือ MCP ให้เป็นรูปแบบที่ LLM เข้าใจได้

Rust

เพื่อแปลงข้อมูลเครื่องมือ MCP เป็นรูปแบบที่ LLM เข้าใจ เราจะเพิ่มฟังก์ชันช่วยที่ฟอร์แมตรายการเครื่องมือ เพิ่มโค้ดนี้ในไฟล์ main.rs ด้านล่างฟังก์ชัน main ฟังก์ชันนี้จะถูกเรียกเมื่อส่งคำขอไปยัง LLM:

async fn format_tools(tools: &ListToolsResult) -> Result<Vec<Value>, Box<dyn Error>> {
    let tools_json = serde_json::to_value(tools)?;
    let Some(tools_array) = tools_json.get("tools").and_then(|t| t.as_array()) else {
        return Ok(vec![]);
    };

    let formatted_tools = tools_array
        .iter()
        .filter_map(|tool| {
            let name = tool.get("name")?.as_str()?;
            let description = tool.get("description")?.as_str()?;
            let schema = tool.get("inputSchema")?;

            Some(json!({
                "type": "function",
                "function": {
                    "name": name,
                    "description": description,
                    "parameters": {
                        "type": "object",
                        "properties": schema.get("properties").unwrap_or(&json!({})),
                        "required": schema.get("required").unwrap_or(&json!([]))
                    }
                }
            }))
        })
        .collect();

    Ok(formatted_tools)
}

เยี่ยม ตอนนี้เราเตรียมพร้อมรับคำขอจากผู้ใช้แล้ว มาดูขั้นตอนต่อไปกัน

-4- จัดการคำขอพรอมต์ผู้ใช้

ในส่วนนี้ของโค้ด เราจะจัดการคำขอของผู้ใช้

TypeScript

  1. เพิ่มเมธอดที่จะใช้เรียก LLM:

    async callTools(
        tool_calls: OpenAI.Chat.Completions.ChatCompletionMessageToolCall[],
        toolResults: any[]
    ) {
        for (const tool_call of tool_calls) {
        const toolName = tool_call.function.name;
        const args = tool_call.function.arguments;
    
        console.log(`Calling tool ${toolName} with args ${JSON.stringify(args)}`);
    
    
        // 2. เรียกใช้เครื่องมือของเซิร์ฟเวอร์
        const toolResult = await this.client.callTool({
            name: toolName,
            arguments: JSON.parse(args),
        });
    
        console.log("Tool result: ", toolResult);
    
        // 3. ทำบางอย่างกับผลลัพธ์
        // ต้องทำ
    
        }
    }
    

    ในโค้ดก่อนหน้านี้เรา:

    • เพิ่มเมธอด callTools

    • เมธอดนี้รับการตอบกลับจาก LLM และตรวจสอบว่าเครื่องมือใดถูกเรียกใช้ ถ้ามี:

      for (const tool_call of tool_calls) {
      const toolName = tool_call.function.name;
      const args = tool_call.function.arguments;
      
      console.log(`Calling tool ${toolName} with args ${JSON.stringify(args)}`);
      
      // เรียกใช้เครื่องมือ
      }
      
    • เรียกเครื่องมือ ถ้า LLM ระบุว่าควรเรียกใช้:

      // 2. เรียกใช้เครื่องมือของเซิร์ฟเวอร์
      const toolResult = await this.client.callTool({
          name: toolName,
          arguments: JSON.parse(args),
      });
      
      console.log("Tool result: ", toolResult);
      
      // 3. ทำบางอย่างกับผลลัพธ์
      // ต้องทำ
      
  2. อัปเดตเมธอด run เพื่อรวมการเรียก LLM และเรียก callTools:

    
    // 1. สร้างข้อความที่เป็นข้อมูลเข้าให้กับ LLM
    const prompt = "What is the sum of 2 and 3?"
    
    const messages: OpenAI.Chat.Completions.ChatCompletionMessageParam[] = [
            {
                role: "user",
                content: prompt,
            },
        ];
    
    console.log("Querying LLM: ", messages[0].content);
    
    // 2. เรียกใช้ LLM
    let response = this.openai.chat.completions.create({
        model: "gpt-4.1-mini",
        max_tokens: 1000,
        messages,
        tools: tools,
    });    
    
    let results: any[] = [];
    
    // 3. ตรวจสอบคำตอบจาก LLM สำหรับแต่ละตัวเลือก ดูว่ามีการเรียกใช้เครื่องมือหรือไม่
    (await response).choices.map(async (choice: { message: any; }) => {
        const message = choice.message;
        if (message.tool_calls) {
            console.log("Making tool call")
            await this.callTools(message.tool_calls, results);
        }
    });
    

เยี่ยม ลองดูโค้ดเต็มกัน:

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
import { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
import OpenAI from "openai";
import { z } from "zod"; // นำเข้า zod สำหรับการตรวจสอบสคีมา

class MyClient {
    private openai: OpenAI;
    private client: Client;
    constructor(){
        this.openai = new OpenAI({
            baseURL: "https://models.inference.ai.azure.com", // อาจจำเป็นต้องเปลี่ยนเป็น URL นี้ในอนาคต: https://models.github.ai/inference
            apiKey: process.env.GITHUB_TOKEN,
        });

        this.client = new Client(
            {
                name: "example-client",
                version: "1.0.0"
            },
            {
                capabilities: {
                prompts: {},
                resources: {},
                tools: {}
                }
            }
            );    
    }

    async connectToServer(transport: Transport) {
        await this.client.connect(transport);
        this.run();
        console.error("MCPClient started on stdin/stdout");
    }

    openAiToolAdapter(tool: {
        name: string;
        description?: string;
        input_schema: any;
          }) {
          // สร้างสคีมา zod ตาม input_schema
          const schema = z.object(tool.input_schema);
      
          return {
            type: "function" as const, // กำหนดชนิดเป็น "function" อย่างชัดเจน
            function: {
              name: tool.name,
              description: tool.description,
              parameters: {
              type: "object",
              properties: tool.input_schema.properties,
              required: tool.input_schema.required,
              },
            },
          };
    }
    
    async callTools(
        tool_calls: OpenAI.Chat.Completions.ChatCompletionMessageToolCall[],
        toolResults: any[]
      ) {
        for (const tool_call of tool_calls) {
          const toolName = tool_call.function.name;
          const args = tool_call.function.arguments;
    
          console.log(`Calling tool ${toolName} with args ${JSON.stringify(args)}`);
    
    
          // 2. เรียกใช้เครื่องมือของเซิร์ฟเวอร์
          const toolResult = await this.client.callTool({
            name: toolName,
            arguments: JSON.parse(args),
          });
    
          console.log("Tool result: ", toolResult);
    
          // 3. ทำบางอย่างกับผลลัพธ์
          // ยังทำไม่เสร็จ
    
         }
    }

    async run() {
        console.log("Asking server for available tools");
        const toolsResult = await this.client.listTools();
        const tools = toolsResult.tools.map((tool) => {
            return this.openAiToolAdapter({
              name: tool.name,
              description: tool.description,
              input_schema: tool.inputSchema,
            });
        });

        const prompt = "What is the sum of 2 and 3?";
    
        const messages: OpenAI.Chat.Completions.ChatCompletionMessageParam[] = [
            {
                role: "user",
                content: prompt,
            },
        ];

        console.log("Querying LLM: ", messages[0].content);
        let response = this.openai.chat.completions.create({
            model: "gpt-4.1-mini",
            max_tokens: 1000,
            messages,
            tools: tools,
        });    

        let results: any[] = [];
    
        // 3. ตรวจสอบคำตอบจาก LLM สำหรับแต่ละตัวเลือก ว่ามีการเรียกใช้เครื่องมือหรือไม่
        (await response).choices.map(async (choice: { message: any; }) => {
          const message = choice.message;
          if (message.tool_calls) {
              console.log("Making tool call")
              await this.callTools(message.tool_calls, results);
          }
        });
    }
    
}

let client = new MyClient();
 const transport = new StdioClientTransport({
            command: "node",
            args: ["./build/index.js"]
        });

client.connectToServer(transport);

Python

  1. เพิ่มการนำเข้าโมดูลที่จำเป็นในการเรียก LLM

    # แอลแอลเอ็ม
    import os
    from azure.ai.inference import ChatCompletionsClient
    from azure.ai.inference.models import SystemMessage, UserMessage
    from azure.core.credentials import AzureKeyCredential
    import json
    
  2. เพิ่มฟังก์ชันสำหรับเรียก LLM:

    # llm
    
    def call_llm(prompt, functions):
        token = os.environ["GITHUB_TOKEN"]
        endpoint = "https://models.inference.ai.azure.com"
    
        model_name = "gpt-4o"
    
        client = ChatCompletionsClient(
            endpoint=endpoint,
            credential=AzureKeyCredential(token),
        )
    
        print("CALLING LLM")
        response = client.complete(
            messages=[
                {
                "role": "system",
                "content": "You are a helpful assistant.",
                },
                {
                "role": "user",
                "content": prompt,
                },
            ],
            model=model_name,
            tools = functions,
            # พารามิเตอร์ที่เลือกได้
            temperature=1.,
            max_tokens=1000,
            top_p=1.    
        )
    
        response_message = response.choices[0].message
    
        functions_to_call = []
    
        if response_message.tool_calls:
            for tool_call in response_message.tool_calls:
                print("TOOL: ", tool_call)
                name = tool_call.function.name
                args = json.loads(tool_call.function.arguments)
                functions_to_call.append({ "name": name, "args": args })
    
        return functions_to_call
    

    ในโค้ดนี้เราได้:

    • ส่งฟังก์ชันที่ได้จากการค้นหาเครื่องมือ MCP และแปลงแล้ว ไปยัง LLM
    • เรียก LLM พร้อมฟังก์ชันเหล่านั้น
    • ตรวจสอบผลลัพธ์ว่า LLM ต้องการเรียกฟังก์ชันใดหรือไม่
    • สุดท้ายส่งอาร์เรย์ของฟังก์ชันที่จะเรียก
  3. ขั้นตอนสุดท้าย อัปเดตโค้ดหลัก:

    prompt = "Add 2 to 20"
    
    # ถาม LLM ว่ามีเครื่องมืออะไรบ้าง ถ้ามี
    functions_to_call = call_llm(prompt, functions)
    
    # เรียกใช้ฟังก์ชันที่แนะนำ
    for f in functions_to_call:
        result = await session.call_tool(f["name"], arguments=f["args"])
        print("TOOLS result: ", result.content)
    

    นั่นคือขั้นตอนสุดท้าย ในโค้ดนี้เรา:

    • เรียกใช้เครื่องมือ MCP ผ่าน call_tool ตามฟังก์ชันที่ LLM แนะนำให้เรียกตามพรอมต์ของเรา
    • พิมพ์ผลลัพธ์ของการเรียกเครื่องมือไปยังเซิร์ฟเวอร์ MCP

.NET

  1. นี่คือโค้ดตัวอย่างสำหรับการส่งคำขอพรอมต์ไปยัง LLM:

    var tools = await GetMcpTools();
    
    for (int i = 0; i < tools.Count; i++)
    {
        var tool = tools[i];
        Console.WriteLine($"MCP Tools def: {i}: {tool}");
    }
    
    // 0. Define the chat history and the user message
    var userMessage = "add 2 and 4";
    
    chatHistory.Add(new ChatRequestUserMessage(userMessage));
    
    // 1. Define tools
    ChatCompletionsToolDefinition def = CreateToolDefinition();
    
    
    // 2. Define options, including the tools
    var options = new ChatCompletionsOptions(chatHistory)
    {
        Model = "gpt-4.1-mini",
        Tools = { tools[0] }
    };
    
    // 3. Call the model  
    
    ChatCompletions? response = await client.CompleteAsync(options);
    var content = response.Content;
    
    

    ในโค้ดนี้เราได้:

    • ดึงเครื่องมือจากเซิร์ฟเวอร์ MCP โดย var tools = await GetMcpTools()
    • กำหนดพรอมต์ผู้ใช้ userMessage
    • สร้างออบเจกต์ options ที่ระบุโมเดลและเครื่องมือ
    • ส่งคำขอไปยัง LLM
  2. ขั้นตอนสุดท้าย มาดูว่า LLM ต้องการเรียกฟังก์ชันหรือไม่:

    // 4. Check if the response contains a function call
    ChatCompletionsToolCall? calls = response.ToolCalls.FirstOrDefault();
    for (int i = 0; i < response.ToolCalls.Count; i++)
    {
        var call = response.ToolCalls[i];
        Console.WriteLine($"Tool call {i}: {call.Name} with arguments {call.Arguments}");
        //Tool call 0: add with arguments {"a":2,"b":4}
    
        var dict = JsonSerializer.Deserialize<Dictionary<string, object>>(call.Arguments);
        var result = await mcpClient.CallToolAsync(
            call.Name,
            dict!,
            cancellationToken: CancellationToken.None
        );
    
        Console.WriteLine(result.Content.First(c => c.Type == "text").Text);
    
    }
    

    ในโค้ดนี้เราได้:

    • วนลูปผ่านรายการของฟังก์ชันที่ LLM เรียกใช้
    • สำหรับแต่ละการเรียกเครื่องมือ แยกชื่อและอาร์กิวเมนต์ แล้วเรียกเครื่องมือบนเซิร์ฟเวอร์ MCP ผ่านไคลเอนต์ MCP พร้อมพิมพ์ผลลัพธ์

โค้ดทั้งหมด:

using Azure;
using Azure.AI.Inference;
using Azure.Identity;
using System.Text.Json;
using ModelContextProtocol.Client;
using ModelContextProtocol.Protocol;

var endpoint = "https://models.inference.ai.azure.com";
var token = Environment.GetEnvironmentVariable("GITHUB_TOKEN"); // Your GitHub Access Token
var client = new ChatCompletionsClient(new Uri(endpoint), new AzureKeyCredential(token));
var chatHistory = new List<ChatRequestMessage>
{
    new ChatRequestSystemMessage("You are a helpful assistant that knows about AI")
};

var clientTransport = new StdioClientTransport(new()
{
    Name = "Demo Server",
    Command = "/workspaces/mcp-for-beginners/03-GettingStarted/02-client/solution/server/bin/Debug/net8.0/server",
    Arguments = [],
});

Console.WriteLine("Setting up stdio transport");

await using var mcpClient = await McpClient.CreateAsync(clientTransport);

ChatCompletionsToolDefinition ConvertFrom(string name, string description, JsonElement jsonElement)
{ 
    // convert the tool to a function definition
    FunctionDefinition functionDefinition = new FunctionDefinition(name)
    {
        Description = description,
        Parameters = BinaryData.FromObjectAsJson(new
        {
            Type = "object",
            Properties = jsonElement
        },
        new JsonSerializerOptions() { PropertyNamingPolicy = JsonNamingPolicy.CamelCase })
    };

    // create a tool definition
    ChatCompletionsToolDefinition toolDefinition = new ChatCompletionsToolDefinition(functionDefinition);
    return toolDefinition;
}



async Task<List<ChatCompletionsToolDefinition>> GetMcpTools()
{
    Console.WriteLine("Listing tools");
    var tools = await mcpClient.ListToolsAsync();

    List<ChatCompletionsToolDefinition> toolDefinitions = new List<ChatCompletionsToolDefinition>();

    foreach (var tool in tools)
    {
        Console.WriteLine($"Connected to server with tools: {tool.Name}");
        Console.WriteLine($"Tool description: {tool.Description}");
        Console.WriteLine($"Tool parameters: {tool.JsonSchema}");

        JsonElement propertiesElement;
        tool.JsonSchema.TryGetProperty("properties", out propertiesElement);

        var def = ConvertFrom(tool.Name, tool.Description, propertiesElement);
        Console.WriteLine($"Tool definition: {def}");
        toolDefinitions.Add(def);

        Console.WriteLine($"Properties: {propertiesElement}");        
    }

    return toolDefinitions;
}

// 1. List tools on mcp server

var tools = await GetMcpTools();
for (int i = 0; i < tools.Count; i++)
{
    var tool = tools[i];
    Console.WriteLine($"MCP Tools def: {i}: {tool}");
}

// 2. Define the chat history and the user message
var userMessage = "add 2 and 4";

chatHistory.Add(new ChatRequestUserMessage(userMessage));


// 3. Define options, including the tools
var options = new ChatCompletionsOptions(chatHistory)
{
    Model = "gpt-4.1-mini",
    Tools = { tools[0] }
};

// 4. Call the model  

ChatCompletions? response = await client.CompleteAsync(options);
var content = response.Content;

// 5. Check if the response contains a function call
ChatCompletionsToolCall? calls = response.ToolCalls.FirstOrDefault();
for (int i = 0; i < response.ToolCalls.Count; i++)
{
    var call = response.ToolCalls[i];
    Console.WriteLine($"Tool call {i}: {call.Name} with arguments {call.Arguments}");
    //Tool call 0: add with arguments {"a":2,"b":4}

    var dict = JsonSerializer.Deserialize<Dictionary<string, object>>(call.Arguments);
    var result = await mcpClient.CallToolAsync(
        call.Name,
        dict!,
        cancellationToken: CancellationToken.None
    );

    Console.WriteLine(result.Content.OfType<TextContentBlock>().First().Text);

}

// 6. Print the generic response
Console.WriteLine($"Assistant response: {content}");

Java

try {
    // ดำเนินการคำขอภาษาธรรมชาติที่ใช้เครื่องมือ MCP อัตโนมัติ
    String response = bot.chat("Calculate the sum of 24.5 and 17.3 using the calculator service");
    System.out.println(response);

    response = bot.chat("What's the square root of 144?");
    System.out.println(response);

    response = bot.chat("Show me the help for the calculator service");
    System.out.println(response);
} finally {
    mcpClient.close();
}

ในโค้ดนี้เราได้:

  • ใช้พรอมต์ภาษาธรรมชาติอย่างง่ายเพื่อโต้ตอบกับเครื่องมือของเซิร์ฟเวอร์ MCP
  • เฟรมเวิร์ก LangChain4j จัดการโดยอัตโนมัติ:
    • แปลงพรอมต์ผู้ใช้เป็นการเรียกเครื่องมือเมื่อจำเป็น
    • เรียกเครื่องมือ MCP ที่เหมาะสมตามการตัดสินใจของ LLM
    • จัดการโฟลว์การสนทนาระหว่าง LLM และเซิร์ฟเวอร์ MCP
  • เมธอด bot.chat() คืนค่าการตอบสนองเป็นภาษาธรรมชาติ ซึ่งอาจรวมผลลัพธ์จากการเรียกเครื่องมือ MCP ด้วย
  • วิธีนี้มอบประสบการณ์ที่ไหลลื่นให้กับผู้ใช้ โดยไม่ต้องรู้จักการทำงานเบื้องหลังของ MCP

ตัวอย่างโค้ดเต็ม:

public class LangChain4jClient {
    
    public static void main(String[] args) throws Exception {        ChatLanguageModel model = OpenAiOfficialChatModel.builder()
                .isGitHubModels(true)
                .apiKey(System.getenv("GITHUB_TOKEN"))
                .timeout(Duration.ofSeconds(60))
                .modelName("gpt-4.1-nano")
                .timeout(Duration.ofSeconds(60))
                .build();

        McpTransport transport = new HttpMcpTransport.Builder()
                .sseUrl("http://localhost:8080/sse")
                .timeout(Duration.ofSeconds(60))
                .logRequests(true)
                .logResponses(true)
                .build();

        McpClient mcpClient = new DefaultMcpClient.Builder()
                .transport(transport)
                .build();

        ToolProvider toolProvider = McpToolProvider.builder()
                .mcpClients(List.of(mcpClient))
                .build();

        Bot bot = AiServices.builder(Bot.class)
                .chatLanguageModel(model)
                .toolProvider(toolProvider)
                .build();

        try {
            String response = bot.chat("Calculate the sum of 24.5 and 17.3 using the calculator service");
            System.out.println(response);

            response = bot.chat("What's the square root of 144?");
            System.out.println(response);

            response = bot.chat("Show me the help for the calculator service");
            System.out.println(response);
        } finally {
            mcpClient.close();
        }
    }
}

Rust

นี่เป็นส่วนที่ทำงานส่วนใหญ่ เราจะเรียก LLM ด้วยพรอมต์ผู้ใช้เริ่มต้น จากนั้นประมวลผลการตอบกลับเพื่อดูว่าต้องเรียกใช้เครื่องมือใดหรือไม่ หากต้องเรียกจะเรียกเครื่องมือเหล่านั้น จากนั้นดำเนินการสนทนาต่อกับ LLM จนกว่าจะไม่มีการเรียกเครื่องมืออีก และเราได้รับผลลัพธ์สุดท้าย

เราจะเรียก LLM หลายครั้ง ดังนั้นให้กำหนดฟังก์ชันที่จัดการการเรียก LLM เพิ่มฟังก์ชันนี้ในไฟล์ main.rs:

async fn call_llm(
    client: &Client<OpenAIConfig>,
    messages: &[Value],
    tools: &ListToolsResult,
) -> Result<Value, Box<dyn Error>> {
    let response = client
        .completions()
        .create_byot(json!({
            "messages": messages,
            "model": "openai/gpt-4.1",
            "tools": format_tools(tools).await?,
        }))
        .await?;
    Ok(response)
}

ฟังก์ชันนี้รับ LLM client, รายการข้อความ (รวมทั้งพรอมต์ผู้ใช้), เครื่องมือจากเซิร์ฟเวอร์ MCP แล้วส่งคำขอไปยัง LLM และส่งคืนผลลัพธ์กลับมา คำตอบจาก LLM จะประกอบด้วยอาเรย์ของ choices เราจะต้องประมวลผลผลลัพธ์เพื่อดูว่ามี tool_calls อยู่หรือไม่ ซึ่งจะทำให้เรารู้ว่า LLM กำลังร้องขอให้เรียกใช้เครื่องมือเฉพาะพร้อมกับอาร์กิวเมนต์ เพิ่มโค้ดดังต่อไปนี้ที่ส่วนล่างของไฟล์ main.rs ของคุณเพื่อกำหนดฟังก์ชันสำหรับจัดการกับการตอบกลับของ LLM:

async fn process_llm_response(
    llm_response: &Value,
    mcp_client: &RunningService<RoleClient, ()>,
    openai_client: &Client<OpenAIConfig>,
    mcp_tools: &ListToolsResult,
    messages: &mut Vec<Value>,
) -> Result<(), Box<dyn Error>> {
    let Some(message) = llm_response
        .get("choices")
        .and_then(|c| c.as_array())
        .and_then(|choices| choices.first())
        .and_then(|choice| choice.get("message"))
    else {
        return Ok(());
    };

    // พิมพ์เนื้อหาถ้ามี
    if let Some(content) = message.get("content").and_then(|c| c.as_str()) {
        println!("🤖 {}", content);
    }

    // จัดการการเรียกใช้เครื่องมือ
    if let Some(tool_calls) = message.get("tool_calls").and_then(|tc| tc.as_array()) {
        messages.push(message.clone()); // เพิ่มข้อความผู้ช่วย

        // ดำเนินการเรียกใช้เครื่องมือแต่ละรายการ
        for tool_call in tool_calls {
            let (tool_id, name, args) = extract_tool_call_info(tool_call)?;
            println!("⚡ Calling tool: {}", name);

            let result = mcp_client
                .call_tool(CallToolRequestParam {
                    name: name.into(),
                    arguments: serde_json::from_str::<Value>(&args)?.as_object().cloned(),
                })
                .await?;

            // เพิ่มผลลัพธ์ของเครื่องมือไปยังข้อความ
            messages.push(json!({
                "role": "tool",
                "tool_call_id": tool_id,
                "content": serde_json::to_string_pretty(&result)?
            }));
        }

        // ดำเนินการสนทนาต่อด้วยผลลัพธ์ของเครื่องมือ
        let response = call_llm(openai_client, messages, mcp_tools).await?;
        Box::pin(process_llm_response(
            &response,
            mcp_client,
            openai_client,
            mcp_tools,
            messages,
        ))
        .await?;
    }
    Ok(())
}

ถ้ามี tool_calls ฟังก์ชันจะดึงข้อมูลเครื่องมือ, เรียกใช้เซิร์ฟเวอร์ MCP ด้วยคำขอเครื่องมือ และเพิ่มผลลัพธ์ลงในข้อความสนทนา แล้วจึงดำเนินการสนทนาต่อกับ LLM โดยข้อความจะได้รับการอัปเดตด้วยการตอบกลับของผู้ช่วยและผลลัพธ์การเรียกเครื่องมือ

เพื่อดึงข้อมูลการเรียกเครื่องมือที่ LLM คืนค่ากลับมาเพื่อใช้กับ MCP calls เราจะเพิ่มอีกฟังก์ชันช่วยสำหรับดึงข้อมูลที่จำเป็นทั้งหมดในการเรียกเครื่องมือนั้น เพิ่มโค้ดต่อไปนี้ที่ส่วนล่างของไฟล์ main.rs ของคุณ:

fn extract_tool_call_info(tool_call: &Value) -> Result<(String, String, String), Box<dyn Error>> {
    let tool_id = tool_call
        .get("id")
        .and_then(|id| id.as_str())
        .unwrap_or("")
        .to_string();
    let function = tool_call.get("function").ok_or("Missing function")?;
    let name = function
        .get("name")
        .and_then(|n| n.as_str())
        .unwrap_or("")
        .to_string();
    let args = function
        .get("arguments")
        .and_then(|a| a.as_str())
        .unwrap_or("{}")
        .to_string();
    Ok((tool_id, name, args))
}

เมื่อทุกส่วนครบถ้วนแล้ว เราสามารถจัดการกับ prompt เริ่มต้นของผู้ใช้และเรียก LLM ได้ อัปเดตฟังก์ชัน main ของคุณให้รวมโค้ดต่อไปนี้:

// การสนทนา LLM พร้อมการเรียกใช้เครื่องมือ
let response = call_llm(&openai_client, &messages, &tools).await?;
process_llm_response(
    &response,
    &mcp_client,
    &openai_client,
    &tools,
    &mut messages,
)
.await?;

โค้ดนี้จะถามคำถามกับ LLM ด้วย prompt เริ่มต้นของผู้ใช้ที่ขอหาผลรวมของตัวเลขสองตัว และจะประมวลผลการตอบกลับเพื่อจัดการแบบไดนามิกกับการเรียกเครื่องมือ

เยี่ยมมาก คุณทำได้แล้ว!

การบ้าน

นำโค้ดจากแบบฝึกหัดไปสร้างเซิร์ฟเวอร์พร้อมเครื่องมือเพิ่มเติม จากนั้นสร้างไคลเอนต์ที่มี LLM เหมือนในแบบฝึกหัด และทดสอบกับ prompt ต่าง ๆ เพื่อให้แน่ใจว่าเครื่องมือในเซิร์ฟเวอร์ของคุณถูกเรียกใช้อย่างไดนามิก การสร้างไคลเอนต์แบบนี้หมายความว่าผู้ใช้ปลายทางจะได้รับประสบการณ์ใช้งานที่ยอดเยี่ยมเพราะสามารถใช้ prompt แทนคำสั่งไคลเอนต์ที่เจาะจงและไม่ต้องรู้ตัวว่า MCP server ใดถูกเรียกใช้

วิธีแก้ไข

Solution

ข้อคิดสำคัญ

  • การเพิ่ม LLM ในไคลเอนต์ของคุณช่วยให้ผู้ใช้มีวิธีโต้ตอบกับ MCP Servers ที่ดีกว่า
  • คุณต้องแปลงผลลัพธ์จาก MCP Server ให้อยู่ในรูปแบบที่ LLM เข้าใจได้

ตัวอย่าง

แหล่งข้อมูลเพิ่มเติม

ต่อไปนี้


ปฏิเสธความรับผิดชอบ: เอกสารนี้ได้รับการแปลโดยใช้บริการแปลภาษา AI Co-op Translator ขณะที่เราพยายามให้ความถูกต้อง โปรดทราบว่าการแปลโดยอัตโนมัติอาจมีข้อผิดพลาดหรือความไม่ถูกต้อง เอกสารต้นฉบับในภาษาต้นทางควรถูกพิจารณาเป็นแหล่งข้อมูลที่เชื่อถือได้ สำหรับข้อมูลที่สำคัญ แนะนำให้ใช้การแปลโดยมนุษย์มืออาชีพ เราไม่รับผิดชอบต่อความเข้าใจผิดหรือการตีความที่ผิดพลาดที่เกิดขึ้นจากการใช้การแปลนี้