CrewAI

pip install caesar-search crewai pydantic

from typing import Type

from caesar_search import Caesar
from crewai.tools import BaseTool
from pydantic import BaseModel, Field

client = Caesar()  # reads CAESAR_API_KEY


class CaesarSearchInput(BaseModel):
    query: str = Field(..., description="Search query")
    max_results: int = Field(5, description="Maximum results, 1-50")


class CaesarSearchTool(BaseTool):
    name: str = "web_search"
    description: str = "Search the web with Caesar and return ranked results with doc_id values."
    args_schema: Type[BaseModel] = CaesarSearchInput

    def _run(self, query: str, max_results: int = 5) -> str:
        response = client.search(query, max_results=max_results, verbosity="compact")
        return response.model_dump_json()

class CaesarReadInput(BaseModel):
    target: str = Field(..., description="Caesar doc_id or URL")
    query: str | None = Field(None, description="Optional focus question")
    max_chars: int | None = Field(None, description="Optional maximum characters to return")


class CaesarReadTool(BaseTool):
    name: str = "web_fetch"
    description: str = "Read a Caesar doc_id or URL as clean markdown."
    args_schema: Type[BaseModel] = CaesarReadInput

    def _run(self, target: str, query: str | None = None, max_chars: int | None = None) -> str:
        response = client.read(target, query=query, max_chars=max_chars)
        return response.model_dump_json()


tools = [CaesarSearchTool(), CaesarReadTool()]

client.feedback("result_helpful", search_id=search_id, doc_id=doc_id)