Agent Design Requirements
See Glossary document in map Legend.For the purpose of this document the following terms are defined:Resource: Any raw or finished materiel, item, component, or thing that can be used or consumed; also includes human labor and services.Agent: An autonomous software application that acts to fill a need in the operation of society. An Agent provides one or more Services.Service: A function perfomed, either by automation or humans, that provides something useful to society.Zone: An area that an element operates within.
Agent Types 1.0
Environmental Agent 1.1
Scope
Environmental Agent ScopeEnvironmental Agent scope is defined by configuration. It may be an entire building or a zone which can be one or more rooms.
Purpose
Environmental Agent PurposeMonitor environmental factors (inputs), and then maintain those factors within specified parameters (outputs). Collaborate with other agents when needed to accomplish a goal.This agent may be complex in the number of things that may be monitored; however, the functioning of each parameter is simple; such as keeping temperature within a certain range.Example factors: temperature, humidity, air quality, soil moisture, lighting, etc.
Learning
Learning RequirementsThis agent will be capable of learning the habits of the occupants within its domain as well as external factors from its location such as weather, and adjust environmental factors accordingly.Examples:Adjust temperatures around personal schedule and habits to maximize comfort and efficiency.
Intrinsic Knowledge
Air
Temperature
Humidity
Quality
Water
Temperature
Ambient water temperture is recorded over time.Also records the desired water temperature for each occupant for bathing purposes.
Quality
Water quality is cosntantly monitored and recorded.
Lighting
Record lighting patterns by time and occupancy. Information may be used for predictive setting of lighting patterns.Occupants may record situational desired patterns for example different settings for romatic dining, or dinner party.
Energy
Record energy consuption over time and by major fuction; for heating of air, heating of water, lighting, appliaces.This information will be used by the learning algorithms to obtain maximum energy efficiency.
Extrisic Knowledge
Special Learning Algorithms
Interface
Interface RequirementsThe interface Requirements define how the agent will inteact with the outside world; represented by Communication (with other agents) and human interface.
Agent Communication
Agent CommunicationRepresents the messaging between agents; as send or receive. Evry send message to an agent must have a corresponding receive node at the receiving agent.
Send
SendNotify the Emergency Responce Agent of a life threatening environmental condition; fire, air quality hazard, etc.
Emergency Responce Agent: Emergency
Receive
ReceiveReceive represents messages received from other agents.
Emergency Responce Agent: ETA of Emergency Unit
Control Zone 1..n
Local Interface RequirementsThe local interface includes inputs from sensors, or reading devices within the agents scope. It may also include outputs to actuators or external devices within the agents scope.A simple example is a temperature control system. Inputs would include temperature readings from a room. Outputs may include the furnace and blower, or may involve changing the opacity of the winows, opening or closing shutters or other temperature control devices.
Input
InputSensors: Air and water temperature, humidity, soil moiture, Ambient light level.
Output
OutputTurn heating and cooling system on/off.Turn on alarm if air contamination exceeds safe ligmits; smoke from a fire.Turn on/off on-demand water heater.Set lighting to the desired levels.
Human
Human Interface RequirementSome Agents will need to interact with people through a human/machine inteface. That may take the form of a display device such as a flat panel disply, tablet or swart phone and a device for recieving inputs such as a keyboard, or touch screen.
Presentation
PresentationConfiguration data.Display history of environmental readings; montly water sage, energy usage, etc.
Request
RequestConfiguration of agent.Permit the setting of environmental factors.
Sanitation Agent 1.2
Scope
Sanitation Agent ScopeThe Sanitation Agent scope is defined by configuration. It may be an entire building or a zone which can be one or more rooms.
Purpose
Sanitation Agent PurposeThis agent may be complex or simple in the scope of the area in its domain. Sanitation includes removing objects that are out of place (clutter) and arranging for them to be put back where they belong. It may also include identifying dirty or soiled surfaces and arranging to have that surface cleaned. This agent may negotiate with other agents, such as a housekeeping agent to accomplish remediation. When it finds a condition out of tolerance it will order remediation of the situation.Depending on the environment, a sanitation agent may be on a fixed or mobile platform.This agent also is responsible for keeping a regular cleaning schedule and ordering the appropriate bots to do the work.Some examples could include:1. Upon noticing muddy footprints the floor-bot is ordered to clean the floor.3. Upon noticing clothes lying on the floor, the housekeeping-bot is ordered to pick up dirty clothes.Monitor sanitation factors (inputs), and then coordinates the remediation of those factors that are out range (outputs) with other agents.
Learning
Learning RequirementsDepending on the type of situation, there may be several ways to remediate a problem. The Sanitation Agent can learn the most effective method for its given environment.
Intrinsic Knowledge
Intrinsic knowledge should include information about the area, what normal should look like.Maintain schedule of normal maintenance cleaning.Must have knowledge of the types of things to look for for, what is acceptable what is not.For example: Monitoring a work bench. You would not want a housekeeping bot dispatched every time a person set down a wrench to pick up a screw driver. The Agent must be smart enough to know when someone is working to wait until they are done or a when cleanup is requested.
Extrisic Knowledge
Must be aware of the other special cleaning bots that are available in the system to call upon for a special job.
Special Learning Algorithms
The agent should be able to learn the social routine of people and adjust its schedule as to not be intrusive, yet efficietly get the job done.Example: A person routinely leaves their clothes on a chair as they go to bed. The agent should know not to disturb the area and pick up the clothes until that person has risen the next day.
Interface
Interface RequirementsThe interface Requirements define how the agent will inteact with the outside world; represented by Communication (with other agents) and human interface.
Agent Communication
Agent CommunicationRepresents the messaging between agents; as send or receive. Evry send message to an agent must have a corresponding receive node at the receiving agent.
Send
SendIssue orders to specialized cleaning bots.If the required cleaning bot is not on premises, orer a bot to be delivered. Example: Some specialized cleaning may require the services of a bot that is shared by an entire building, or neighborhood.
Request Agent: Special Cleaning Bot
Receive
ReceiveReceive represents messages received from other agents.
Request Agent: ETA Confirmation or delivery of Cleaning Bot
Local
Local Interface RequirementsThe local interface includes inputs from sensors, or reading devices within the agents scope. It may also include outputs to actuators or external devices within the agents scope.A simple example is a temperature control system. Inputs would include temperature readings from a room. Outputs may include the furnace and blower, or may involve changing the opacity of the winows, opening or closing shutters or other temperature control devices.
Input
InputVisual scan of area at predetermined intervals.feedback from mobile bots equiped with sensors to anaylize the contaminant.
Output
OutputDeodorizing and antibacterial aerosol release into the ventilation system.
Human
Human Interface RequirementSome Agents will need to interact with people through a human/machine inteface. That may take the form of a display device such as a flat panel disply, tablet or swart phone and a device for recieving inputs such as a keyboard, or touch screen.
Presentation
PresentationConfiguration data.Display cleaning schedule.Display history of orders.
Request
RequestConfiguration of agent.people may request a mess to be cleaned up, and not wait for the next scan.Ste up and configure cleaning schedules.
Resource Agent 1.3
Scope
Resource Agent ScopeThe scope for the Resource agent may be very simple or vast depending on where it is working. An agent may be responsible for the resources in a single structure, or monitoring natural resources within a region.
Purpose
Resource Agent PurposeMonitor all of the resources within its domain. If the resources are being consumed at this location, then request additional resources from a Request Agent if the supply drops below a given level.If this is a production location (as in a factory, or an extraction node/mine), then this agent is responsible for anticipating production quantities and its ability to meet future demand.When a request for resources is made of the agent, it can either confirm the full order, confirm a partial order, deny an order. When an order is confirmed those resources are placed on reserve, so that they cannot be promised twice. They will stay on reserve until the confirmation to ship is received, or the request is canceled. A cancel request removes the resources from reserve making them available again. If the order to ship comes in the resources are changed from reserve to committed.
Learning
Learning RequirementsLearn consumption demand patterns and resupply times.
Intrinsic Knowledge
Containers
Resorces
Extrisic Knowledge
Special Learning Algorithms
Interface
Interface Requirements
Agent Communication
Agent Communication
Send
SendThis agent will communicate with a Request Agent when its supply of a resource drops below its required quantity. When the quantity drops to a certain level, this agent may start making requests just to determine the best source for replacement in case it requires extra time.
Reqest agent: Find Resource
Request Agent: Order Resource
Receive
ReceiveThis agent will communicate with a Request Agent when its supply of a resource drops below its required quantity. When the quantity drops to a certain level, this agent may start making requests just to determine the best source for replacement in case it requires extra time.
Request Agent: Resources Available
Request Agent: Confirm Resource Order
Local
Local Interface RequirementsThe local interface includes inputs from sensors, or reading devices within the agents scope. It may also include outputs to actuators or external devices within the agents scope.A simple example is a temperature control system. Inputs would include temperature readings from a room. Outputs may include the furnace and blower, or may involve changing the opacity of the winows, opening or closing shutters or other temperature control devices.
Input
InputAble to descern an addition or subtraction of resouces from a zone.
Output
Human
Human Interface RequirementThe agent will need to provide information about its resorces, and receives requests for a resource.
Presentation
PresentationConfiguration data.Current resorce levels.Rate of consumption or production.History of resorce requests for in and out flows.
Request
RequestA resource
Grounds Agent 1.4
Scope
Grounds Agent ScopeThe scope for the grounds agent will typically represent the area immediately surrounding a structure and includes all lawns, plant and shrubs used for landscaping.
Purpose
Grounds Agent PurposeThe purpose of the Grounds Agent is to maintain the lawns, plants, shrubs and other landscaping that surround a building in the city. The Grounds Agent fills the role typically done by a lanscape gardner. When required, the Grounds Agent may solicit the help of bots to do some of the work, such as mowing the grass, trimming the shrubs, etc.
Learning
Intrinsic Knowledge
The Grounds Agent needs to know everything required to maintain the landscaping surrounding the building where is is assigned.This will include the species of every plant growing in the area; also, the proper nutrients, water and environment for each. I will need to know what kinds of pests or problems to watch out for and how to identify each.It will also need to know what types of Bots to request for to accomplish certain tasks.
Extrisic Knowledge
Knowledge of the weather forecast will permit the Grounds Agent to alter behavior to optimize care.
Special Learning Algorithms
The agent will learn what the optimum parameters are for the area's growing conditions; how often to water plants, etc.
Interface
Agent Communication
Send
SendRequest Agent: Maintenance requestRequest Agent: Supply/Equipment request
Receive
ReceiveRequest Agent: Confirm OrderWeather Agent: Weather forecast
Local
Local Interface RequirementsThe local interface includes inputs from sensors, or reading devices within the agents scope. It may also include outputs to actuators or external devices within the agents scope.A simple example is a temperature control system. Inputs would include temperature readings from a room. Outputs may include the furnace and blower, or may involve changing the opacity of the winows, opening or closing shutters or other temperature control devices.
Input
InputInputTemperatureHumidityWind speedSoil moisture in each watering zoneSoil PH in each watering zoneSoil Nitrogen level in each watering zoneVideo surveillance of grounds
Output
OutputSprinkler systems (watering zones)Nutrient injection to water supply
Human
Presentation
PresentationAbility to inspect maitenance history.
Request
Request Agent 1.5
Scope
Request Agent ScopeThe Request Agent scope is normally for a city. In the case of non city resources such as extraction sites, the scope wil lbe for a region the encompases one or more extraction sites.
Purpose
Request Agent PurposeWhen a resource is needed somewhere, the request agent receives that request for a resource. The request could come directly from a person, from another request agent in another city or from a Resource Agent.After receiving a request the agent will poll all of the Resource Agents for available resources of that type requested.If the request is marked 'whole': If it finds all of the desired resource then it will then negotiate a delivery time with the transportation agent and send a Resource Available with delivery eta back to the requestor.If the request is marked 'partial': If it finds any of the desired resource then it will then negotiate a delivery time with the transportation agent and send a Resource Available quantity with delivery eta back to the requestor.The original requestor must either confirm to Order, or Cancel. If the Request Agent gets an Order, then it will notify the Resource Agents and Transportation Agent involved. Once the Transportation Agent sends a confirmation to the Request Agent that delivery is scheduled, then a confirmation is returned to the original requestor.If it receives a Cancel, then a Cancel is forwarded to the Resource and Transportation Agents.The Requestor will keep and track the progress of an order until it is either canceled or confirmation of delivery is received.
Learning
Learning RequirementsThe agent will learn what optimum sources of resources are, so that it can more effectively arrange delivery. It will also learn what the likes and dislikes of a particular requester are so that it can better tailor it searches. Think of the Request agent as the Google for resources.
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Interface Requirements
Agent Communication
Agent CommunicationA Request Agent may may negotiate with other Request Agents, Resorce Agents that are in its domain, the the Transportation Agent in its domain, in order to satisfy a request.
Send
SendSend represents messages sent to other agents
Any Agent: Resource Count
Any Agent: Reserve Resource
Any Agent: Resource Reserved
Request Agent: Order Resource
Any Agent: Resource Ordered
Any Agent: Resource Cancel
Any Agent: Resouce Shiped
Dispatch Agent: Request transport
Dispatch Agent: Cancel transport
Receive
ReceiveReceive represents messages received from other agents.
Any Agent: Resource Count
Any Agent: Reserve Resource
Any Agent: Resource Reserved
AnyAgent: Order Resource
Any Agent: Resource Ordered
AnyAgent: Resource Cancel
Dispatch Agent: Transportation Available for resource
Local
Input
Output
Human
Human Interface RequirementThe Request Agent relies heavily on an interface with users to browse and search for available options, and hn order the items desire. The Interface is also used to request services. Where possible the interface should should provide multiple options for interacting; graphics for pictures and details, and either a touch or voice response system. Any voice response system should be able to recognize natural language commands.
Presentation
The Request Agent maintains an inventory database of where it thinks resources are located and the quantity available. This is used for a quick reference shopping list to show a rough count of available units for each item.If the user then narrows a selection by selecting a resource and desired quantity, then Resource Reserve Request is put out that gets a firm commitment and eta for delivery. If the user confirms the order then a Resource Order is sent which places a permanent hold on those resources.Every time the Request Agent receives information about a resource its inventory database is updated. If the last recorded date is old or the resource is remote, a simple resource count may be requested from the Resource Agent or from the Request Agent in change. by the Agent to update its tables with current information.
Request
RequestA person may request a resource, and provide all the details many of which may be specific to the item being ordered.A person may also select and confirm an order once the delivery details have been displayed.
Dispatch Agent 1.6
Scope
Dispatch Agent ScopeThe Dispatch Agent is unique to each city. Its function can be quite complex as it serves the needs of the Request Agent in that city.
Purpose
Dispatch Agent PurposeThe Dispatch Agent’s purpose is to know where every transport vehicle is, and to know the status of those vehicles. This agent will receive orders from people needing transport from one location to another through a Request Agent. It also receives orders for the transport of goods within the city. It will communicate with the Transport Agents in each vehicle to negotiate a delivery task be completed. It is the Dispatch Agents role to monitor traffic throughout the city and ensure congestion does not occur.
Learning
Learning RequirementsThe agent will learn what optimum routes are from point to point. It will know when areas are under construction or a route is blocked for any reason and then reroute traffic around those areas by issuing orders to the Transport agents affected.
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Agent Communication
The Dispatch agent will communicate with other agents requesting transport, and with the individual transport agents to fill those requests.
Send
SendSend represents messages sent to other agents
Transport Agent: Instructions
Transport Agent: Request Status
Receive
ReceiveReceive represents messages received from other agents.
Request Agent: Request Transport
Request Agent: Cancel Transport
Transport Agent: Status
Local
Input
Output
Human
Presentation
Request
Transport Agent 1.7
Scope
Transport Agent ScopeA Transport Agent is reponsible for a single ground transport unit.
Purpose
Transport Agent PurposeThe Transport Agent controls a single ground transport unit. Transport units may be used for move people or for resource delivery; to transport something from one place to another. One sub-function of the Transport Agent is the navigation system that permits safe and efficient travel.The transport Agent only receives orders from the Dispatch Agent. If a passenger wishes to make a mid trip change in the destination, they do so by communicating with a Request Agent which will route the request to the Dispatch Agent. The Dispatch Agent, will then coordinate the change in travel plans and order the Transport Agent to change course.
Learning
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Interface RequirementsThe interface Requirements define how the agent will inteact with the outside world; represented by Communication (with other agents) and human interface.
Agent Communication
Agent CommunicationThe Transport agent coordinates all activities through the Dispatch agent. Units that carry humans are able to communicate with the occupants and take orders.If, for example, a person requests an impromptu stop, while en-route, the Transport Agent will communicate with the Dispatch Agent to get permission. This is done for the safety of the occupants.
Send
SendSend represents messages sent to other agents
Receive
ReceiveReceive represents messages received from other agents.
Local
Input
InputUnit status and operating parametersAmbient temperatureRoad condition; such as wet, icy or snow.
Output
OutputVehicle control
Human
Presentation
PresentationDisplay map, and route information.Interactive Verbal Communication
Request
RequestTouch screenInteractive Voice Command
Agriculture Agent 1.8
Scope
Agriculture Agent ScopeThe Agriculture Agent is responsible for one agriculture zone. That is, a contiguous area within the city that is reserved for the exclusive purpose of growing and harvesting plants.
Purpose
Agriculture Agent PurposeThe Agriculture Agent’s purpose is to be responsible for the planting tending and harvesting of a number of different crops. The Agriculture Agent will control every automated aspect of planting, nurturing/tending and harvesting plants for food and other purposes.
Learning
Intrinsic Knowledge
The agent must have detailed knowledge about how to plant, grow and harvest the many types of plants that are grown in its zone.Soil requirements for ground plants.Nutrient requirements for hydroponic and Aeroponic plants.Must be able to tell when a plant is ready to be harvested.Must know how to extract the harvestable portion of the plant without harming the main plant.Must know about the types of problems (pests, disease), how best to remediate each problem.Must know how to package and prepare harvested food for shipment to the Food Processor Agent.Must know how to package and prepare harvested waste material for shipment to the Aquaculture Agent, and/or the Horticulture Agent.
Extrisic Knowledge
Special Learning Algorithms
Interface
Agent Communication
Send
Receive
Local
Input
InputTemperatureCO2HumidityNutrient levelsSoil MoistureLight Levels
Output
OutputArtificial lightingCO2VentilationHumidity controller
Human
Presentation
Request
Aquaculture Agent 1.9
Scope
Aquaculture Agent ScopeThe Aquaculture Agent is responsible for one aquaculture zone. That is, a contiguous area within the city that is reserved for the exclusive purpose of growing and harvesting fish.
Purpose
Aquaculture Agent PurposeThe Aquaculture Agent will control every automated aspect of nurturing/tending and harvesting fish for food. The aquaculture tanks have a symbiotic relationship with the agricultural areas. Plant waste provide nutrients for the fish, while fish waste provides nutrients for plants.
Learning
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Agent Communication
Send
The Aquaculture agent will communicate with a Request Agent to order supplies, such as fish food, and chemicals.Will communicate with a special bot for harvesting or handling of fish through the Aquaculture Tender Agent.Will also keep the Resource Agent up to date with current resource levels:FishFish foodWaterChemicals use in treating the water
Request Agent: Request Supplies
Resource Agent: Inventory Counts
Aquacultutre Tender Agent (bot): Order Harvest
Aquacultutre Tender Agent (bot): Capture and move
Aquacultutre Tender Agent (bot): Capture and Treat
Receive
Local
Input
Inputs:Water Quality; flow, oxygen level, contaminants
Output
Output:Nutrients - fish foodAerators to control oxygen levelMedicine or chemical treatments for disease, parasites, or other unwanted and detrimental substance.
Human
Presentation
Request
Horticulture Agent 1.10
Scope
Horticulture Agent ScopeThe Horticulture Agent is responsible for one Horticulture zone. That is, a contiguous area within the city that is reserved for the exclusive purpose of growing and harvesting livestock and other animals.
Purpose
Horticulture Agent PurposeThe Horticulture Agent will control every automated aspect of nurturing/tending livestock and other animals. The animals raised will restricted to those that can subsist off of the waste plant material left over after harvesting. Animal waste, is then returned to the system after being processed as nutrients for the plants.
Learning
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Agent Communication
Agent CommunicationThe Horticulture Agent will communicate with a Request Agent to order supplies, such as food, and chemicals.Will communicate with a special bot for harvesting or handling of animals through the Horticulture Tender Agent.Will also keep the Resource Agent up to date with current resource levels:animalsfoodWaterChemicals and medicine use in treating the animals
Send
SendSend represents messages sent to other agents
Request Agent: Request Supplies
Resource Agent: Inventory Counts
Horticulture Tender Agent (bot): Order Harvest
Horticulture Tender Agent (bot): Capture and move
Horticulture Tender Agent (bot): Capture and Treat
Receive
Local
Input
InputWater quality, contaminantsAmbient TemperatureVideo monitoring of animals
Output
OutputFeed supplyWater supply
Human
Presentation
Request
Construction Agent 1.11
Scope
Requirement ScopeThe Construction Agent is unique to a construction project.
Purpose
Construction Agent PurposeA Construction Agent is responsible for constructing something; buildings, earthworks (such as ditches or canals), and large assemblies. Buildings include any structure; homes, offices/labs, etc.Earth works include ditches, canals, dams, roads, sidewalks, paths, ponds, rails, tunnels, etc.Large assemblies include special purpose construction robots, scaffolding, support, bridges, transport units (cars, buses, planes and trains)The Construction Agent acts as a project manager, coordinating with other specialized agents to do the work, and with a Request Agent to order supplies.
Learning
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Agent Communication
Agent CommunicationThe Construction Agent will communicate with numerous other agents (often mobile bots) to perform the work. The nature of all those agents is not yet known because they will depend on the technology available, and the goal of the construction project.This agent also communicates with a Request Agent to request supplies, and the Resource Agent to maintain inventory levels.
Send
SendSend represents messages sent to other agents
Receive
ReceiveReceive represents messages received from other agents.
Local
Local Interface RequirementsThe local interface includes inputs from sensors, or reading devices within the agents scope. It may also include outputs to actuators or external devices within the agents scope.A simple example is a temperature control system. Inputs would include temperature readings from a room. Outputs may include the furnace and blower, or may involve changing the opacity of the winows, opening or closing shutters or other temperature control devices.
Input
InputThe Inputs are things that the Agent can read, such as room temperature, location, limit switches, or any other type of information about the environment that agent needs to fulfil its purpose.
Output
OutputOutputs represent how the agent talka directly to devices to effect them. For example, turn a motor, or light off and on.Where the output is dependant on some complex processes, that proceess should be explained here.
Human
Human Interface RequirementSome Agents will need to interact with people through a human/machine inteface. That may take the form of a display device such as a flat panel disply, tablet or swart phone and a device for recieving inputs such as a keyboard, or touch screen.
Presentation
PresentationPresentation represents information that is provided to a human for display.
Request
RequestThe Request represents information that a human has provided through an interface.
Extraction Agent 1.12
Scope
Extraction Agent ScopeThe Extraction Agent is unique to resource site; a mine, forest, rock quarry, etc.
Purpose
Extraction Agent PurposeThe Extraction Agent’s purpose is to oversee the extraction of resources from a site. It will monitor all conditions at the site, and assess the quantity of remaining resources. It can receive requests from a Request agent that lives with the regional Resource agent. It keeps the resource agent up to date on resource inventory and supplies resources based on requests from a request agent.Industrial areas outside the city, are self contained, and where possible include extraction, refining, forging, forging, manufacturing, production, storage and distribution. These industrial nodes will be connected via high speed rail the the population centers for distribution of goods.
Learning
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Agent Communication
Agent CommunicationAn Extraction Agent will coordinate with the regional Request, Dispatch and Resource agents to deliver the required resource when needed.
Send
SendSend represents messages sent to other agents
Receive
ReceiveReceive represents messages received from other agents.
Local
Local Interface RequirementsThe local interface includes inputs from sensors, or reading devices within the agents scope. It may also include outputs to actuators or external devices within the agents scope.A simple example is a temperature control system. Inputs would include temperature readings from a room. Outputs may include the furnace and blower, or may involve changing the opacity of the winows, opening or closing shutters or other temperature control devices.
Input
InputThe Inputs are things that the Agent can read, such as room temperature, location, limit switches, or any other type of information about the environment that agent needs to fulfil its purpose.
Output
OutputOutputs represent how the agent talka directly to devices to effect them. For example, turn a motor, or light off and on.Where the output is dependant on some complex processes, that proceess should be explained here.
Human
Human Interface RequirementSome Agents will need to interact with people through a human/machine inteface. That may take the form of a display device such as a flat panel disply, tablet or swart phone and a device for recieving inputs such as a keyboard, or touch screen.
Presentation
PresentationPresentation represents information that is provided to a human for display.
Request
RequestThe Request represents information that a human has provided through an interface.
Emergency Response Agent 1.13
Scope
Emergency Responce Agent ScopeThere is one Emergency Response Agent per city.
Purpose
Emergency Responce Agent PurposeThe Emergency Response Agent will work in tight coordination with the Dispatch Agent to handle an emergency situation. This agent has special knowledge of emergency and disaster preparedness, and remediation. This agent will coordinate with emergency vehicles, equipment and personel when required to deal with the situation.
Learning
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Interface RequirementsThe interface Requirements define how the agent will inteact with the outside world; represented by Communication (with other agents) and human interface.
Agent Communication
Agent CommunicationThe Emergency Response Agent will coordinate with the Dispatch Agent, and Request Agent to handle all emergency situations.
Send
Receive
Local
Input
Output
OutputEmergency Siren or horn.Emergency lights (battery backup)
Human
Presentation
PresentationEmergency Escape RoutesEmergency equipment locations
Request
RequestReport emergency
Food Processor Agent 1.14
Scope
Food Processor Agent ScopeThe Food Processor Agent is responsible for one food processing building.
Purpose
Food Processing Agent PurposeThe Food Processing Agent is responsible for converting all of the agricultural crops grown, into usable food products, and then packages them for temporary storage and delivery.Most foods are delivered in their raw form, however they still need to be trimmed and cleaned.Occasionally some things may be canned for longer term storage, or preprocessed for convenience. The agent will coordinate and control all of those processes. It will also talk with the agriculture, aquaculture and horticulture agents to coordinate the supply of required food stuffs.
Learning
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Agent Communication
Agent CommunicationThis agent will communicate with the Request Agent to order supplies. It also receives requests from the Request Agent for types and quantity of food that will be needed.It also communicates with the Resource Agent to update inventories, because every process step maintains it own count. For example, the number of raw harvested carrots, cleaned and cut carrots, diced carrots and sliced carrots are all distinct inventory counts.
Send
Receive
Local
Input
Output
Human
Presentation
Request
Process Control Agent 1.15
Scope
Process Control Agent ScopeThe scope varies depending on the process.
Purpose
Process Cortrol Agent PurposeThe Process Control Agent is responsible for one process. That process may be simple and housed in a single room, and lasting only a few milliseconds, or it may be large involving many buildings, or even cities over a long period of time.The process Control Agent is perhaps the most flexible of agents in that it can be programmed and configured to fill a wide variety of roles. Simply put this agent will control the flow of a process to accomplish some task. A few examples are listed below:Examples of processes: * Control the creation of steel in a mini steel mill. * Control the assembly of a robot. * Control the manufacture of parts. * Control the refinement of chemicals.
Learning
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Agent Communication
Agent CommunicationThis agent may work under the supervision of a manager agent like the Food Processor Agent, or it may work independently, directly filling requests from a Request Agent.
Send
Receive
Local
Input
InputFeedback sesors from the machine being controlled.
Output
Output:Directly control the machines, actuators, motors, etc.
Human
Presentation
Request
Architectural Agent 1.16
Scope
Architectural Agent ScopeThe Architectural Agent is resposible for the design of one building, structure or project.
Purpose
Architectural Agent PurposeThe Architectural Agent will work with people to determine the design requirements, and then design a building or structure to accommodate those requirements.This agent will permit a person to interactively design a structure, such as a home. And then submit the request through a Request Agent which will then call on a Construction Agent that will oversee all of the details of producing a residence from the design.
Learning
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Agent Communication
Agent CommunicationAfter designing a project, this agent will contact a Request Agent to place the order.
Send
Receive
Local
Input
Output
Human
Human Interface RequirementThe agent will work with people through an interactive 3D interface to design a project.
Presentation
Request
Recycling Agent 1.17
Scope
Recycling Agent ScopeThe Recycling Agent services the entire city.
Purpose
Recycling Agent PurposeThe Recycling Agent is responsible for taking all waste products, including garbage, animal and human waste in the city, and breaking them down into useful substances that can be repurposed. The actual recycling may be distributed or centralized depending on the most efficient means of accomplishing the task.It should be possible to achieve at least a 99% efficiency in the coversion of waste into usefull substances. The benefit to this approach is that once stable, other than power, the only inputs to society for additional resources will be to replace that 1% that can't be captured by recycling, and to accomidate growth of population or standard of living.
Learning
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Agent Communication
Send
Receive
Local
Input
Output
Human
Presentation
Request
City Manager Agent 1.18
Scope
Recycling Agent ScopeThere is one City Manager Agent per city.
Purpose
City Manager Agent PurposeThe City Manager Agent’s job is diverse and vast. It is responsible for making sure the the city infrastructure is built and maintained adequately.Functions/Infrastructure Area:Transportation systemsPublic RoadsService roads and tunnelsCommunications networksFood and water supplyRecreation and common grounds and facilitiesElectricity and Gas supplyWaste and stormwater treatment and recyclingConstruction site allocation/zoningEmergency Response Centers
Learning
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Agent Communication
Send
Receive
Local
Input
Output
Human
Presentation
Request
Structure Utility Agent 1.19
Scope
Recycling Agent ScopeThere will be one Structure Utility Agent per Structure Utility Robot. There may be one or more Structure Utility Robots per residential building.
Purpose
City Manager Agent PurposeThe Structure Utility Agent and Robot is a multi-function, general-purpose mobile platform able to carry out a number of utility roles within a building. The Structure Utility Agent and Robot will reside in the service access and utility portion of a building;. most likely below ground with access to underground transport tunnels. It will also be able to access all areas of a building for maintanence.The agent and robot are responsible for:Receiving any goods shipped to the buildingStorage of goods to goods received in the buildings storage areas; refrigerators, freezers, dry lockers, etc.Prepares goods, and waste for shipment out from the building.Perform all maintenance and repair of the structure and utility areas such as storage, refrigeration and freezer lockers, food preparation equipment, the buildings xCen computer, automation systems equipment closets, water, gas, electric and waste system within the structure.Prepare meals.Wash clothes.Operate and maintain local fabrication equipment such as 3D printers.
Learning
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Agent Communication
Agent CommunicationThis agent communicates with a number of other agents, such as request and transport agents, the all agents that operate in the local structure.
Send
Receive
Local
Input/outputAll the sensors and actuators required the robot.
Input
Output
Human
Presentation
PresentationMaintenance schedules and historymeal planning menu
Request
RequestFood and beverages.Retrieval of items in storage.Storage of items not needed right away.
Assembly Agent 1.20
Scope
Recycling Agent ScopeThere is one Assembly Agent per Assembly Robot.There may be numerous Assembly Robots used in a process.
Purpose
Assembly Agent PurposeThe Assembly Agent and Robot are responsible for assembling small components into larger components or finished goods. The size and complexity of the Agent and Robot will vary with the designed parameters for the process. Some will be small, merging parts in a simple manufacturing process, while others may be huge machines used to construct large structures.
Learning
Intrinsic Knowledge
Extrisic Knowledge
Special Learning Algorithms
Interface
Agent Communication
Send
Receive
Local
Input
Output
Human
Presentation
Request
Legend
Link Colors
Links are a convinient way to add metadata to the map.
Green
Green links are used to reduce map complexity by avoiding repetition.
Red
Red links designate logical connections between nodes
light blue
suggested move of node and maybe sub-nodes
Shorthand
Sven Gillessen [TX]
Joab Russo [JR]
Andrew Buxton [AB]
Julian Jolivet [JJ]
Thanasys Eleftheropoulos [TE]
Kostas Karasavvas [KK]
William Balthrop [WB]
Bordars
Red
These nodes are under current investigation / breakdown, and should be ignored by approval process.
Text Colors
Yellow
Keyword Breakdown - Yellow keyword is the focus of requirements breakdown from the immediate top node.Following yellow keywords along green nodes will make clear the pending verrification path of breakdown from top nodes.Following yellow keywords along blue nodes will make clear the verified path of breakdown from top nodes.On Orange nodes, yellow keywords focus the breakdown along which the relevant expert domain knowledge is required.
Nodes Colors
more detail required
rejected
Subject to discussion
pending removal
Requirments removal can only be done by AB or TX
verified
Verified requirments can only be set by AB or TX
pending verification
Expert Research Required for Instantiation
Specific domain / technological knowledge is required to further breakdown this requirement by which xCEN Instantiation will be done.All nodes under an Orange node are subject to color change, until the parent Orange node is verified (Blue node color).
Glossary
Please see link.
Requirement Elements
Scope
Requirement ScopeThe scope should be a singbe statement in one or two sentences that defines the operational domain the requirement exists in. It's analogous to the area of responsibility one might assign to a human worker.For example, an Agent may havne a scope the encompases the entire city, in that a single agent instance may be responsible for any action within the city.Altenatively an Agent may have a scope of one building. An agent instance will know about and deal with any work for it's assigned building only.
Purpose
Requirement PurposeThe Purpose statement should be short; a few sentences up to a paragragh. The Purpose statement identifies the Agents primary role. It is analogous to the job description one might assign to a human worker.
Learning
Learning RequirementsMost Agents will contain intrinsic knowledge of their environment that is required for it to perform its purpose, and some may include machine learning algorithms that are used to make complex desisions. The types and areas of learning should be broken down into sub topics.
Intrinsic Knowledge
Intrinsic KnowledgeThe knowledge of the environment or other factors within the agents scope that it needs to perform its purpose.Example: The teperature of a room.
Extrisic Knowledge
Extrinsic KnowledgeThe knowledge of the environment or other factors outside the agents scope that it needs to perform its purpose. This will generally mean information passed to it by other agents.Example: Delivery time for an item being transported from another location.
Special Learning Algorithms
Special Learning AlgorithmsRepesents things that an agent will need to learn over time to adjust its decision making behavior optimization.Example: The time at which occupants will normally return home. The environmental conditions such as temperature can then be adjusted to optimize energy efficiency.
Interface
Interface RequirementsThe interface Requirements define how the agent will inteact with the outside world; represented by Communication (with other agents) and human interface.
Agent Communication
Agent CommunicationRepresents the messaging between agents; as send or receive. Evry send message to an agent must have a corresponding receive node at the receiving agent.
Send
SendSend represents messages sent to other agents
Receive
ReceiveReceive represents messages received from other agents.
Local
Local Interface RequirementsThe local interface includes inputs from sensors, or reading devices within the agents scope. It may also include outputs to actuators or external devices within the agents scope.A simple example is a temperature control system. Inputs would include temperature readings from a room. Outputs may include the furnace and blower, or may involve changing the opacity of the winows, opening or closing shutters or other temperature control devices.
Input
InputThe Inputs are things that the Agent can read, such as room temperature, location, limit switches, or any other type of information about the environment that agent needs to fulfil its purpose.
Output
OutputOutputs represent how the agent talka directly to devices to effect them. For example, turn a motor, or light off and on.Where the output is dependant on some complex processes, that proceess should be explained here.
Human
Human Interface RequirementSome Agents will need to interact with people through a human/machine inteface. That may take the form of a display device such as a flat panel disply, tablet or swart phone and a device for recieving inputs such as a keyboard, or touch screen.
Presentation
PresentationPresentation represents information that is provided to a human for display.
Request
RequestThe Request represents information that a human has provided through an interface.