01_basic_agent.py

"""Basic Agent — 5-line hello world.

Demonstrates the simplest possible agent: define an agent, call
``runtime.run()``, and print the result.

Requirements:
    - Conductor server with LLM support
    - CONDUCTOR_SERVER_URL=http://localhost:8080/api in .env or environment
    - CONDUCTOR_AGENT_LLM_MODEL set in .env or environment (optional)
"""

from conductor.ai.agents import Agent, AgentRuntime
from settings import settings

agent = Agent(
    name="greeter",
    model=settings.llm_model,
    instructions="You are a friendly assistant. Keep responses brief.",
)

prompt = "Say hello and tell me a fun fact about Python."


if __name__ == "__main__":
    with AgentRuntime() as runtime:
        result = runtime.run(agent, prompt)
        result.print_result()

        # Production pattern:
        # 1. Deploy once during CI/CD:
        # runtime.deploy(agent)
        # CLI alternative:
        # runtime.deploy(agent) from a release script
        #
        # 2. In a separate long-lived worker process:
        # runtime.serve(agent)