fix(algobot-cli): doc corrections#17
Open
maximenathan wants to merge 3 commits intomainfrom
Open
Conversation
Verified against algobot 2.0.0 (latest): both 'agents patch --help' and 'providers patch --help' show '--json <file>'. There is no --file option.
Show the current 'algolia_search_index' tool shape: tools[].name +
tools[].indices array of {index, description}. Replaces the
placeholder 'tools: [...]' and the stale top-level 'indexName' field.
Top-level 'indexName' is silently stripped by the API on submit and
does not appear on the stored agent — verified by POSTing a config
with both root-level indexName and the new tool shape, then reading
back via 'agents get'.
Two failure modes that look like 'agent not found' but aren't:
1. The completions URL has no '/agent-studio' path prefix. With the
wrong path, the API returns 404 {detail: 'Not Found'} — identical
to a missing-agent error. The compatibilityMode query param is
also required (omitting it returns 422 ValidationError). Verified
against the running prod endpoint.
2. 'agents create --provider <name>' does not actually link the
provider to the agent. The agent stays draft with providerId:null
and 'agents publish' 409s with 'Cannot publish without a model or
provider.' Workaround verified: 'agents patch <id> --json'
with {providerId: <uuid>} between create and publish.
maximenathan
changed the title
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
1 participant
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.
What does this skill do?
Three documentation corrections to the existing
algobot-cliskill. no new skill, no behavior change. Verified againstalgobot@2.0.0(latest published on npm) and the running production Agent Studio API.What's wrong today
references/commands.mdagents patch/providers patchflag is--json, not--file.references/config-as-code.mdagent-config.jsonexample was stale: uses a top-levelindexName(silently stripped on submit) and a placeholdertools: [...]. New shape: each tool needsname+indices: [{index, description}]foralgolia_search_index.SKILL.md(Gotchas)/agent-studioprefix and requirescompatibilityMode;agents create --provider <name>doesn't actually link the provider; needs anagents patch --json '{providerId: <uuid>}'step between create and publish.Checklist
Skill description is under 1024 chars and includes WHEN and WHEN NOT to trigger— N/A, no description change`evals/evals.json` exists with at least 1 realistic prompt— N/A, docs-onlyRegistered in `.claude-plugin/marketplace.json` (new skills only)— N/A, existing skill