node.js - 使用 node.js 的 Watson API

Question

我正在尝试使用此 node.js 代码在我们的 ios 应用程序中使用 ibm cloud bluemix 中的 watson api。任何人都可以告诉我这段代码在做什么，并向我们提供如何从我们的应用程序使用 watson 服务的答案。

var express = require('express');
var https = require('https');
var url = require('url');

// setup middleware

var app = express();
app.use(express.errorHandler());
app.use(express.urlencoded()); // to support URL-encoded bodies
app.use(app.router);

app.use(express.static(__dirname + '/public')); //setup static public directory
app.set('view engine', 'jade');
app.set('views', __dirname + '/views'); //optional since express defaults to CWD/views

// There are many useful environment variables available in process.env.
// VCAP_APPLICATION contains useful information about a deployed application.

var appInfo = JSON.parse(process.env.VCAP_APPLICATION || "{}");
// TODO: Get application information and use it in your app.

// defaults for dev outside bluemix

var service_url = '<service_url>';
var service_username = '<service_username>';
var service_password = '<service_password>';

// VCAP_SERVICES contains all the credentials of services bound to
// this application. For details of its content, please refer to
// the document or sample of each service.

if (process.env.VCAP_SERVICES) {
  console.log('Parsing VCAP_SERVICES');
  var services = JSON.parse(process.env.VCAP_SERVICES);

//service name, check the VCAP_SERVICES in bluemix to get the name of the services you have

var service_name = 'question_and_answer';

  if (services[service_name]) {
    var svc = services[service_name][0].credentials;
    service_url = svc.url;
    service_username = svc.username;
    service_password = svc.password;
  } else {
    console.log('The service '+service_name+' is not in the VCAP_SERVICES, did you forget to bind it?');
  }

} else {
  console.log('No VCAP_SERVICES found in ENV, using defaults for local development');
}

console.log('service_url = ' + service_url);
console.log('service_username = ' + service_username);
console.log('service_password = ' + new Array(service_password.length).join("X"));

var auth = "Basic " + new Buffer(service_username + ":" +    service_password).toString("base64");

// render index page

app.get('/', function(req, res){
    res.render('index');
});

// Handle the form POST containing the question to ask Watson and reply with the answer

app.post('/', function(req, res){

// Select healthcare as endpoint 

var parts = url.parse(service_url +'/v1/question/healthcare');
// create the request options to POST our question to Watson

var options = { host: parts.hostname,
    port: parts.port,
    path: parts.pathname,
    method: 'POST',
    headers: {
      'Content-Type'  :'application/json',
      'Accept':'application/json',
      'X-synctimeout' : '30',
      'Authorization' :  auth }
  };

// Create a request to POST to Watson

var watson_req = https.request(options, function(result) {
    result.setEncoding('utf-8');
    var response_string = '';

    result.on('data', function(chunk) {
      response_string += chunk;
    });

    result.on('end', function() {
      var answers_pipeline = JSON.parse(response_string),
          answers = answers_pipeline[0];
      return res.render('index',{'questionText': req.body.questionText, 'answers': answers})
   })

  });

  watson_req.on('error', function(e) {
    return res.render('index', {'error': e.message})
  });

// create the question to Watson

var questionData = {
    'question': {
      'evidenceRequest': { 
        'items': 5 // the number of anwers
      },
      'questionText': req.body.questionText // the question
    }
  };

// Set the POST body and send to Watson

 watson_req.write(JSON.stringify(questionData));
 watson_req.end();

});

// The IP address of the Cloud Foundry DEA (Droplet Execution Agent) that hosts this application:

var host = (process.env.VCAP_APP_HOST || 'localhost');
// The port on the DEA for communication with the application:

var port = (process.env.VCAP_APP_PORT || 3000);
// Start server

app.listen(port, host);

Answer 1

此代码的大部分是 Node 和在 BlueMix 环境中执行所必需的。 VCAP_SERVICES 是 Bluemix 环境变量，您可以使用它来获取您有兴趣使用的给定服务的凭证。在这种情况下，service_name 设置为 "question_and_answer" 以访问问答平台服务。

在您的 Bluemix 环境中，您应该有一个问答服务实例和一个应用程序。当应用程序绑定(bind)到问答服务时，它会创建一个服务绑定(bind)。服务绑定(bind)具有访问服务实例的应用程序凭据。在这种情况下，VCAP_SERVICES 包含用于与服务实例。

在您的 iOS 应用程序中，您需要做一些事情。首先，您需要一个服务绑定(bind)，现在您必须在 Bluemix 中创建它。在 Bluemix 中获得凭据后，您就可以在 iOS 应用程序中使用这些凭据。或者，您可以在 Bluemix 上托管应用程序并让它处理与 Watson 的通信。

接下来，您需要能够调用作为 RESTful 服务的问答服务。在上面的代码中，变量 options 包含向 Watson 服务发布问题的必要信息。请注意，从凭据获取的 service_url 附加了附加路径信息以使用 Watson For Healthcare 域。

从那里您可以创建您的问题。变量 questionData 包含上面代码中的问题。 question.questionText 属性设置为您想问 Watson 的问题，例如“我应该每天服用阿司匹林吗？”。

然后您可以将问题发布到 Watson，如以下代码片段所示:

watson_req.write(JSON.stringify(questionData));

Node 是异步的，因此响应在 http.request(...) 中处理。答案被发送回

中的请求应用程序

result.on('end', function() {
  var answers_pipeline = JSON.parse(response_string),
      answers = answers_pipeline[0];
  return res.render('index',{'questionText': req.body.questionText, 'answers': answers})
   })

其余代码是特定于 Node 的。但我已经概述了您在 iOS 应用程序中需要的基础知识。