tool_schema_mismatchTier 1 · 70% confidence

ai-agents-tool-schema-mismatch-pydantic-validationerror-when-llm-returns-a-dict-i-a89c193a

agent: ai_agents

When does this happen?

IF Pydantic ValidationError when LLM returns a dict instead of a string for a tool parameter without explicit type hint.

How others solved it

THEN Define all tool parameters with explicit type hints (e.g., `category: str`). If the model may still return dicts, add a parsing guard in the tool function to extract the expected value or convert to string.

@tool
def GetNewQuestion(category: str) -> str:
    if isinstance(category, dict):
        category = category.get('category', 'general')
    return f'What is your experience with {category}?'

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics