Interface IKnowledgeService

Namespace

FoundationaLLM.Context.Interfaces

Assembly

FoundationaLLM.ContextEngine.dll

Defines the service interface for the FoundationaLLM Knowledge Graph service.

public interface IKnowledgeService

Extension Methods

ObjectExtensions.GetPropertyValues(object, List<string>)

Methods

GetKnowledgeSource(string, string, string?, UnifiedUserIdentity)

Retrieves a specified knowledge source.

Task<ContextServiceResponse<ResourceProviderGetResult<KnowledgeSource>>> GetKnowledgeSource(string instanceId, string knowledgeSourceId, string? agentName, UnifiedUserIdentity userIdentity)

Parameters

instanceId string

The FoundationaLLM instance identifier.

knowledgeSourceId string

The knowledge source identifier.

agentName string

The agent name if the request is being made on behalf of an agent.

userIdentity UnifiedUserIdentity

The identity of the security principal submitting the request.

Returns

Task<ContextServiceResponse<ResourceProviderGetResult<KnowledgeSource>>>

GetKnowledgeSources(string, ContextKnowledgeResourceListRequest, UnifiedUserIdentity)

Retrieves the list of knowledge sources.

Task<ContextServiceResponse<IEnumerable<ResourceProviderGetResult<KnowledgeSource>>>> GetKnowledgeSources(string instanceId, ContextKnowledgeResourceListRequest listRequest, UnifiedUserIdentity userIdentity)

Parameters

instanceId string

The FoundationaLLM instance identifier.

listRequest ContextKnowledgeResourceListRequest

The request containing the information used to filter the knowledge resources.

userIdentity UnifiedUserIdentity

The identity of the security principal submitting the request.

Returns

Task<ContextServiceResponse<IEnumerable<ResourceProviderGetResult<KnowledgeSource>>>>

GetKnowledgeUnit(string, string, string?, UnifiedUserIdentity)

Retrieves a specified knowledge unit.

Task<ContextServiceResponse<ResourceProviderGetResult<KnowledgeUnit>>> GetKnowledgeUnit(string instanceId, string knowledgeUnitId, string? agentName, UnifiedUserIdentity userIdentity)

Parameters

instanceId string

The FoundationaLLM instance identifier.

knowledgeUnitId string

The knowledge unit identifier.

agentName string

The agent name if the request is being made on behalf of an agent.

userIdentity UnifiedUserIdentity

The identity of the security principal submitting the request.

Returns

Task<ContextServiceResponse<ResourceProviderGetResult<KnowledgeUnit>>>

GetKnowledgeUnits(string, ContextKnowledgeResourceListRequest, UnifiedUserIdentity)

Retrieves the list of knowledge units.

Task<ContextServiceResponse<IEnumerable<ResourceProviderGetResult<KnowledgeUnit>>>> GetKnowledgeUnits(string instanceId, ContextKnowledgeResourceListRequest listRequest, UnifiedUserIdentity userIdentity)

Parameters

instanceId string

The FoundationaLLM instance identifier.

listRequest ContextKnowledgeResourceListRequest

The request containing the information used to filter the knowledge resources.

userIdentity UnifiedUserIdentity

The identity of the security principal submitting the request.

Returns

Task<ContextServiceResponse<IEnumerable<ResourceProviderGetResult<KnowledgeUnit>>>>

QueryKnowledgeSource(string, string, ContextKnowledgeSourceQueryRequest, UnifiedUserIdentity)

Queries a knowledge source.

Task<ContextKnowledgeSourceQueryResponse> QueryKnowledgeSource(string instanceId, string knowledgeSourceId, ContextKnowledgeSourceQueryRequest queryRequest, UnifiedUserIdentity userIdentity)

Parameters

instanceId string

The FoundationaLLM instance identifier.

knowledgeSourceId string

The knowledge source identifier.

queryRequest ContextKnowledgeSourceQueryRequest

The request containing the details of the query.

userIdentity UnifiedUserIdentity

The identity of the security principal submitting the request.

Returns

Task<ContextKnowledgeSourceQueryResponse>

RenderKnowledgeUnitGraph(string, string, ContextKnowledgeSourceQueryRequest?, UnifiedUserIdentity)

Retrieves the knowledge unit's knowledge graph in a format suitable for visualization or further processing.

Task<ContextKnowledgeUnitRenderGraphResponse> RenderKnowledgeUnitGraph(string instanceId, string knowledgeUnitId, ContextKnowledgeSourceQueryRequest? queryRequest, UnifiedUserIdentity userIdentity)

Parameters

instanceId string

The FoundationaLLM instance identifier.

knowledgeUnitId string

The knowledge unit identifier.

queryRequest ContextKnowledgeSourceQueryRequest

The request containing the details of the query.

userIdentity UnifiedUserIdentity

The identity of the security principal submitting the request.

Returns

Task<ContextKnowledgeUnitRenderGraphResponse>

SetKnowledgeUnitGraph(string, string, ContextKnowledgeUnitSetGraphRequest, UnifiedUserIdentity)

Sets the knowledge graph associated with a knowledge unit.

Task<ContextServiceResponse<ResourceProviderActionResult>> SetKnowledgeUnitGraph(string instanceId, string knowledgeUnitId, ContextKnowledgeUnitSetGraphRequest setGraphRequest, UnifiedUserIdentity userIdentity)

Parameters

instanceId string

The FoundationaLLM instance identifier.

knowledgeUnitId string

The knowledge unit identifier.

setGraphRequest ContextKnowledgeUnitSetGraphRequest

The request containing the knowledge graph details.

userIdentity UnifiedUserIdentity

The identity of the security principal submitting the request.

Returns

Task<ContextServiceResponse<ResourceProviderActionResult>>

UpsertKnowledgeSource(string, KnowledgeSource, UnifiedUserIdentity)

Creates or updates a knowledge source in the context service.

Task<ContextServiceResponse<ResourceProviderUpsertResult<KnowledgeSource>>> UpsertKnowledgeSource(string instanceId, KnowledgeSource knowledgeSource, UnifiedUserIdentity userIdentity)

Parameters

instanceId string

The FoundationaLLM instance identifier.

knowledgeSource KnowledgeSource

The knowledge source to be created or updated.

userIdentity UnifiedUserIdentity

The identity of the security principal submitting the request.

Returns

Task<ContextServiceResponse<ResourceProviderUpsertResult<KnowledgeSource>>>

UpsertKnowledgeUnit(string, KnowledgeUnit, UnifiedUserIdentity)

Creates or updates a knowledge unit in the context service.

Task<ContextServiceResponse<ResourceProviderUpsertResult<KnowledgeUnit>>> UpsertKnowledgeUnit(string instanceId, KnowledgeUnit knowledgeUnit, UnifiedUserIdentity userIdentity)

Parameters

instanceId string

The FoundationaLLM instance identifier.

knowledgeUnit KnowledgeUnit

The knowledge unit to be created or updated.

userIdentity UnifiedUserIdentity

The identity of the security principal submitting the request.

Returns

Task<ContextServiceResponse<ResourceProviderUpsertResult<KnowledgeUnit>>>