Watson Developer Cloud .NET Standard SDK 使用教程

Watson Developer Cloud .NET Standard SDK 使用教程

dotnet-standard-sdk :new::new::new:.NET Standard library to access Watson Services. 项目地址: https://gitcode.com/gh_mirrors/do/dotnet-standard-sdk

1. 项目目录结构及介绍

dotnet-standard-sdk/
├── src/
│   ├── IBM.WatsonDeveloperCloud/
│   │   ├── Assistant/
│   │   ├── Discovery/
│   │   ├── LanguageTranslator/
│   │   ├── NaturalLanguageUnderstanding/
│   │   ├── SpeechToText/
│   │   ├── TextToSpeech/
│   │   ├── ToneAnalyzer/
│   │   ├── VisualRecognition/
│   │   ├── WatsonService.cs
│   │   ├── WatsonService.Test.cs
│   │   └── ...
│   ├── IBM.WatsonDeveloperCloud.Test/
│   │   ├── AssistantTest.cs
│   │   ├── DiscoveryTest.cs
│   │   ├── LanguageTranslatorTest.cs
│   │   ├── NaturalLanguageUnderstandingTest.cs
│   │   ├── SpeechToTextTest.cs
│   │   ├── TextToSpeechTest.cs
│   │   ├── ToneAnalyzerTest.cs
│   │   ├── VisualRecognitionTest.cs
│   │   └── ...
│   └── IBM.WatsonDeveloperCloud.Test.Integration/
│       ├── AssistantIntegrationTest.cs
│       ├── DiscoveryIntegrationTest.cs
│       ├── LanguageTranslatorIntegrationTest.cs
│       ├── NaturalLanguageUnderstandingIntegrationTest.cs
│       ├── SpeechToTextIntegrationTest.cs
│       ├── TextToSpeechIntegrationTest.cs
│       ├── ToneAnalyzerIntegrationTest.cs
│       ├── VisualRecognitionIntegrationTest.cs
│       └── ...
├── .gitignore
├── LICENSE
├── README.md
└── WatsonDeveloperCloud.sln

目录结构说明

• src/: 包含项目的源代码。
  • IBM.WatsonDeveloperCloud/: 主要的SDK代码，包含各个服务的实现。
    • Assistant/, Discovery/, LanguageTranslator/, NaturalLanguageUnderstanding/, SpeechToText/, TextToSpeech/, ToneAnalyzer/, VisualRecognition/: 分别对应Watson服务的实现。
    • WatsonService.cs: 基础服务类，提供通用的服务功能。
    • WatsonService.Test.cs: 基础服务类的单元测试。
  • IBM.WatsonDeveloperCloud.Test/: 单元测试代码，针对各个服务的单元测试。
  • IBM.WatsonDeveloperCloud.Test.Integration/: 集成测试代码，针对各个服务的集成测试。
• .gitignore: Git忽略文件配置。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文档。
• WatsonDeveloperCloud.sln: Visual Studio解决方案文件。

2. 项目启动文件介绍

项目的启动文件主要是 WatsonDeveloperCloud.sln，这是一个Visual Studio解决方案文件，用于管理和启动整个项目。

启动步骤

1. 打开Visual Studio。
2. 选择“打开解决方案”。
3. 导航到项目目录，选择 WatsonDeveloperCloud.sln 文件并打开。
4. 在解决方案资源管理器中，右键点击 IBM.WatsonDeveloperCloud.Test 或 IBM.WatsonDeveloperCloud.Test.Integration 项目，选择“设为启动项目”。
5. 按 F5 或点击“启动”按钮，开始运行测试。

3. 项目配置文件介绍

项目中没有显式的配置文件，但可以通过环境变量或代码中的配置来设置Watson服务的API密钥和URL。

环境变量配置

在运行测试或使用SDK时，可以通过设置以下环境变量来配置Watson服务的API密钥和URL：

• IBM_API_KEY: Watson服务的API密钥。
• IBM_URL: Watson服务的URL。

代码中的配置

在代码中，可以通过以下方式配置Watson服务：

var apiKey = Environment.GetEnvironmentVariable("IBM_API_KEY");
var url = Environment.GetEnvironmentVariable("IBM_URL");

var service = new AssistantService(apiKey, url);

示例

以下是一个简单的示例，展示如何使用Assistant服务：

using IBM.WatsonDeveloperCloud.Assistant.v2;
using IBM.WatsonDeveloperCloud.Assistant.v2.Model;

class Program
{
    static void Main(string[] args)
    {
        var apiKey = Environment.GetEnvironmentVariable("IBM_API_KEY");
        var url = Environment.GetEnvironmentVariable("IBM_URL");

        var assistant = new AssistantService(apiKey, url);

        var response = assistant.Message(
            workspaceId: "your_workspace_id",
            input: new MessageInput()
            {
                Text = "Hello"
            }
        );

        Console.WriteLine(response.Output.Text[0]);
    }
}

通过以上步骤，您可以成功配置和使用Watson Developer Cloud .NET Standard SDK。

dotnet-standard-sdk :new::new::new:.NET Standard library to access Watson Services. 项目地址: https://gitcode.com/gh_mirrors/do/dotnet-standard-sdk