--- title: Call Tools description: Learn how to call tools using the AI SDK and React Server Components. tags: ['rsc', 'tool use'] --- # Call Tools Some models allow developers to provide a list of tools that can be called at any time during a generation. This is useful for extending the capabilities of a language model to either use logic or data to interact with systems external to the model. ## Client Let's create a simple conversation between a user and model and place a button that will call `continueConversation`. ```tsx filename='app/page.tsx' 'use client'; import { useState } from 'react'; import { Message, continueConversation } from './actions'; // Allow streaming responses up to 30 seconds export const maxDuration = 30; export default function Home() { const [conversation, setConversation] = useState([]); const [input, setInput] = useState(''); return (

{conversation.map((message, index) => (

{message.role}: {message.content}

))}

{ setInput(event.target.value); }} />

); } ``` ## Server Now, let's implement the `continueConversation` action that uses `generateText` to generate a response to the user's question. We will use the [`tools`](/docs/reference/ai-sdk-core/generate-text#tools) parameter to specify our own function called `celsiusToFahrenheit` that will convert a user given value in celsius to fahrenheit. We will use zod to specify the schema for the `celsiusToFahrenheit` function's parameters. ```tsx filename='app/actions.ts' 'use server'; import { generateText } from 'ai'; import { z } from 'zod'; export interface Message { role: 'user' | 'assistant'; content: string; } export async function continueConversation(history: Message[]) { 'use server'; const { text, toolResults } = await generateText({ model: 'openai/gpt-5.4', system: 'You are a friendly assistant!', messages: history, tools: { celsiusToFahrenheit: { description: 'Converts celsius to fahrenheit', inputSchema: z.object({ value: z.string().describe('The value in celsius'), }), execute: async ({ value }) => { const celsius = parseFloat(value); const fahrenheit = celsius * (9 / 5) + 32; return `${celsius}°C is ${fahrenheit.toFixed(2)}°F`; }, }, }, }); return { messages: [ ...history, { role: 'assistant' as const, content: text || toolResults.map(toolResult => toolResult.result).join('\n'), }, ], }; } ```