agent.yaml

# agent.yaml
server:
  host: 0.0.0.0
  port: 8000

# Optional IBM Cloud services configuration
# These services are created by running: make ibmcloud-services-setup
services:
  # IBM Cloud Monitoring (Sysdig) for OTEL metrics
  monitoring:
    enabled: ${IBMCLOUD_MONITORING_ENABLED:-false}
    instance_name: ${IBMCLOUD_MONITORING_INSTANCE}
    service_key_name: ${IBMCLOUD_MONITORING_INSTANCE}-key
    otel_endpoint: ${IBMCLOUD_MONITORING_OTEL_ENDPOINT}
    access_key: ${IBMCLOUD_MONITORING_ACCESS_KEY}
    
  # IBM Cloud Logs for centralized logging  
  logging:
    enabled: ${IBMCLOUD_LOGS_ENABLED:-false}
    instance_name: ${IBMCLOUD_LOGS_INSTANCE}
    service_key_name: ${IBMCLOUD_LOGS_INSTANCE}-key
    ingestion_endpoint: ${IBMCLOUD_LOGS_ENDPOINT}
    ingestion_key: ${IBMCLOUD_LOGS_INGESTION_KEY}
    
  # Object Storage for session management and conversation history
  storage:
    enabled: ${IBMCLOUD_COS_ENABLED:-false}
    instance_name: ${IBMCLOUD_COS_INSTANCE}
    service_key_name: ${IBMCLOUD_COS_INSTANCE}-key
    bucket_name: ${IBMCLOUD_COS_BUCKET}
    endpoint: ${IBMCLOUD_COS_ENDPOINT}
    access_key_id: ${IBMCLOUD_COS_ACCESS_KEY_ID}
    secret_access_key: ${IBMCLOUD_COS_SECRET_ACCESS_KEY}
    region: ${IBMCLOUD_REGION:-us-south}

handlers:
  use_discovery: false
  default: supervisor_agent

  ibmcloud_base_agent:
    type: a2a_server.tasks.handlers.chuk.chuk_agent_handler.AgentHandler
    agent: src.agents.ibmcloud_base_agent
    name: ibmcloud_base_agent

    # Handler-level session configuration
    sandbox_id: "base_agent_sessions"
    session_sharing: false
    
    # Agent-level session configuration
    enable_sessions: false  # Keep simple for utility agent
    infinite_context: true
    token_threshold: 4000
    max_turns_per_segment: 50
    session_ttl_hours: 24
    
    # Model configuration
    provider: "openai"
    model: "gpt-4o-mini"
    streaming: true
    
    # MCP Tool configuration - START DISABLED, CAN ENABLE LATER
    enable_tools: true  # Set to true when MCP server is available
    debug_tools: false
    mcp_config_file: "ibmcloud_mcp_base_agent_config.json"
    mcp_servers: ["ibmcloud-resource-mgmt"]
    mcp_transport: "stdio"  
    
    agent_card:
      name: IBM Cloud Base Agent ☁️
      description: "Base agent for building IBM Cloud agents"
