# xyz.quasigod.lab.letta.agent

> Published by [quasigod.spaces-alpha.bsky.network](https://lexicon.garden/identity/did:plc:7pezv7mb4agwyktraauhl26g)

## Description

A letta agent: model, instructions, and identity. The rkey (TID) is the agent's id in letta.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:7pezv7mb4agwyktraauhl26g/xyz.quasigod.lab.letta.agent)
- [Documentation](https://lexicon.garden/lexicon/did:plc:7pezv7mb4agwyktraauhl26g/xyz.quasigod.lab.letta.agent/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:7pezv7mb4agwyktraauhl26g/xyz.quasigod.lab.letta.agent/examples)

## Definitions

### `xyz.quasigod.lab.letta.agent`

**Type**: `record`

A letta agent persisted in a permissioned space.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `name` | `string` | Yes | Human-readable agent name. |
| `tags` | `array` | No | Free-form tags. |
| `model` | `string` | Yes | Model handle used for this agent's turns. |
| `hidden` | `boolean` | No | Hidden agents are excluded from listings. Expected to be false. |
| `pinned` | `boolean` | No | Pinned agents surface at the top of the agent selector and are the startup-resume preference. Expected to be false. |
| `system` | `string` | Yes | System prompt template. Core memory is injected into it at compile time; the compiled result lives in the compiledPrompt sidecar. |
| `createdAt` | `string` (datetime) | Yes |  |
| `updatedAt` | `string` (datetime) | Yes |  |
| `description` | `string` | No | Short agent description. |
| `modelSettings` | `ref` → `xyz.quasigod.lab.letta.defs#modelSettings` | No | Tunables for this agent's model. |
| `compactionSettings` | `ref` → `xyz.quasigod.lab.letta.defs#compactionSettings` | No | Automatic-compaction behavior for this agent's conversations. Null/absent uses the default. |
| `primaryConversation` | `string` (at-uri) | Yes | The agent's primary conversation (letta's 'default' conversation). Exactly one per agent, created with the agent. |

## Raw Schema

```json
{
  "id": "xyz.quasigod.lab.letta.agent",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "name",
          "system",
          "model",
          "primaryConversation",
          "createdAt",
          "updatedAt"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 256,
            "description": "Human-readable agent name."
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 64
            },
            "description": "Free-form tags."
          },
          "model": {
            "type": "string",
            "maxLength": 256,
            "description": "Model handle used for this agent's turns."
          },
          "hidden": {
            "type": "boolean",
            "description": "Hidden agents are excluded from listings. Expected to be false."
          },
          "pinned": {
            "type": "boolean",
            "description": "Pinned agents surface at the top of the agent selector and are the startup-resume preference. Expected to be false."
          },
          "system": {
            "type": "string",
            "maxLength": 100000,
            "description": "System prompt template. Core memory is injected into it at compile time; the compiled result lives in the compiledPrompt sidecar."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "updatedAt": {
            "type": "string",
            "format": "datetime"
          },
          "description": {
            "type": "string",
            "maxLength": 1024,
            "description": "Short agent description."
          },
          "modelSettings": {
            "ref": "xyz.quasigod.lab.letta.defs#modelSettings",
            "type": "ref",
            "description": "Tunables for this agent's model."
          },
          "compactionSettings": {
            "ref": "xyz.quasigod.lab.letta.defs#compactionSettings",
            "type": "ref",
            "description": "Automatic-compaction behavior for this agent's conversations. Null/absent uses the default."
          },
          "primaryConversation": {
            "type": "string",
            "format": "at-uri",
            "description": "The agent's primary conversation (letta's 'default' conversation). Exactly one per agent, created with the agent."
          }
        }
      },
      "description": "A letta agent persisted in a permissioned space."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "description": "A letta agent: model, instructions, and identity. The rkey (TID) is the agent's id in letta."
}
```