google-dialogflow2_beta1 库允许访问Google Dialogflow服务的所有功能。

本文档是从Dialogflow crate版本5.0.5+20240614生成的，其中20240614是mako代码生成器v5.0.5构建的dialogflow:v2beta1模式的确切修订。

关于Dialogflow v2_beta1 API的其他所有内容，都可以在官方文档网站找到。

特性

从中央中心轻松处理以下资源...

• 项目
• agent entity types batch delete, agent entity types batch update, agent entity types create, agent entity types delete, agent entity types entities batch create, agent entity types entities batch delete, agent entity types entities batch update, agent entity types get, agent entity types list, agent entity types patch, agent environments create, agent environments delete, agent environments get, agent environments get history, agent environments intents list, agent environments list, agent environments patch, agent environments users sessions contexts create, agent environments users sessions contexts delete, agent environments users sessions contexts get, agent environments users sessions contexts list, agent environments users sessions contexts patch, agent environments users sessions delete contexts, agent environments users sessions detect intent, agent environments users sessions entity types create, agent environments users sessions entity types delete, agent environments users sessions entity types get, agent environments users sessions entity types list, agent environments users sessions entity types patch, agent export, agent get fulfillment, agent get validation result, agent import, agent intents batch delete, agent intents batch update, agent intents create, agent intents delete, agent intents get, agent intents list, agent intents patch, agent knowledge bases create, agent knowledge bases delete, agent knowledge bases documents create, agent knowledge bases documents delete, agent knowledge bases documents get, agent knowledge bases documents list, agent knowledge bases documents patch, agent knowledge bases documents reload, agent knowledge bases get, agent knowledge bases list, agent knowledge bases patch, agent restore, agent search, agent sessions contexts create, agent sessions contexts delete, agent sessions contexts get, agent sessions contexts list, agent sessions contexts patch, agent sessions delete contexts, agent sessions detect intent, agent sessions entity types create, agent sessions entity types delete, agent sessions entity types get, agent sessions entity types list, agent sessions entity types patch, agent train, agent update fulfillment, agent versions create, agent versions delete, agent versions get, agent versions list, agent versions patch, answer records get, answer records list, answer records patch, conversation profiles clear suggestion feature config, conversation profiles create, conversation profiles delete, conversation profiles get, conversation profiles list, conversation profiles patch, conversation profiles set suggestion feature config, conversations complete, conversations create, conversations get, conversations list, conversations messages batch create, conversations messages list, conversations participants analyze content, conversations participants create, conversations participants get, conversations participants list, conversations participants patch, conversations participants suggestions compile, conversations participants suggestions list, conversations participants suggestions suggest articles, conversations participants suggestions suggest faq answers, conversations participants suggestions suggest knowledge assist, conversations participants suggestions suggest smart replies, conversations suggestions search knowledge, conversations suggestions suggest conversation summary, delete agent, generators create, generators list, get agent, knowledge bases create, knowledge bases delete, knowledge bases documents create, knowledge bases documents delete, knowledge bases documents get, knowledge bases documents import, knowledge bases documents list, knowledge bases documents patch, knowledge bases documents reload, knowledge bases get, knowledge bases list, knowledge bases patch, locations agent entity types batch delete, locations agent entity types batch update, locations agent entity types create, locations agent entity types delete, locations agent entity types entities batch create, locations agent entity types entities batch delete, locations agent entity types entities batch update, locations agent entity types get, locations agent entity types list, locations agent entity types patch, locations agent environments create, locations agent environments delete, locations agent environments get, locations agent environments get history, locations agent environments intents list, locations agent environments list, locations agent environments patch, locations agent environments users sessions contexts create, locations agent environments users sessions contexts delete, locations agent environments users sessions contexts get, locations agent environments users sessions contexts list, locations agent environments users sessions contexts patch, locations agent environments users sessions delete contexts, locations agent environments users sessions detect intent, locations agent environments users sessions entity types create, locations agent environments users sessions entity types delete, locations agent environments users sessions entity types get, locations agent environments users sessions entity types list, locations agent environments users sessions entity types patch, locations agent export, locations agent get fulfillment, locations agent get validation result, locations agent import, locations agent intents batch delete, locations agent intents batch update, locations agent intents create, locations agent intents delete, locations agent intents get, locations agent intents list, locations agent intents patch, locations agent restore, locations agent search, locations agent sessions contexts create, locations agent sessions contexts delete, locations agent sessions contexts get, locations agent sessions contexts list, locations agent sessions contexts patch, locations agent sessions delete contexts, locations agent sessions detect intent, locations agent sessions entity types create, locations agent sessions entity types delete, locations agent sessions entity types get, locations agent sessions entity types list, locations agent sessions entity types patch, locations agent train, locations agent update fulfillment, locations agent versions create, locations agent versions delete, locations agent versions get, locations agent versions list, locations agent versions patch, locations answer records get, locations answer records list, locations answer records patch, locations conversation profiles clear suggestion feature config, locations conversation profiles create, locations conversation profiles delete, locations conversation profiles get, locations conversation profiles list, locations conversation profiles patch, locations conversation profiles set suggestion feature config, locations conversations complete, locations conversations create, locations conversations get, locations conversations list, locations conversations messages batch create, locations conversations messages list, locations conversations participants analyze content, locations conversations participants create, locations conversations participants get, locations conversations participants list, locations conversations participants patch, locations conversations participants suggestions suggest articles, locations conversations participants suggestions suggest faq answers, locations conversations participants suggestions suggest knowledge assist, locations conversations participants suggestions suggest smart replies, locations conversations suggestions search knowledge, locations conversations suggestions suggest conversation summary, locations delete agent, locations generators create, locations generators delete, locations generators get, locations generators list, locations generators patch, locations get, locations get agent, locations knowledge bases create, locations knowledge bases delete, locations knowledge bases documents create, locations knowledge bases documents delete, locations knowledge bases documents get, locations knowledge bases documents import, locations knowledge bases documents list, locations knowledge bases documents patch, locations knowledge bases documents reload, locations knowledge bases get, locations knowledge bases list, locations knowledge bases patch, locations list, locations operations cancel, locations operations get, locations operations list, locations set agent, locations stateless suggestion generate, locations suggestions generate stateless summary, locations suggestions search knowledge, operations cancel, operations get, operations list, set agent, suggestions generate stateless summary and suggestions search knowledge

