This solution starter was created by technologists from IBM.
- Henry Nash
- Va Barbosa
- Javier Torres
- Omer Arad
- JJ Asghar
- Jody Burks
- Robert Loredo
- Debbie Kestin Schildkraut
- Bruce Weed
There is a growing interest in enabling communities to cooperate among themselves to solve these problems, whether it be to advertise where supplies are held, offer assistance for collections, or other local services like volunteer deliveries.
In times of crisis, such as the 2020 SARS-COV-2 (COVID-19 or "Novel Coronavirus") crisis, while federal and local governments may be rolling out broad programs, cooperation at the local level is usually the most effective way of getting help to where it is most needed as quickly as possible. Traditional social media is one way of communicating within a community, but this is (by its very design) not locally focused, and often not sufficiently structured to enable rapid discovery of help needed.
In the COVID-19 crisis, we have already seen shortages of local food, medical equipment, and other supplies. In addition, the recommended (or required) self-isolation and social distancing measures can compound the problem by preventing people from easily getting to locations with the best stocks of supplies.
What is needed is a solution that empowers communities to easily connect and provide this information to each other.
Mobile, web, and cloud services enable rapid deployment of applications that can empower cooperation in the community. Watson Assistant is a service on IBM Cloud that allows you to build, train, and deploy conversational interactions into any application, device, or channel.
Creating a chatbot using Watson Assistant can help you address the issues that your users may face while trying to gather the necessary information. Embedding location/routing services (like HERE) can enhance such applications, giving optimum guidance so that they are outside of their isolation location for the minimum amount of time.
The goal is to provide a mobile application, along with server-side components, that serves as the basis for developers to build out a community cooperation application that addresses local needs for food, equipment, and resources. It would allow both "Suppliers" (such as a store or a community member who has produce they can sell or distribute) to make people aware of what the have; and consumers ("Recipients") to locate where these supplies are, and, if necessary, guide them to the appropriate locations to pick them up.
A Supplier (who may be a regular resident, a small business, a voluntary organization, etc.) that has food, supplies, resources, or other essentials they can provide opens the mobile application and fills out a brief form that indicates what they have. This information is then stored in a database in the IBM Cloud.
A Recipient, who is in need of food, supplies, resources, or other essentials, opens the mobile application and can use the chat interface to locate supplies near them. For instance, they might type "Where can I find bread?" or "Can someone collect my shopping for me?" The mobile application then accesses the database (after first understanding the question via Watson Assistant) and then displays a map showing locally where they can find what they are looking for.
This solution starter idea combines a chat interface (Watson Assistant), data storage to hold the status of supplies available, and location services with real-time information to get users the information they need.
- The Recipient launches the mobile app and can access information across multiple services.
- The Recipient can ask questions to Watson Assistant and get answers on food/service availability questions.
- The Supplier can post the availability of stock or services they can provide, as well as locate the items they need.
- The Recipient can obtain geolocation data to plot routes to collect (or drop off) supplies using HERE Location Services.
Trusted sources for COVID-19 Information:
- CDC COVID-19 FAQ
- WHO COVID-19 page
- Johns Hopkins University Coronavirus (includes tracking map)
- National Foundation for Infectious Diseases
- Bot Asset Exchange
- IBM Watson Assistant
- How-to guides for chatbots
- Create a machine learning powered web app to answer questions
- Learning path: Getting started with Watson Assistant
- Train a speech-to-text model
- Enhance customer helpdesks with Smart Document Understanding using webhooks in Watson Assistant
- Watson Voice Agent
- Getting Started with Watson Voice Agent
- Making Programmatic Calls from Watson Assistant
- IBM Cloud Voice Agent with Twilio
- Build a Chatbot For Your Mobile App
- Build a cross-platform mobile app using React Native
- Building successful mobile apps article series
- Chat Bot Slack Integration
- Chat Bot Slack deployment
- Node-RED Slack integration
- Register for an IBM Cloud account.
- Install and configure IBM Cloud CLI.
- Register for a HERE account.
- Install React Native CLI dependencies (for iOS).
- Clone the repository.
- Set up an instance of Watson Assistant.
- Provision a CouchDB instance using Cloudant.
- Generate an API Key from the HERE Developer Portal.
- Run the server.
- Run the mobile application.
Log in to IBM Cloud and provision a Watson Assistant instance.
-
Provision an instance of Watson Assistant from the IBM Cloud catalog.
-
Launch the Watson Assistant service.
-
Add a dialog skill to the Assistant by importing the
starter-kit-cooperation-dialog-skill.json
file. -
Go back to All Assistants page, open Settings from the action menu (
โฎ
) and click on API Details. -
Note the Assistant ID, API Key, and Assistant URL. For Assistant URL, make note of the base URL/domain (e.g.,
https://api.us-south.assistant.watson.cloud.ibm.com
orhttps://api.eu-gb.assistant.watson.cloud.ibm.com
) and not the full directory/path. You will need all three of these values in Step 4 below. -
Go to Preview Link to get a link to test and verify the dialog skill.
Log into the IBM Cloud and provision a CouchDB instance using Cloudant.
- From the catalog, select Databases and then the Cloudant panel.
- Once selected, you can choose your Cloudant plan -- there is a free tier for simple testing that is sufficient to run this CIR example. You should choose an appropriate region, give the service a name, and it is recommended you choose Use only IAM under Available authentication methods. You can leave the other settings with their defaults. Click the blue Create button when ready.
- Once your Cloudant instance has been created, you need to create a service credential that the CIR API Server can use to communicate with it. By selecting your running Cloudant instance, you can choose Service credentials from the left-hand menu. Create a new service credential and give it a name (it doesn't matter what you call it).
- Once created, you can display the credentials by selecting view service credentials, and then copy the credential, so you are ready to paste it into the code of the API server in Step 4.
The application uses HERE Location Services for maps, searching, and routing.
To access these services, you'll need an API key. Follow the instructions outlined in the HERE Developer Portal to generate a JavaScript API key.
To set up and launch the server application:
- Go to the
starter-kit/server-app
directory of the cloned repo. - Copy the
.env.example
file in thestarter-kit/server-app
directory, and create a new file named.env
. - Edit the newly created
.env
file and update theASSISTANT_URL
,ASSISTANT_ID
, andASSISTANT_IAM_APIKEY
with the values from the dialog skill's API Detail page in Watson Assistant, from Step 1. Also, update theCLOUDANT_ID
andCLOUDANT_IAM_APIKEY
with the values from the service credential you created in Step 2. (Note that theusername
from the credential is what should be used for theCLOUDANT_ID
.) - Edit the name value in the
manifest.yml
file to your application name (for example, my-app-name). - From a terminal:
- Go to the
starter-kit/server-app
directory of the cloned repo. - Install the dependencies:
npm install
. - Launch the server application locally or deploy to IBM Cloud:
- To run locally:
- Start the application:
npm start
. - The server can be accessed at http://localhost:3000.
- Start the application:
- To deploy to IBM Cloud:
- Log in to your IBM Cloud account using the IBM Cloud CLI:
ibmcloud login
. - Target a Cloud Foundry org and space:
ibmcloud target --cf
. - Push the app to IBM Cloud:
ibmcloud app push
. - The server can be accessed at a URL using the name given in the
manifest.yml
file (for example, https://my-app-name.bluemix.net).
- Log in to your IBM Cloud account using the IBM Cloud CLI:
- To run locally:
- Go to the
To run the mobile application (using the Xcode iOS Simulator):
- Go to the
starter-kit/mobile-app
directory of the cloned repo. - Copy the
.env.example
file in thestarter-kit/mobile-app
directory, and create a file named.env
. - Edit the newly created
.env
file:- Update the
STARTER_KIT_SERVER_URL
with the URL to the server app launched in the previous step. - Update the
HERE_APIKEY
with the API key generated in the HERE Developer Portal.
- Update the
- From a terminal:
- Go to the
starter-kit/mobile-app
directory. - Install the dependencies:
npm install
. - Go to the
ios
directory:cd ios
. - Install pod dependencies:
pod install
. - Return to the
mobile-app
directory:cd ../
. - Launch the app in the simulator:
npm run ios
. You should be running at least iOS 13.0. - The first time you launch the simulator, you should ensure that you set a Location in the Features menu.
- Go to the
With the application running in the simulator, you should be able to navigate through the various screens:
- IBM Cloud
- Watson Assistant
- IBM Cloudant
- HERE Location Services
- Node.js
- React Native
- IBM Blockchain for Developers
This solution starter is made available under the Apache 2 License.