Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.linkup.so/llms.txt

Use this file to discover all available pages before exploring further.

This tutorial shows you how to use Mistral AI’s function calling with Linkup to build a chatbot with real-time web search capabilities.
1

Get your API Keys

Get your Linkup API key

Create a Linkup account for free to get your API key.

Get your Mistral API key

Create a Mistral AI account for free to get your API key.
2

Install and Setup

Install the required packages:
pip install linkup-sdk mistralai
Set up your clients:
from mistralai import Mistral
from linkup import LinkupClient
import json
from datetime import datetime

mistral_client = Mistral(api_key="your_mistral_api_key")
linkup_client = LinkupClient(api_key="your_linkup_api_key")
3

Define the Function Schema

Tell Mistral about your search function:
tools = [{
    "type": "function",
    "function": {
        "name": "search_web",
        "description": "Search the web for current information. Returns comprehensive content from relevant sources.",
        "parameters": {
            "type": "object",
            "properties": {
                "query": {
                    "type": "string",
                    "description": "The search query"
                }
            },
            "required": ["query"]
        }
    }
}]
4

Build the Chatbot

Put it all together in a conversational loop:
system_prompt = f"You are a helpful assistant. Today is {datetime.now().strftime('%B %d, %Y')}. Use web search when you need current information."
messages = [{"role": "system", "content": system_prompt}]

print("Chatbot ready! Type 'quit' to exit.\n")

while True:
    user_input = input("You: ").strip()
    if not user_input or user_input.lower() == "quit":
        break

    messages.append({"role": "user", "content": user_input})

    try:
        response = mistral_client.chat.complete(
            model="mistral-large-latest",
            messages=messages,
            tools=tools
        )

        message = response.choices[0].message

        while message.tool_calls:
            messages.append(message)
            for tool_call in message.tool_calls:
                args = json.loads(tool_call.function.arguments)
                print(f"Searching with Linkup: {args['query']}...")
                linkup_response = linkup_client.search(
                    query=args["query"],
                    depth="fast",
                    output_type="searchResults"
                )
                search_results = json.dumps(
                    [{"content": r.content} for r in linkup_response.results]
                )
                messages.append({
                    "role": "tool",
                    "name": "search_web",
                    "content": search_results,
                    "tool_call_id": tool_call.id
                })

            response = mistral_client.chat.complete(
                model="mistral-large-latest",
                messages=messages,
                tools=tools
            )
            message = response.choices[0].message

        print(f"\nAssistant: {message.content}\n")
        messages.append({"role": "assistant", "content": message.content})

    except Exception as e:
        print(f"Error: {e}\n")
        messages.pop()
Need help? Email support@linkup.so, ping us on Discord, or talk to us.