docs(GEN-2755,GEN-2604): agent-core flat API + look field - #8
Open
mavxdegods wants to merge 4 commits into
Open
mavxdegods wants to merge 4 commits into
mavxdegods wants to merge 4 commits into
Conversation
Resyncs every docs surface with the flat AgentCorePatch schema shipped in agent-core PR #6. The previous docs described a multi-section schema (identity/overview/inspiration/accounts/look) that diverged from how the GEN Setup canvas FE actually saves data. This commit brings OpenAPI, llms.txt, llms-full.txt, and the agent-core reference page in sync. Changes: - openapi.yaml: flatten AgentCore + AgentCorePatch schemas. Add MonitoredItem, LinkedAccount, VoiceRef component schemas. Delete dead per-item endpoints (/core/inspiration, /core/accounts, /core/look/reference-images, /core/identity/profile-photo) and their schemas (InspirationItem, AccountItem, BrandOverview). Document the three-upstream fan-out in the PATCH description. - reference/agent-core.mdx: complete rewrite with flat field list, full storage map table, two critical distinctions (linked_accounts vs monitored, description vs personality), updated curl + TypeScript examples, per-target 207 response format. - llms.txt: rewrite Step 1 quick-start with the flat PATCH payload. Replace the per-section endpoint list with field-level docs including linked_accounts vs monitored distinction and the keyword auto-mirror behavior. - llms-full.txt: complete rewrite of the Agent Core API section with storage map table, flat GET/PATCH examples, field-level semantics, and validation guardrails (422 on unknown fields, description 500-char cap, personality 20000-char cap, strict enums on identity_type and monitored[].item_type). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…ocs + add research_topics field Security: removed staging-api.gen.pro URLs, EC2/port references, internal storage map (trendpulse_configs, project_nodes), internal routing details, Dynamic XYZ auth provider name, and Remotion Lambda reference from all public-facing surfaces (docs, llms.txt, llms-full.txt, openapi.yaml). Also: added research_topics field to Agent Core docs, improved API key onboarding on overview page, and cleaned up response examples. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Added look, content_themes, persona_inspirations, timezone, eleven_lab_api_key to GET response example and PATCH field semantics table - Added validation guardrails for new fields (look 2000 chars, timezone 100 chars, eleven_lab_api_key 100 chars, goal 100 chars) - Fixed response description: removed incorrect 207 Multi-Status language; agent-core always returns flat 200 (Rails failures are logged, not surfaced) - Fixed errors table: removed 207 entry, added 403 (wrong agent owner) - Fixed TypeScript SDK example: gen.agents.updateCore() → gen.updateAgentCore() - Updated llms.txt PATCH example with new fields and corrected response shape Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Add `look` to GET /core response example - Add `look` to the scalars-replace list in PATCH semantics - Add `look` max 2000 chars validation rule - Add `look` to PATCH curl example Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
research_topicsfield documentationlookfield to all surfaces:agent-core.mdx,llms-full.txt, MCP tool descriptionsChanges
src/content/docs/reference/agent-core.mdx— full rewrite for flat/coreendpointpublic/llms-full.txt— GET response, PATCH semantics, validation, and PATCH example all includelookPublic Surface Security
Verified: no staging URLs, no EC2/port references, no internal table names, no Jira ticket IDs.
🤖 Generated with Claude Code