watsonx Assistant API 概觀

您可以使用 watsonx Assistant REST API 和對應的 SDK,來開發與服務互動的應用程式。

用戶端應用程式

要建立虛擬助理或其他在運行時與助理通訊的客戶端應用程序,請使用 v2 API。 您可以開發面向客戶的用戶端 (可部署用於正式作業)、分配管理系統在助理與另一個服務之間進行通訊的應用程式,或測試應用程式。

藉由使用第 2 版運行環境 API 與助理進行通訊,應用程式可以充分運用下列特性:

  • 自動狀態管理。 v2 運行時 API 管理與使用者的每個會話,儲存和維護助理完成對話所需的所有上下文資料。

  • 輕鬆部署助理。 除了支援自訂用戶端之外,還可以輕鬆地將助理部署到 Slack 和 Facebook Messenger 這類常用傳訊頻道。

  • 版本控制。 您可以儲存內容快照並將您的助手連結到該特定版本。 然後,您可以繼續更新開發版本,而不會影響正式作業助理。

  • 搜尋功能。 v2 運行環境 API 可用來接收來自搜尋整合的回應。 當提交助理無法回答的查詢時,搜尋整合可以從已配置的資料來源尋找最佳答案。

如需相關資訊,請參閱 watsonx Assistant v2 API 參考資料

watsonx Assistant v1 API 支持 /message 將使用者輸入直接傳送到對話方塊所使用的工作區的方法。 支援 v1 運行時 API 主要是為了相容性。 如果您使用第 1 版 /message 方法,則必須實作您自己的狀態管理,而無法充分運用助理的版本化或其他任何特性。

編寫應用程式

v1 API 提供了使應用程式能夠建立或修改對話技能的方法,作為使用經典的 Watson Assistant 使用者介面以圖形方式建立技能的替代方法。 編寫應用程式會使用 API 來建立及修改構成對話技能的技能、目的、實體、對話節點及其他構件。 有關更多信息,請參閱 v1 API 參考

v1 創作方法創建和修改工作區而不是技能。 工作區是對話技能內對話及訓練資料(例如目的及實體)的容器。 如果您使用 API 建立新的工作區,它將在經典的 Watson Assistant 使用者介面中顯示為新的對話技能。

如需可用 API 方法的清單,請參閱 API 方法摘要