Step 4 / 5

Give the agent tools

A tool is a named function with a schema. AgentsKit runs it when the model decides to.

import { defineTool } from '@agentskit/tools'

export const getWeather = defineTool({
  name: 'get_weather',
  description: 'Get current weather for a city',
  schema: { city: 'string' },
  async execute({ city }) { return { city, tempC: 22 } },
})

Try it live

import { useState } from 'react'

const tools = {
  get_weather: ({ city }) => ({ city, tempC: 22 }),
  get_time: () => ({ time: new Date().toLocaleTimeString() }),
}

export default function App() {
  const [out, setOut] = useState({})
  return (
    <div style={{ fontFamily: 'system-ui', padding: 16 }}>
      <div style={{ display: 'flex', gap: 8 }}>
        <button onClick={() => setOut(tools.get_weather({ city: 'Lisbon' }))}>weather</button>
        <button onClick={() => setOut(tools.get_time())}>time</button>
      </div>
      <pre>{JSON.stringify(out, null, 2)}</pre>
    </div>
  )
}

Open Sandbox

Loading playground…

← Swap the providerPersist the conversation →