docs(algobot-cli): correct auth commands and document EU-only prod host - #35
Open
itsdanwilli wants to merge 1 commit into
Open
docs(algobot-cli): correct auth commands and document EU-only prod host#35itsdanwilli wants to merge 1 commit into
itsdanwilli wants to merge 1 commit into
Conversation
Two corrections found while using the skill to add a tool to a live agent. The prod host is EU-only. v2.0.0 hardcodes agent-studio.eu.algolia.com (prod), agent-studio-staging.eu.algolia.com (staging) and conversational-ai-dev.algolia.com (dev), with no region flag and no environment variable that overrides the host. For an app whose agents are not in EU, this surfaces as `agents list` returning `[]` and `agents get <id>` returning 404 for an agent that is live and serving completions — which reads as a credential problem rather than a region one. An admin API key makes no difference. The note points at `--verbose` so the host can be confirmed first. The auth guidance was stale. `algobot auth show` was removed in v2.0 and now prints a deprecation notice; credentials live in `~/.algobot-profiles`, not `~/.algobot-cookie`. The replacement is `profiles list` / `profiles show`, and `profiles show` prints the API key in plaintext, which is worth warning about. Verified against algobot-ai 2.0.0. `scripts/validate_skills.py` passes, 129/0. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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
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.
Two documentation corrections to
algobot-cli, both hit while using the skill to add a search tool to a live Agent Studio agent.1.
prodresolves to the EU hostv2.0.0 hardcodes three API hosts:
agent-studio.eu.algolia.comagent-studio-staging.eu.algolia.comconversational-ai-dev.algolia.comThere is no region flag, and the only environment variables the CLI reads are
ALGOLIA_APP_ID,ALGOLIA_APPLICATION_ID,ALGOLIA_API_KEYandALGOLIA_AGENT_ID— none override the host.For an app whose agents are not in EU, this surfaces as:
…for an agent that is live and serving completions. An empty array reads as "this app has no agents", so the natural next step is to go looking for a credential problem. Swapping in an admin API key changes nothing. The added note points at
algobot --verbose agents listso the host can be confirmed first.The skill currently documents
--env dev|staging|prod|localas the environment control, which reasonably reads as covering this.2. The auth guidance is stale
algobot auth showwas removed in v2.0 and now prints a deprecation notice:Credentials also live in
~/.algobot-profiles, not~/.algobot-cookie. Updated both the Gotchas entry andreferences/commands.mdtoprofiles list/profiles show, and noted thatprofiles showprints the API key in plaintext — easy to leak into a screenshare or a log.Notes
algobot-ai2.0.0.scripts/validate_skills.pypasses, 129/0.