Resource: Document
A knowledge document to be used by a KnowledgeBase
.
For more information, see the knowledge base guide .
Note: The projects.agent.knowledgeBases.documents
resource is deprecated; only use projects.knowledgeBases.documents
.
JSON representation |
---|
{ "name" : string , "displayName" : string , "mimeType" : string , "knowledgeTypes" : [ enum ( |
name
string
Optional. The document resource name. The name must be empty when creating a document. Format: projects/<Project ID>/locations/<Location
ID>/knowledgeBases/<Knowledge Base ID>/documents/<Document ID>
.
displayName
string
Required. The display name of the document. The name must be 1024 bytes or less; otherwise, the creation request fails.
mimeType
string
Required. The MIME type of this document.
knowledgeTypes[]
enum (
KnowledgeType
)
Required. The knowledge type of document content.
enableAutoReload
boolean
Optional. If true, we try to automatically reload the document every day (at a time picked by the system). If false or unspecified, we don't try to automatically reload the document.
Currently you can only enable automatic reload for documents sourced from a public url, see source
field for the source types.
Reload status can be tracked in latestReloadStatus
. If a reload fails, we will keep the document unchanged.
If a reload fails with internal errors, the system will try to reload the document on the next day. If a reload fails with non-retriable errors (e.g. PERMISSION_DENIED), the system will not try to reload the document anymore. You need to manually reload the document successfully by calling documents.reload
and clear the errors.
latestReloadStatus
object (
ReloadStatus
)
Output only. The time and status of the latest reload. This reload may have been triggered automatically or manually and may not have succeeded.
state
enum (
State
)
Output only. The current state of the document.
source
. Required. The source of this document. source
can be only one of the following:contentUri
string
The URI where the file content is located.
For documents stored in Google Cloud Storage, these URIs must have the form gs://<bucket-name>/<object-name>
.
NOTE: External URLs must correspond to public webpages, i.e., they must be indexed by Google Search. In particular, URLs for showing documents in Google Cloud Storage (i.e. the URL in your browser) are not supported. Instead use the gs://
format URI described above.
rawContent
string ( bytes
format)
The raw content of the document. This field is only permitted for EXTRACTIVE_QA and FAQ knowledge types.
A base64-encoded string.
Methods |
|
---|---|
|
Creates a new document. |
|
Deletes the specified document. |
|
Exports a smart messaging candidate document into the specified destination. |
|
Retrieves the specified document. |
|
Creates documents by importing data from external sources. |
|
Returns the list of all documents of the knowledge base. |
|
Updates the specified document. |
|
Reloads the specified document from its specified source, content_uri or content. |