Documentation Index Fetch the complete documentation index at: https://docs.conversimple.com/llms.txt
Use this file to discover all available pages before exploring further.
Symptom
AI doesn’t call your tool
Solutions
agent = MyAgent( api_key = api_key, customer_id = customer_id)
await agent.start()
# Check registered tools
print ( "Registered tools:" )
for tool in agent._registered_tools:
print ( f " - { tool[ 'name' ] } : { tool[ 'description' ] } " )
# ❌ Bad - vague
@tool ( "Get data" )
def get_data ( self , id : str ): pass
# ✅ Good - clear and specific
@tool ( "Get customer information including name, email, and account status by customer ID" )
def get_customer ( self , customer_id : str ): pass
Symptom
Tool throws exception
Solutions
Add Error Handling
@tool ( "Get product" )
def get_product ( self , product_id : str ) -> dict :
"""Tool with error handling"""
try :
product = database.get(product_id)
if not product:
return { "error" : "not_found" }
return product
except Exception as e:
logger.error( f "Error: { e } " )
return { "error" : "internal_error" }
Solutions
@tool ( "My tool" )
def my_tool ( self , param : str ) -> dict :
"""Debug tool output"""
result = process(param)
# Log result
logger.debug( f "Tool result: { result } " )
return result
Common Fixes
Issue Fix Tool not called Improve description Tool fails Add error handling Wrong output Add logging Timeout Optimize tool code
Debugging Learn debugging techniques