本库的结构

API结构如下主要项目

• 中心
  • 一个中央对象，用于维护状态并允许访问所有活动
  • 创建方法构建器，进而允许访问单个调用构建器
• 资源
  • 可以将活动应用于的主要类型
  • 一组属性和部分
  • 部分
    • 一组属性
    • 从未直接在活动中使用
• 活动
  • 应用于资源的操作

所有结构都标记了适用的特质，以进一步分类它们并简化浏览。

一般来说，您可以像这样调用活动

let r = hub.resource().activity(...).doit().await

或具体地...

let r = hub.projects().agent_entity_types_entities_batch_create(...).doit().await
let r = hub.projects().agent_entity_types_entities_batch_delete(...).doit().await
let r = hub.projects().agent_entity_types_entities_batch_update(...).doit().await
let r = hub.projects().agent_entity_types_batch_delete(...).doit().await
let r = hub.projects().agent_entity_types_batch_update(...).doit().await
let r = hub.projects().agent_intents_batch_delete(...).doit().await
let r = hub.projects().agent_intents_batch_update(...).doit().await
let r = hub.projects().agent_knowledge_bases_documents_create(...).doit().await
let r = hub.projects().agent_knowledge_bases_documents_delete(...).doit().await
let r = hub.projects().agent_knowledge_bases_documents_patch(...).doit().await
let r = hub.projects().agent_knowledge_bases_documents_reload(...).doit().await
let r = hub.projects().agent_export(...).doit().await
let r = hub.projects().agent_import(...).doit().await
let r = hub.projects().agent_restore(...).doit().await
let r = hub.projects().agent_train(...).doit().await
let r = hub.projects().conversation_profiles_clear_suggestion_feature_config(...).doit().await
let r = hub.projects().conversation_profiles_set_suggestion_feature_config(...).doit().await
let r = hub.projects().knowledge_bases_documents_create(...).doit().await
let r = hub.projects().knowledge_bases_documents_delete(...).doit().await
let r = hub.projects().knowledge_bases_documents_import(...).doit().await
let r = hub.projects().knowledge_bases_documents_patch(...).doit().await
let r = hub.projects().knowledge_bases_documents_reload(...).doit().await
let r = hub.projects().locations_agent_entity_types_entities_batch_create(...).doit().await
let r = hub.projects().locations_agent_entity_types_entities_batch_delete(...).doit().await
let r = hub.projects().locations_agent_entity_types_entities_batch_update(...).doit().await
let r = hub.projects().locations_agent_entity_types_batch_delete(...).doit().await
let r = hub.projects().locations_agent_entity_types_batch_update(...).doit().await
let r = hub.projects().locations_agent_intents_batch_delete(...).doit().await
let r = hub.projects().locations_agent_intents_batch_update(...).doit().await
let r = hub.projects().locations_agent_export(...).doit().await
let r = hub.projects().locations_agent_import(...).doit().await
let r = hub.projects().locations_agent_restore(...).doit().await
let r = hub.projects().locations_agent_train(...).doit().await
let r = hub.projects().locations_conversation_profiles_clear_suggestion_feature_config(...).doit().await
let r = hub.projects().locations_conversation_profiles_set_suggestion_feature_config(...).doit().await
let r = hub.projects().locations_knowledge_bases_documents_create(...).doit().await
let r = hub.projects().locations_knowledge_bases_documents_delete(...).doit().await
let r = hub.projects().locations_knowledge_bases_documents_import(...).doit().await
let r = hub.projects().locations_knowledge_bases_documents_patch(...).doit().await
let r = hub.projects().locations_knowledge_bases_documents_reload(...).doit().await
let r = hub.projects().locations_operations_get(...).doit().await
let r = hub.projects().operations_get(...).doit().await

