Troubleshooting

USER_AGENT not set

Set a default user agent before making web requests:

$env:USER_AGENT = "IONOS-Agent-Starter/1.0"

ImportError: attempted relative import with no known parent package

Run the backend with absolute imports. In backend/main.py ensure:

from chatbot_agent import create_chatbot_agent

And run from the backend folder:

uvicorn main:app --host 127.0.0.1 --port 8000 --reload

Missing x-model-id header

Include x-model-id in requests to /.

401/403 from model API

• Verify IONOS_API_KEY is set and valid.
• Confirm the model ID is available to your account.

Module not found (langchain_core, mangum)

Install backend requirements inside your virtualenv:

pip install -r requirements.txt