REST Resource: brands.agents.integrations

แหล่งข้อมูล: การผสานรวม

ข้อมูลเกี่ยวกับการผสานรวม

การแสดง JSON 
{
  "name": string,
  "status": enum (IntegrationStatus),

  // Union field integration_info can be only one of the following:
  "dialogflowEsIntegration": {
    object (DialogflowEsIntegration)
  },
  "dialogflowCxIntegration": {
    object (DialogflowCxIntegration)
  }
  // End of list of possible types for union field integration_info.
}
ช่อง
name

string

เอาต์พุตเท่านั้น ตัวระบุที่ไม่ซ้ำกันของการผสานรวม อ่านอย่างเดียว แพลตฟอร์มเป็นผู้กำหนด
status

enum (IntegrationStatus)

เอาต์พุตเท่านั้น สถานะการผสานรวม
ช่องการรวม integration_info ข้อมูลโดยละเอียดสำหรับการผสานรวม integration_info ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
dialogflowEsIntegration

object (DialogflowEsIntegration)

ข้อมูลเกี่ยวกับโปรเจ็กต์ Dialogflow ES ที่เกี่ยวข้อง https://cloud.google.com/dialogflow/es/docs
dialogflowCxIntegration

object (DialogflowCxIntegration)

ข้อมูลเกี่ยวกับโปรเจ็กต์ Dialogflow CX ที่เกี่ยวข้อง https://cloud.google.com/dialogflow/cx/docs/basics

IntegrationStatus

สถานะการผสานรวม

Enum
INTEGRATION_STATUS_UNSPECIFIED ไม่ได้ระบุสถานะการผสานรวม
ENABLED เปิดใช้แล้ว
DISABLED ปิดใช้อยู่

DialogflowEsIntegration

ข้อมูลเกี่ยวกับตัวแทน Business Messages และการเชื่อมโยงโปรเจ็กต์ Dialogflow ES

การแสดง JSON 
{
  "dialogflowProjectId": string,
  "autoResponseStatus": enum (AutoResponseStatus),
  "dialogflowServiceAccountEmail": string,
  "operationInfo": {
    object (OperationInfo)
  },
  "dialogflowKnowledgeBases": [
    {
      object (DialogflowKnowledgebase)
    }
  ]
}
ช่อง
dialogflowProjectId

string

ต้องระบุ รหัสโปรเจ็กต์ Dialogflow

แก้ไขไม่ได้ หากต้องการเปลี่ยนค่านี้ คุณต้องลบโปรเจ็กต์ Dialogflow ออกจาก Agent นี้ แล้วสร้างการผสานรวมใหม่
autoResponseStatus

enum (AutoResponseStatus)

ต้องระบุ หากเป็น ENABLED Business Messages จะส่งคำตอบของ Dialogflow ไปยังผู้ใช้โดยอัตโนมัติ
dialogflowServiceAccountEmail

string

เอาต์พุตเท่านั้น บัญชีบริการที่ต้องกำหนดค่าในโปรเจ็กต์ Dialogflow โดยใช้ "เครื่องมือแก้ไข Agent ของ Dialogflow Console" และ "ไคลเอ็นต์ Dialogflow API" บทบาทใหม่ จำเป็นต้องดำเนินการนี้เพื่อให้สิทธิ์เข้าถึง Dialogflow API
operationInfo

object (OperationInfo)

เอาต์พุตเท่านั้น ข้อมูลเกี่ยวกับสถานะการดำเนินการของการผสานรวม Dialogflow
dialogflowKnowledgeBases[]

object (DialogflowKnowledgebase)

ฐานความรู้ที่เกี่ยวข้องกับโปรเจ็กต์ Dialogflow

ไม่บังคับ

AutoResponseStatus

สถานะการตอบกลับอัตโนมัติของ Dialogflow

Enum
AUTO_RESPONSE_STATUS_UNSPECIFIED ไม่ได้ระบุการตอบกลับอัตโนมัติ
ENABLED การตอบกลับอัตโนมัติเปิดอยู่
DISABLED การตอบกลับอัตโนมัติปิดใช้อยู่

OperationInfo

ข้อมูลการดำเนินการของ Dialogflow

