> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Add knowledge

> Add retrieval context and project knowledge for agents and apps.

Add knowledge when agents or apps need project-specific retrieval context.

## Steps

1. Add or import the source content.
2. Create or update RAG documents.
3. Connect knowledge to the agents or apps that need it.
4. Check available context before relying on retrieval.

## Try it with REST

Search project knowledge:

`POST /projects/{project_reference}/knowledge/lookup`

```bash title="Terminal" theme={null}
curl -X POST https://api.veryfront.com/projects/support-assistant/knowledge/lookup \
  -H "Authorization: Bearer $VERYFRONT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "refund policy"
  }'
```

Import a file from connected storage:

`POST /providers/{provider}/files/{file_id}/import`

```bash title="Terminal" theme={null}
curl -X POST https://api.veryfront.com/providers/google_drive/files/<FILE_ID>/import \
  -H "Authorization: Bearer $VERYFRONT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "<PROJECT_ID>",
    "base_path": "knowledge"
  }'
```

## API surfaces

| Surface | Start here                                                                                                                                                    |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| REST    | [Knowledge Lookup](/cloud/rest/api-reference/knowledge/lookup-project-knowledge), [RAG Documents](/cloud/rest/api-reference/rag-documents/list-rag-documents) |
| GraphQL | [Semantic Search Files](/cloud/graphql/operations/search/queries/semanticsearchfiles)                                                                         |
| MCP     | [Search Knowledge](/cloud/mcp/tools/search-knowledge), [Import External File](/cloud/mcp/tools/import-external-file)                                          |

## Verify

Search for a phrase from the imported file.

Connect the knowledge source to the agent only after search returns the expected context.

## Knowledge surfaces

| Surface            | Use it for                             |
| ------------------ | -------------------------------------- |
| Knowledge manifest | Project-level retrieval configuration. |
| RAG document       | Searchable document context.           |
| Agent connection   | Runtime access to retrieval context.   |

## API reference

| API                       | Use                          |
| ------------------------- | ---------------------------- |
| [REST](/cloud/rest)       | Knowledge and RAG documents. |
| [GraphQL](/cloud/graphql) | Knowledge views.             |
| [MCP](/cloud/mcp)         | Knowledge tools.             |