资源 resource() 和活动 activity(...) 调用创建 构建器。第二个处理 Activities，支持各种配置即将进行的操作（此处未显示）的方法。它被设计成必须立即指定所有必需的参数（即 (...)），而所有可选的参数可以按需 构建。doit() 方法执行与服务器的实际通信并返回相应的结果。

用法

设置项目

要使用此库，您需要将以下行放入您的 Cargo.toml 文件中

[dependencies]
google-dialogflow2_beta1 = "*"
serde = "^1.0"
serde_json = "^1.0"

完整示例

extern crate hyper;
extern crate hyper_rustls;
extern crate google_dialogflow2_beta1 as dialogflow2_beta1;
use dialogflow2_beta1::api::GoogleCloudDialogflowV2beta1Document;
use dialogflow2_beta1::{Result, Error};
use std::default::Default;
use dialogflow2_beta1::{Dialogflow, oauth2, hyper, hyper_rustls, chrono, FieldMask};

// Get an ApplicationSecret instance by some means. It contains the `client_id` and 
// `client_secret`, among other things.
let secret: oauth2::ApplicationSecret = Default::default();
// Instantiate the authenticator. It will choose a suitable authentication flow for you, 
// unless you replace  `None` with the desired Flow.
// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about 
// what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and
// retrieve them from storage.
let auth = oauth2::InstalledFlowAuthenticator::builder(
        secret,
        oauth2::InstalledFlowReturnMethod::HTTPRedirect,
    ).build().await.unwrap();
let mut hub = Dialogflow::new(hyper::Client::builder().build(hyper_rustls::HttpsConnectorBuilder::new().with_native_roots().unwrap().https_or_http().enable_http1().build()), auth);
// As the method needs a request, you would usually fill it with the desired information
// into the respective structure. Some of the parts shown here might not be applicable !
// Values shown here are possibly random and not representative !
let mut req = GoogleCloudDialogflowV2beta1Document::default();

// You can configure optional parameters by calling the respective setters at will, and
// execute the final call using `doit()`.
// Values shown here are possibly random and not representative !
let result = hub.projects().agent_knowledge_bases_documents_create(req, "parent")
             .import_gcs_custom_metadata(true)
             .doit().await;

match result {
    Err(e) => match e {
        // The Error enum provides details about what exactly happened.
        // You can also just use its `Debug`, `Display` or `Error` traits
         Error::HttpError(_)
        |Error::Io(_)
        |Error::MissingAPIKey
        |Error::MissingToken(_)
        |Error::Cancelled
        |Error::UploadSizeLimitExceeded(_, _)
        |Error::Failure(_)
        |Error::BadRequest(_)
        |Error::FieldClash(_)
        |Error::JsonDecodeError(_, _) => println!("{}", e),
    },
    Ok(res) => println!("Success: {:?}", res),
}

处理错误

系统产生的所有错误都作为 Result 枚举提供，作为 doit() 方法的返回值，或者作为可能的中级结果传递给 Hub Delegate 或 Authenticator Delegate。

当代理处理错误或中间值时，它们可能会有机会指示系统重试。这使得系统可能对所有类型的错误都有弹性。

上传和下载

如果某个方法支持下载，则应读取响应体以获取媒体，该响应体是 Result 的一部分。如果此类方法也支持 Response Result，则默认返回该结果。您可以将其视为实际媒体的数据。要触发媒体下载，您将需要通过以下调用设置构建器： .param("alt", "media")。

支持上传的方法可以使用多达 2 种不同的协议：简单 和 可恢复。每个的独特性通过定制的 doit(...) 方法来表示，分别命名为 upload(...) 和 upload_resumable(...)。