การแสดง JSON 
{
  "operationName": string,
  "operationType": enum (OperationType),
  "operationState": enum (OperationState),
  "error": {
    object (Status)
  }
}
ช่อง
operationName

string

เอาต์พุตเท่านั้น ชื่อที่เซิร์ฟเวอร์กำหนด (รหัสการดำเนินการ) ซึ่งจะไม่ซ้ำกันภายในบริการเดียวกันที่ส่งคืนมาในตอนแรกเท่านั้น
operationType

enum (OperationType)

เอาต์พุตเท่านั้น ประเภทการดำเนินการของ Dialogflow
operationState

enum (OperationState)

เอาต์พุตเท่านั้น สถานะการดำเนินการ Dialogflow
error

object (Status)

เอาต์พุตเท่านั้น ผลลัพธ์ข้อผิดพลาด (หากมี)

OperationType

ประเภทการดำเนินการของ Dialogflow

Enum
OPERATION_TYPE_UNSPECIFIED ไม่ได้ระบุประเภท
ASSOCIATE_DIALOGFLOW เชื่อมโยง Dialogflow
DISSOCIATE_DIALOGFLOW แยก Dialogflow
ADD_DOCUMENT_TO_KNOWLEDGEBASE เพิ่มเอกสารไปยังฐานความรู้
DELETE_DOCUMENT_FROM_KNOWLEDGEBASE ลบเอกสารออกจากฐานความรู้

OperationState

สถานะการดำเนินการใน Dialogflow

Enum
OPERATION_STATE_UNSPECIFIED สถานะที่ไม่ได้ระบุ
PROCESSING กำลังประมวลผล
COMPLETED เสร็จสมบูรณ์
FAILED ไม่สำเร็จ

สถานะ

ประเภท Status กำหนดโมเดลข้อผิดพลาดเชิงตรรกะที่เหมาะกับสภาพแวดล้อมในการเขียนโปรแกรมแบบต่างๆ ซึ่งรวมถึง REST API และ RPC API gRPC ใช้ ข้อความ Status แต่ละข้อความจะมีข้อมูล 3 ส่วน ได้แก่ รหัสข้อผิดพลาด ข้อความแสดงข้อผิดพลาด และรายละเอียดข้อผิดพลาด

คุณสามารถดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบข้อผิดพลาดนี้และวิธีใช้รูปแบบดังกล่าวได้ในคู่มือการออกแบบ API

การแสดง JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
ช่อง
code

integer

รหัสสถานะ ซึ่งควรเป็นค่า enum ของ google.rpc.Code
message

string

ข้อความแสดงข้อผิดพลาดที่นักพัฒนาแอปเห็น ซึ่งควรเป็นภาษาอังกฤษ ข้อความแสดงข้อผิดพลาดที่แสดงต่อผู้ใช้ควรแปลและส่งในช่อง google.rpc.Status.details หรือแปลโดยไคลเอ็นต์
details[]

object

รายการข้อความที่มีรายละเอียดข้อผิดพลาด API จะใช้ชุดประเภทข้อความที่พบได้ทั่วไป

ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม "@type" จะมี URI ที่ระบุประเภท ตัวอย่างเช่น { "id": 1234, "@type": "types.example.com/standard/id" }

DialogflowKnowledgebase

ข้อมูลฐานความรู้ ฐานความรู้สามารถมี URL ของคำถามที่พบบ่อยได้หลายรายการ

การแสดง JSON 
{
  "name": string,
  "displayName": string,
  "documents": [
    {
      object (DialogflowDocument)
    }
  ],
  "updateTime": string
}
ช่อง
name

string

เอาต์พุตเท่านั้น รหัสฐานความรู้

ตัวระบุที่ไม่ซ้ำกันที่แสดงผลโดยบริการ Dialogflow หลังจากสร้างฐานความรู้ หากตัวระบุแบรนด์คือ "1234" ตัวระบุตัวแทนคือ "5678" ตัวระบุการผสานรวมคือ "9092" และตัวระบุฐานความรู้คือ "1111" พารามิเตอร์นี้จะแก้ไขเป็น "brands/1234/agents/5678/integrations/9092/knowledgebases/1111"
displayName

