Built-In Tools Overview

Our API offers several powerful built-in tools that enable advanced search and information retrieval capabilities for your AI applications.

​

Tools Overview

​

How Built-In Tools Work

​

Choosing the Right Tool

• Think Tool: Use when you need to document reasoning steps or decision processes without changing state.
• File Search Tool: Ideal for direct, immediate results on simple queries when you know exactly what you’re looking for.
• Agentic Search Tool: Perfect for complex, multi-faceted questions requiring comprehensive information gathering and deep exploration.

​

Getting Started

​

Basic Configuration

Start with minimal configuration for each tool:

curl --location 'http://localhost:8080/v1/responses' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $YOUR_API_KEY' \
--header 'x-model-provider: openai' \
--data '{
    "model": "gpt-4o",
    "tools": [
      {
        "type": "think"
      }
    ],
    "input": "Analyze the pros and cons of microservices architecture",
    "instructions": "Document your analysis process using the think tool."
}'

​

Advanced Options

For more control, each tool offers additional configuration parameters:

​

Example Applications

• Customer Support: Use the Agentic Search Tool to research complex customer issues across your knowledge base.
• Legal Research: Find relevant precedents and statutes with the File Search Tool.
• Code Documentation: Document reasoning behind architectural decisions with the Think Tool.
• Medical Research: Use Agentic Search for comprehensive literature reviews on medical topics.

​

Performance Considerations

• File Search is faster but less thorough
• Agentic Search provides better results for complex questions but uses more resources
• For time-critical applications, set appropriate timeouts and consider using File Search