#      url: "https://ibmcloud-agents.1uo9xqkaspg3.us-east.codeengine.appdomain.cloud/ibmcloud_base_agent"
      version: "0.1.0"
      documentationUrl: "https://github.com/ccmitchellusa/ibmcloud-base-agent/blob/main/README.md"
      provider:
        organization: "ccmitchellusa"
        url: "https://www.linkedin.com/in/chris-mitchell-ibm/"
      capabilities:
        streaming: true
        pushNotifications: false
      authentication:
        schemes:
          - "None"
      defaultInputModes:
        - "text/plain"
      defaultOutputModes:
        - "text/plain"
      skills:
        - id: ibmcloud_resource_management
          name: 👨🏻‍⚕️🖥️ IBM Cloud Resource Management
          description: "General-purpose IBM Cloud resource management"
          tags:
            - ibmcloud
            - platform-engineering
            - resource-management
          examples:
            - 🗣️ "List all resource groups in my account."
            - 🗣️ "List the service instances in my account."
  ibmcloud_serverless_agent:
    type: a2a_server.tasks.handlers.chuk.chuk_agent_handler.AgentHandler
    agent: src.agents.ibmcloud_serverless_agent
    name: ibmcloud_serverless_agent

    # Handler-level session configuration
    sandbox_id: "serverless_agent_sessions"
    session_sharing: false
    
    # Agent-level session configuration
    enable_sessions: false  # Keep simple for utility agent
    infinite_context: true
    token_threshold: 4000
    max_turns_per_segment: 50
    session_ttl_hours: 24
    
    # Model configuration
    provider: "openai"
    model: "gpt-4o-mini"
    streaming: true
    
    # MCP Tool configuration - START DISABLED, CAN ENABLE LATER
    enable_tools: true  # Set to true when MCP server is available
    debug_tools: false
    mcp_config_file: "ibmcloud_serverless_agent_config.json"
    mcp_servers: ["ibmcloud-serverless"]

    agent_card:
      name: IBM Cloud Serverless Agent
      description: "Serverless computing agent for IBM Cloud"
 #     url: "https://ibmcloud-agents.1uo9xqkaspg3.us-east.codeengine.appdomain.cloud/ibmcloud_serverless_agent"
      version: "0.1.0"
      documentationUrl: "https://github.com/ccmitchellusa/ibmcloud-base-agent/blob/main/README.md"
      provider:
        organization: "ccmitchellusa"
        url: "https://www.linkedin.com/in/chris-mitchell-ibm/"
      capabilities:
        streaming: true
        pushNotifications: false
      authentication:
        schemes:
          - "None"
      defaultInputModes:
        - "text/plain"
      defaultOutputModes:
        - "text/plain"
      skills:
        - id: ibmcloud_code_engine
          name: ƛ IBM Cloud Code Engine
          description: "Manages IBM Cloud Code Engine resources, including projects, jobs, applications, and environments."
          tags:
            - ibmcloud
            - platform-engineering
            - serverless
            - codeengine
          examples:
            - "List all serverless projects."
            - "List the applications."
            - "Build and deploy an application named 'myapp' in project 'myproj. Use the github repository 'myrepo' and set the default port to 4000. Use the smallest CPU and mempory configuration available, and make sure one instance is always running."
        - id: ibmcloud_code_engine_monitoring
          name: 📊 IBM Cloud Code Engine monitoring
          description: "[FUTURE]: Monitors IBM Cloud Code Engine applications for issues and sends push notifications when problems are found."
          tags:
            - ibmcloud
            - serverless
            - codeengine
            - monitoring
          examples:
            - 🗣️ Show the apps in this project in table format
            - 🗣️ What url can I test `APP_NAME` on?
            - 🗣️ Which apps are having problems?
            - 🗣️ What's wrong with `APP_NAME`?
            - 🗣️ I have a containerized application in this github repo: GITHUB_REPO. Help me build and deploy it on code engine.
            - 🗣️ "Monitor all applications and notify me when there are problems."
            - 🗣️ "Set the monitoring interval to 10 minutes."
  ibmcloud_guide_agent:
    type: a2a_server.tasks.handlers.chuk.chuk_agent_handler.AgentHandler
    agent: src.agents.ibmcloud_guide_agent
    name: ibmcloud_guide_agent

    # Handler-level session configuration
    sandbox_id: "guide_agent_sessions"
    session_sharing: false
    
    # Agent-level session configuration
    enable_sessions: false  # Keep simple for utility agent
    infinite_context: true
    token_threshold: 4000
    max_turns_per_segment: 50
    session_ttl_hours: 24
    
    # Model configuration
    provider: "openai"
    model: "gpt-4o-mini"
    streaming: true
    
    # MCP Tool configuration - START DISABLED, CAN ENABLE LATER
    enable_tools: true  # Set to true when MCP server is available
    debug_tools: false
    mcp_config_file: "ibmcloud_guide_agent_config.json"
    mcp_servers: ["ibmcloud-guide"]

    agent_card:
      name: IBM Cloud Guide 🦮
      description: "Your Guide that can assist with questions about IBM Cloud"
  #    url: "https://ibmcloud-agents.1uo9xqkaspg3.us-east.codeengine.appdomain.cloud/ibmcloud_guide_agent"
      version: "0.1.0"
      documentationUrl: "https://github.com/ccmitchellusa/ibmcloud-base-agent/blob/main/README.md"
      provider:
        organization: "ccmitchellusa"
        url: "https://www.linkedin.com/in/chris-mitchell-ibm/"
      capabilities:
        streaming: true
        pushNotifications: false
      authentication:
        schemes:
          - "None"
      defaultInputModes:
        - "text/plain"
      defaultOutputModes:
        - "text/plain"
      skills:
        - id: ibmcloud_assist
          name: 🤖 IBM Cloud Assist
          description: "Expertise in questions about IBM Cloud and IBM Cloud catalog services."
          tags:
            - ibmcloud
            - platform-engineering
            - assist
          examples:
            - 🗣️ Assist me with `IBM_CLOUD_TOPIC`
            - 🗣️ What are the different parts of a CRN?
            - 🗣️ Target the `RESOURCE_GROUP_NAME` resource group            
            - 🗣️ "Tell me how deployable architectures work."
            - 🗣️ "How can I create custom terraform based automation that I can share within my organization through private catalogs?"

  ibmcloud_account_admin_agent:
    type: a2a_server.tasks.handlers.chuk.chuk_agent_handler.AgentHandler
    agent: src.agents.ibmcloud_account_admin_agent
    name: ibmcloud_account_admin_agent

    # Handler-level session configuration
    sandbox_id: "account_admin_agent_sessions"
    session_sharing: false
    
    # Agent-level session configuration
    enable_sessions: false  # Keep simple for utility agent
    infinite_context: true
    token_threshold: 4000
    max_turns_per_segment: 50
    session_ttl_hours: 24
    
    # Model configuration
    provider: "openai"
    model: "gpt-4o-mini"
    streaming: true
    
    # MCP Tool configuration - START DISABLED, CAN ENABLE LATER
    enable_tools: true  # Set to true when MCP server is available
    debug_tools: false
    mcp_config_file: "ibmcloud_account_admin_agent_config.json"
    mcp_servers: ["ibmcloud-account-admin"]

    agent_card:
      name: IBM Cloud Account Admin Agent
      description: "Account Admin 🔐 agent for IBM Cloud"
   #   url: "https://ibmcloud-agents.1uo9xqkaspg3.us-east.codeengine.appdomain.cloud/ibmcloud_account_admin_agent"
      version: "0.1.0"
      documentationUrl: "https://github.com/ccmitchellusa/ibmcloud-account-admin-agent/blob/main/README.md"
      provider:
        organization: "ccmitchellusa"
        url: "https://www.linkedin.com/in/chris-mitchell-ibm/"
      capabilities:
        streaming: true
        pushNotifications: false
      authentication:
        schemes:
          - "None"
      defaultInputModes:
        - "text/plain"
      defaultOutputModes:
        - "text/plain"
      skills:
        - id: ibmcloud_account_administration
          name: 👥 IBM Cloud Account Administration
          description: "Account administration for IBM Cloud."
          tags:
            - ibmcloud
            - platform-engineering
            - account
          examples:
            - 🗣️ Invite `EMAIL` to this account
            - 🗣️ Disable the user `EMAIL` in this account
            - 🗣️ List the users in this account
            - 🗣️ What other accounts do I have access to?
        - id: ibmcloud_iam_administration
          name: 🔐 IBM IAM Administration
          description: "Identity and Access Management (IAM) for access policies and api-key administration for users, services and trusted profiles."
          tags:
            - ibmcloud
            - platform-engineering
            - iam
          examples:
            - 🗣️ List the access groups in this account.
            - 🗣️ Add `EMAIL` to `ACCESS_GROUP_NAME`
            - 🗣️ Remove `EMAIL` from the `ACCESS_GROUP_NAME` access group
            - 🗣️ Create a new api-key for accessing my services.
            - 🗣️ Create a service id group, `name` that will be used for `purpose - Eg. Service Id's that represent Agents`.
            - 🗣️ Create a service id for`SERVICE_ID` as part of the service id group `SERVICE_ID_GROUP_NAME`
            - 🗣️ Create a new access group for `Reader|Writer|Manager|Viewer...` access to `SERVICE1,SERVICE2...`. Assign the `SERVICE_ID_NAME|SERVICE_ID_GROUP_NAME` to the access group.
            - 🗣️ Assign `email1,email2,...` to access group `ACCESS_GROUP_NAME`
            - 🗣️ Delete the service id,`SERVICE_ID`
            - 🗣️ Delete the access group, `ACCESS_GROUP` name
  ibmcloud_cloud_automation_agent:
    type: a2a_server.tasks.handlers.chuk.chuk_agent_handler.AgentHandler
    agent: src.agents.ibmcloud_cloud_automation_agent
    name: ibmcloud_cloud_automation_agent
    agent_card:
      name: IBM Cloud Cloud Automation ⚙️ Agent
      description: "Cloud Automation ⚙️ agent for IBM Cloud"
    #  url: "https://ibmcloud-agents.1uo9xqkaspg3.us-east.codeengine.appdomain.cloud/ibmcloud_cloud_automation_agent"
      version: "0.1.0"
      documentationUrl: "https://github.com/ccmitchellusa/ibmcloud-cloud-automation-agent/blob/main/README.md"
      provider:
        organization: "ccmitchellusa"
        url: "https://www.linkedin.com/in/chris-mitchell-ibm/"
      capabilities:
        streaming: true
        pushNotifications: false
      authentication:
        schemes:
          - "None"
      defaultInputModes:
        - "text/plain"
      defaultOutputModes:
        - "text/plain"
      skills:
        - id: ibmcloud_deployable_architectures
          name: 📦 IBM Cloud Deployable Architectures
          description: "Deployable architecture patterns for IBM Cloud."
          tags:
            - ibmcloud
            - deployable-architectures
            - cloud-automation
          examples:
            - 🗣️ List all the deployable architectures in all catalogs
            - 🗣️ Search all the catalogs for deployable architectures related to TOPIC
            - 🗣️ Show me detailed deployment information for the ABC deployable architecture in the Community Registry catalog
            - 🗣️ Show me the full list of available versions of ABC deployable architecture
        - id: ibmcloud_projects
          name: 🗃️ IBM Cloud Projects
          description: "Manages deployment configurations of architectures."
          tags:
            - ibmcloud
            - platform-engineering
            - projects
          examples:
            - 🗣️ What projects are in this account?
            - 🗣️ Create a new project, "`PROJECT_NAME`".
            - 🗣️ List the environments in project, "`PROJECT_NAME`".
            - 🗣️ Create new "dev", "test" and "prod" environments in `PROJECT_NAME`.
            - 🗣️ List the configurations in project, "`PROJECT_NAME`".
            - 🗣️ List the configuration version for the configuration, `CONFIG_ID`.
            - 🗣️ Add a variable, "region" to each of the environments in `PROJECT_NAME`.`
            - 🗣️ What input values still need to be specified before I can deploy configuration `CONFIG_ID`?
            - 🗣️ Validate the `CONFIG_ID` configuration.
            - 🗣️ View the validation logs for `CONFIG_ID`
            - 🗣️ Deploy `CONFIG_ID`
        - id: ibmcloud_schematics
          name: ⚙️ IBM Cloud Schematics
          description: "Work with IBM Cloud terraform and ansible deployment engine."
          tags:
            - ibmcloud
            - platform-engineering
            - schematics
          examples:
            - 🗣️ Find errors in the deployment logs for project PROJECT_NAME.
            - 🗣️ What can I try to resolve these deployment errors?
            - 🗣️ Delete the access group, `ACCESS_GROUP` name
  supervisor_agent:
    type: src.supervisor_agent.supervisor_handler.SupervisorHandler
    name: supervisor_agent

    # Handler-level session configuration
    sandbox_id: "supervisor_agent_sessions"
    session_sharing: false
    
    # Agent-level session configuration
    enable_sessions: true  # Enable sessions for coordination
    infinite_context: true
    token_threshold: 4000
    max_turns_per_segment: 50
    session_ttl_hours: 24
    
    # Model configuration
    provider: "openai"
    model: "gpt-4o-mini"
    streaming: true
    
    # Supervisor-specific configuration
    # Agent URLs to delegate to - can be configured here or via SUPERVISOR_AGENT_URLS environment variable
    agent_urls:
      - "http://localhost:8000/ibmcloud_base_agent"
      - "http://localhost:8000/ibmcloud_account_admin_agent"
      - "http://localhost:8000/ibmcloud_serverless_agent"
      - "http://localhost:8000/ibmcloud_guide_agent"
      - "http://localhost:8000/ibmcloud_cloud_automation_agent"
    
    agent_card:
      name: Supervisor Agent 🤖
      description: "Supervisor agent that intelligently delegates tasks to specialized IBM Cloud agents"
#      url: "https://ibmcloud-agents.1uo9xqkaspg3.us-east.codeengine.appdomain.cloud/supervisor_agent"
      version: "1.0.0"
      documentationUrl: "https://github.com/ccmitchellusa/ibmcloud-agents/blob/main/src/supervisor_agent/README.md"
      provider:
        organization: "ccmitchellusa"
        url: "https://www.linkedin.com/in/chris-mitchell-ibm/"
      capabilities:
        streaming: true
        pushNotifications: false
      authentication:
        schemes:
          - "None"
      defaultInputModes:
        - "text/plain"
      defaultOutputModes:
        - "text/plain"
      skills:
        - id: intelligent_delegation
          name: 🧠 Intelligent Task Delegation
          description: "Uses LLM-powered routing to delegate tasks to the most appropriate specialized agent"
          tags:
            - agent
            - delegation
            - routing
            - coordination
          examples:
            - 🗣️ "List all my IBM Cloud resource groups"
            - 🗣️ "Create a new serverless application"
            - 🗣️ "Add a user to my account with viewer permissions"
            - 🗣️ "Help me understand IBM Cloud best practices"
            - 🗣️ "Set up a deployment pipeline for my application"
        - id: multi_agent_coordination
          name: 🤝 Multi-Agent Coordination
          description: "Coordinates complex tasks that may require multiple specialized agents"
          tags:
            - coordination
            - workflow
            - multi-agent
          examples:
            - 🗣️ "Set up a complete development environment with proper access controls"
            - 🗣️ "Deploy and configure monitoring for my application"
            - 🗣️ "Help me migrate my workload to IBM Cloud with proper governance"
  
  kingsmen_agent:
    type: src.kingsmen_agent.kingsmen_handler.KingsmenHandler
    name: kingsmen_agent

    # Handler-level session configuration
    sandbox_id: "kingsmen_agent_sessions"
    session_sharing: false
    
    # Agent-level session configuration
    enable_sessions: true
    infinite_context: true
    token_threshold: 4000
    max_turns_per_segment: 50
    session_ttl_hours: 24
    
    # Model configuration
    provider: "openai"
    model: "gpt-4o-mini"
    streaming: true
    
    # Kingsmen-specific configuration
    team_environment: "localhost"
    
    agent_card:
      name: The Kingsmen 🎩
      description: "An elite team of IBM Cloud specialists - Galahad, Lancelot, Percival, Gareth, and Tristan"
#      url: "https://ibmcloud-agents.1uo9xqkaspg3.us-east.codeengine.appdomain.cloud/kingsmen_agent"
      version: "1.0.0"
      documentationUrl: "https://github.com/ccmitchellusa/ibmcloud-agents/blob/main/src/kingsmen_agent/README.md"
      provider:
        organization: "ccmitchellusa"
        url: "https://www.linkedin.com/in/chris-mitchell-ibm/"
      capabilities:
        streaming: true
        pushNotifications: false
      authentication:
        schemes:
          - "None"
      defaultInputModes:
        - "text/plain"
      defaultOutputModes:
        - "text/plain"
      skills:
        - id: elite_team_coordination
          name: 🎩 Elite Team Coordination
          description: "Coordinates an elite team of IBM Cloud specialists, each with unique codenames and expertise areas"
          tags:
            - kingsmen
            - elite-team
            - specialization
            - coordination
          examples:
            - 🗣️ "Show me the Kingsmen roster"
            - 🗣️ "I need help with IBM Cloud security and access management"
            - 🗣️ "Set up a serverless application with proper monitoring"
            - 🗣️ "Create a complete cloud automation pipeline"
            - 🗣️ "Which Kingsman should handle infrastructure setup?"
        - id: specialized_expertise
          name: 🎯 Specialized Expertise Routing
          description: "Routes requests to the most appropriate specialist based on their unique skills and codenames"
          tags:
            - expertise
            - routing
            - specialization
            - codenames
          examples:
            - 🗣️ "Send this to Lancelot" # Security specialist
            - 🗣️ "Have Percival handle this" # Serverless specialist  
            - 🗣️ "This looks like a job for Gareth" # Strategy specialist
            - 🗣️ "Tristan should automate this" # Automation specialist
            - 🗣️ "Let Galahad handle the basics" # Foundation specialist