ibm-watson-cognitiveDémarrer avec ibm-watson-cognitive

Remarques

Cette rubrique fournit des instructions de base sur l'obtention des informations d'identification pour les services Watson et fournit des liens pertinents pour chaque service et les SDK Watson Developer Cloud.

Pages d'accueil des services Watson:

Versions

Version Date de sortie
1.0.0 2016-05-05

Obtenir les informations d'identification de l'API

Pour vous authentifier auprès des services Watson, vous avez besoin d'informations d'identification pour chaque service que vous prévoyez d'utiliser. Selon le service, vous devrez transmettre un nom d'utilisateur et un mot de passe avec l'authentification de base, ou vous devrez transmettre une clé d'API dans un paramètre pour chaque demande que vous effectuez.

Comment obtenir des informations d'identification pour un service Watson:

  1. Inscrivez-vous à Bluemix et connectez-vous.
  2. Accédez à la page de service correspondant au service Watson souhaité:
  3. Sélectionnez le plan souhaité et cliquez sur CREER:

Page du catalogue du service Bluemix

  1. Cliquez sur le bouton "Informations d'identification du service" de la page de votre tableau de bord de service pour afficher vos informations d'identification. Si vous n'êtes pas amené au tableau de bord de service automatiquement, accédez à votre tableau de bord Bluemix et cliquez sur l'instance de service de votre choix.

Emplacement des informations d'identification sur votre tableau de bord de service Bluemix

Appel des API Watson avec curl

En fonction du service, vous devrez soit utiliser l'authentification de base avec un username et un password soit passer un apikey tant que paramètre dans chaque demande.

Certains services prennent également en charge l' authentification par jeton .

GET using Tone Analyzer:

curl -X GET \
-u "username":"password" \
-d "version=2016-05-19" \
-d "text=Hey! Welcome to Watson Tone Analyzer!" \
"https://gateway.watsonplatform.net/tone-analyzer/api/v3/tone

POST utilisant AlchemyLanguage:

curl -X POST \
-d "apikey=YOUR_API_KEY" \
-d "url=www.ibm.com" \
"https://gateway-a.watsonplatform.net/calls/url/URLGetRankedKeywords"

Utilisation des SDK Watson Developer Cloud

Le moyen le plus rapide de commencer avec les services Watson consiste à utiliser les SDK Watson Developer Cloud. Les référentiels GitHub suivants contiennent des instructions d'installation et des exemples d'utilisation de base:

Par exemple, voici comment créer un appel d'API AlchemyLanguage avec le SDK Node.js:

Installez le SDK:

$ npm install watson-developer-cloud

Enregistrez le code suivant dans un fichier (nous l'appellerons app.js ). Assurez-vous de remplacer API_KEY par votre clé API.

// Instantiate the service 
var AlchemyLanguageV1= require('watson-developer-cloud/alchemy-language/v1');
var alchemy_language = AlchemyLanguageV1({
  api_key: 'API_KEY'
})

var parameters = {
  extract: [
    'entities',
    'keywords'
  ]
  url: 'https://www.ibm.com/us-en/'
};

alchemy_language.combined(parameters, function (err, response) {
  if (err)
    console.log('error:', err);
  else
    console.log(JSON.stringify(response, null, 2));
});

Exécutez l'application:

$ node app.js