nemo_microservices.types.intake.entry

Module Contents

Classes

Entry

Data

Event

API

class nemo_microservices.types.intake.entry.Entry(/, **data: typing.Any)

Bases: nemo_microservices._models.BaseModel

context: nemo_microservices.types.intake.entry_context.EntryContext

None

Contextual metadata attached to every entry record.

Keeping these grouped in a dedicated object avoids polluting the top-level namespace and makes it trivial to extend without breaking compatibility.

created_at: Optional[datetime.datetime]

None

Timestamp for when the entity was created.

custom_fields: Optional[Dict[str, object]]

None

A set of custom fields that the user can define and use for various purposes.

data: nemo_microservices.types.intake.entry_data.EntryData

None

Entry data containing the request and response for an LLM interaction.

description: Optional[str]

None

The description of the entity.

events: Optional[List[nemo_microservices.types.intake.entry.Event]]

None

All events associated with this entry.

external_id: Optional[str]

None

Optional client-provided identifier (e.g., completion_id from an LLM provider like OpenAI or NIM). Must be globally unique if provided—attempting to create an entry with a duplicate external_id will fail with a 409 error. If your service provides unique IDs (like ‘chatcmpl-abc123’), you should use them here for easier lookups. Entries can be retrieved using external_id via the prefix syntax: GET /entries/external:chatcmpl-abc123

id: Optional[str]

None

The ID of the entity.

With the exception of namespaces, this is always a semantically-prefixed base58-encoded uuid4 [-base58(uuid4())].

namespace: Optional[str]

None

The namespace of the entity.

This can be missing for namespace entities or in deployments that don’t use namespaces.

ownership: Optional[nemo_microservices.types.shared.ownership.Ownership]

None

Information about ownership of an entity.

If the entity is a namespace, the access_policies will typically apply to all entities inside the namespace.

project: Optional[str]

None

The URN of the project associated with this entity.

schema_version: Optional[str]

None

The version of the schema for the object. Internal use only.

updated_at: Optional[datetime.datetime]

None

Timestamp for when the entity was last updated.

user_rating: Optional[nemo_microservices.types.intake.user_rating.UserRating]

None

User’s rating/evaluation of an AI response.

This captures various forms of end-user feedback about a model’s response, including binary thumbs up/down ratings, numeric scores, free-text opinions, suggested rewrites, and structured category ratings.

Either thumb or rating should be provided (they are mutually exclusive), but all fields are optional to accommodate different feedback collection patterns.

nemo_microservices.types.intake.entry.Event: typing_extensions.TypeAlias

None