Platform Service Standardization

Service will interact with the message bus through three topics.

  • Request - The service agent will listen to incoming requests on this topic

  • Response - The service agent will respond on this topic

  • Error - The service will “throw” errors on this topic

Agents which are using these services agents should publish to the above Request topic and listen on the Reponse and Error topics. Response and Errors will retain the header that was sent into the request.

Headers

  • Request Headers

  • Common Header Formats

  • type - Unique type of request for the service agent to handle (If an agent handles more than one request type on a specific topic)

  • requesterID - Name of the requesting agent

Header List

  • type - Unique type of request for the service agent to handle (If an agent handles more than one request type on a specific topic)

  • priority - HIGH, LOW, LOW_PREEMPT (Found in Scheduler and Activator)

  • taskId - Unique task among scheduled tasks.

  • window - Seconds remaining in timeslot (actuator agent)

  • SourceName - used as name to publish to in smap for archiver agent.

  • FROM - Same as requestor id (volttron.messaging.headers.FROM)

  • CONTENT_TYPE - volttron.messaging.headers.CONTENT_TYPE.JSON, volttron.messaging.headers.CONTENT_TYPE.PLAIN_TEXT Datalogger location is specified in the message itself.

  • Multibuilding

  • Cookie

Request Formats (Content-Types)

  • volttron.messaging.headers.CONTENT_TYPE.JSON

  • volttron.messaging.headers.CONTENT_TYPE.PLAIN_TEXT

Topic List

  • Platform Topics

    • platform/shutdown

    • agent/[agent]/shutdown