Your agent can use knowledge (and pages) to answer questions. You choose whether it uses all available knowledge or only the sources you specify.
Default: use all knowledge
If you don’t set corpus on the agent or in the request, the agent can use all knowledge your organization or teamspace can access. You don’t need to pass a list—just call converse and the agent has access to everything in scope.
You can set corpus when you create or update an agent, or override it per request in the converse config.
Scope to specific knowledge
To limit the agent to certain knowledge bases or pages, pass a corpus array. Each item is either a knowledge base or a page. This works in the agent config or in config on a converse call.
import os
from datagrid_ai import Datagrid
client = Datagrid(api_key=os.environ.get("DATAGRID_API_KEY"))
# Use only these knowledge sources for this request
response = client.converse(
prompt="Summarize our Q4 policy updates",
config={
"corpus": [
{"type": "knowledge", "knowledge_id": "kn_abc123"},
{"type": "page", "page_id": "page_xyz789"}
]
}
)
For situations that call for predictable behavior and to avoid exposing more knowledge than intended, set corpus explicitly instead of relying on the default. That way the agent only uses the knowledge you specify.