string

ต้องระบุ ชื่อที่แสดงของฐานความรู้
documents[]

object (DialogflowDocument)

เอกสารฐานความรู้

ไม่บังคับ
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่สร้างหรืออัปเดตฐานความรู้

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

DialogflowDocument

เอกสารฐานความรู้ เอกสารอาจเป็น URL ของเว็บไซต์หรือ URL ไปยังไฟล์ CSV ก็ได้ URL ต้องเผยแพร่แบบสาธารณะ ไฟล์ CSV ต้องมีคู่คำถาม/คำตอบอย่างน้อย 1 คู่ โดยมี 1 แถวต่อคู่

การแสดง JSON 
{
  "name": string,
  "displayName": string,
  "updateTime": string,
  "operationInfo": {
    object (OperationInfo)
  },

  // Union field content can be only one of the following:
  "faqUrl": string,
  "rawContent": string
  // End of list of possible types for union field content.
}
ช่อง
name

string

รหัสเอกสารที่ระบบสร้างขึ้น

หากตัวระบุแบรนด์คือ "1234" ตัวระบุตัวแทนคือ "5678" ตัวระบุการผสานรวมคือ "9092" ตัวระบุฐานความรู้คือ "1111" และตัวระบุเอกสารคือ "2222" พารามิเตอร์นี้จะแก้ไขเป็น "brands/1234/agents/5678/integrations/9092/knowledgebase2s/1211"
displayName

string

ต้องระบุ ชื่อที่แสดงของเอกสารคำถามที่พบบ่อย
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่สร้าง/อัปเดตเอกสาร

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
operationInfo

object (OperationInfo)

เอาต์พุตเท่านั้น ข้อมูลการดำเนินการจะสร้างขึ้นเฉพาะเมื่อมีการเพิ่มเอกสารในฐานความรู้ที่มีอยู่เท่านั้น
ช่องการรวม content เนื้อหาของเอกสาร content ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
faqUrl

string

URL ของเอกสารคำถามที่พบบ่อย
rawContent

string (bytes format)

เนื้อหาดิบของเอกสาร

สตริงที่เข้ารหัสฐาน 64

DialogflowCxIntegration

ข้อมูลเกี่ยวกับตัวแทน Business Messages และการเชื่อมโยงโปรเจ็กต์ Dialogflow CX

การแสดง JSON 
{
  "dialogflowProjectId": string,
  "dialogflowAgentId": string,
  "autoResponseStatus": enum (AutoResponseStatus),
  "dialogflowServiceAccountEmail": string,
  "operationInfo": {
    object (OperationInfo)
  }
}
ช่อง
dialogflowProjectId

string

ต้องระบุ รหัสโปรเจ็กต์ Dialogflow

แก้ไขไม่ได้ หากต้องการเปลี่ยนค่านี้ คุณต้องลบโปรเจ็กต์ Dialogflow ออกจาก Agent นี้ แล้วสร้างการผสานรวมใหม่
dialogflowAgentId

string

ต้องระบุ รหัส Agent ของ Dialogflow
autoResponseStatus

enum (AutoResponseStatus)

ต้องระบุ หากเป็น ENABLED Business Messages จะส่งคำตอบของ Dialogflow ไปยังผู้ใช้โดยอัตโนมัติ
dialogflowServiceAccountEmail

string

เอาต์พุตเท่านั้น บัญชีบริการที่ต้องกำหนดค่าในโปรเจ็กต์ Dialogflow โดยใช้ "เครื่องมือแก้ไข Agent ของ Dialogflow Console" และ "ไคลเอ็นต์ Dialogflow API" บทบาทใหม่ จำเป็นต้องดำเนินการนี้เพื่อให้สิทธิ์เข้าถึง Dialogflow API
operationInfo

object (OperationInfo)

เอาต์พุตเท่านั้น ข้อมูลเกี่ยวกับสถานะการดำเนินการของการผสานรวม Dialogflow

เมธอด

create

 สร้างการผสานรวม

delete

 ลบการผสานรวม

get

 รับการผสานรวม

list

 แสดงรายการการผสานรวม

patch

 อัปเดตการผสานรวม