docs(profiles): correct response example and regenerate cadence from live API
Live e2e against the feature neuron: the profile envelope has no generation_count, and the regenerate cooldown is once per day (86400s), not hourly. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.8
parent
ac2c5cbfbf
commit
b852f9240c
@@ -137,8 +137,7 @@ A response looks like this:
|
|||||||
"status": "succeeded",
|
"status": "succeeded",
|
||||||
"entity_type": "user",
|
"entity_type": "user",
|
||||||
"entity_id": "alice",
|
"entity_id": "alice",
|
||||||
"updated_at": "2026-02-08T10:30:00Z",
|
"updated_at": "2026-02-08T10:30:00Z"
|
||||||
"generation_count": 4
|
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -221,7 +220,7 @@ await client.regenerateProfiles();
|
|||||||
```
|
```
|
||||||
</CodeGroup>
|
</CodeGroup>
|
||||||
|
|
||||||
This returns immediately and runs in the background; a large project takes a while. It is limited to one run per project per hour, so sample first and regenerate once you are satisfied.
|
This returns immediately and runs in the background; a large project takes a while. It is limited to one run per project per day, so sample first and regenerate once you are satisfied.
|
||||||
|
|
||||||
## When profiles update
|
## When profiles update
|
||||||
|
|
||||||
@@ -306,7 +305,7 @@ Generation is asynchronous and needs enough to work with. Branch on `status`: `p
|
|||||||
No. `sample_profiles` runs real generations against real memories and **keeps** the profiles it produces, so it counts toward your usage like any other generation. It exists to check a schema on a few entities before you commit to it — not as a zero-cost dry run.
|
No. `sample_profiles` runs real generations against real memories and **keeps** the profiles it produces, so it counts toward your usage like any other generation. It exists to check a schema on a few entities before you commit to it — not as a zero-cost dry run.
|
||||||
|
|
||||||
**Does changing the schema rewrite existing profiles?**
|
**Does changing the schema rewrite existing profiles?**
|
||||||
No. A schema change applies to future generations. To apply a new schema to entities that already have a profile, call `regenerate_profiles` (rate-limited to once per project per hour).
|
No. A schema change applies to future generations. To apply a new schema to entities that already have a profile, call `regenerate_profiles` (rate-limited to once per project per day).
|
||||||
|
|
||||||
**What happens to a field I remove from the schema?**
|
**What happens to a field I remove from the schema?**
|
||||||
It stops being maintained. On an entity's next generation, fields your schema no longer defines are pruned from the stored profile — so keep a field in the schema for as long as you want its value kept.
|
It stops being maintained. On an entity's next generation, fields your schema no longer defines are pruned from the stored profile — so keep a field in the schema for as long as you want its value kept.
|
||||||
|
|||||||
Reference in New Issue
Block a user