Bring an existing evidence collection into GoCux without assuming wire compatibility.
Practical procedure
- Export the source passages that you have permission to retain, including titles, original references and retrieval dates. Avoid importing a rank or a snippet as if it were the entire source document.
- Create a project Knowledge source for the collection and upload useful document text. Keep an export manifest linking external identifiers to the newly returned document identifiers.
- Rebuild a representative research question using the imported sources and compare the resulting citations. Record any information lost during extraction or export.
Import evidence with its provenance
Create a Knowledge source for the selected project before adding documents. The upload endpoint accepts JSON with base64-encoded file bytes, a title, filename, classification and retention choice. GoCux extracts text and stores the text with a checksum; the original uploaded bytes are not the retained Knowledge document. Keep your authorized original separately when your workflow needs it.
Contract example
Developer examples below describe routes on an authorized, configured GoCux control-plane base URL. They are request shapes or operation references, not claims that a particular public hostname exposes the API. Use the workspace for the corresponding human workflow; availability and permissions depend on the actual deployment.
POST /knowledge/sources/{source_id}/documents — example request body
{
"title": "Renewal note",
"filename": "renewal.txt",
"contentBase64": "UmVuZXdhbCB0ZXJtczogMzAgZGF5cy4=",
"dataClassification": "public"
}Inspect the result
After a successful import, record the document identifier and review the resulting text. Search the project for a known phrase to check that useful content was extracted. Embeddings may be filled later, so immediate verification should include a lexical query. Preserve the source name and extraction context when referring to the document elsewhere.
What to keep explicit
Changing an API base URL is insufficient. Old web freshness guarantees and source-fetch behavior do not transfer to an uploaded corpus.
Handle incomplete and refused work
Invalid base64, an unsupported classification, or extracted text above the configured cap is refused. The request bounds contentBase64 to 40,000,000 characters; this is not a promise that every file of that size or format can be meaningfully extracted. Rich document support depends on deployed extraction capabilities. Missing source and unavailable storage are separate errors.
Continue with related guides
Bu iş akışını çalışma alanınıza taşıyın.
Kapsamı belirleyin. Kanıtları inceleyin. Gereken adımları onaylayın.