basic_usage.py

"""
Example: using SupportAssistant programmatically (not via the CLI).

This script requires a real AI_API_KEY to actually call the provider.
Set it in your .env file (see .env.example) before running:

    python examples/basic_usage.py

All customer messages below are fictional and used purely for
demonstration purposes.
"""

import sys
from pathlib import Path

# Allow running this example directly without installing the package.
sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "src"))

from ai_support_assistant.assistant import SupportAssistant  # noqa: E402
from ai_support_assistant.config import ConfigError  # noqa: E402
from ai_support_assistant.exceptions import AIProviderError  # noqa: E402

DEMO_MESSAGES = [
    "Hi, how can I change my delivery address for an order I just placed?",
    "And what if the order has already shipped?",
]


def main() -> None:
    try:
        assistant = SupportAssistant()
    except ConfigError as exc:
        print(f"Configuration error: {exc}")
        print("Tip: copy .env.example to .env and add your own AI_API_KEY.")
        return

    for message in DEMO_MESSAGES:
        print(f"\nCustomer: {message}")
        try:
            reply = assistant.ask(message)
        except AIProviderError as exc:
            print(f"[AI provider error] {exc}")
            return
        print(f"Assistant: {reply}")


if __name__ == "__main__":
    main()