You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
feat(agentstudio): add conversations commands via official SDK - #288
Adds algolia agentstudio conversations so you can list, get, export, delete, and purge Agent Studio conversations through the official Go SDK.
🤷 Why
#289 shipped the Agents resource. Conversations is the next sibling module under agentstudio (not nested under agents), using the same SDK client.
🔍 How
Section Group
Change
Commands
Register algolia agentstudio conversations with list/get/export/delete/purge calling the matching SDK methods.
Safety
delete and purge require --confirm off TTY. purge also requires --start-date and/or --end-date so the delete is bounded.
list/get/export print JSON. Dates are YYYY-MM-DD. IDs in examples are UUID-shaped. No file reads or writes.
🧪 Testing
Stacked on #289. Merge that first, or check out this branch which includes it.
Reads and deletes need an API key with logs (admin keys skip the CLI ACL check). Replace <APP_ID> and <agent-id> with an Agent Studio app that already has conversations. Agent and conversation IDs are UUIDs. Pass --application-id if the selected profile app does not resolve.
Quick checks
task build
go test ./pkg/cmd/conversations/... ./pkg/cmd/agentstudio ./pkg/cmd/root -count=1
./algolia agentstudio conversations --help
./algolia agentstudio conversations list --help
./algolia agentstudio conversations purge --help
Expect tests green, conversations beside agents under agentstudio, and subcommands list, get, export, delete, purge. purge --help states a date bound is required.
Scenario 1 — list, get, export
Action: list conversations, get one, export a date range.
🤔 What
Adds
algolia agentstudio conversationsso you can list, get, export, delete, and purge Agent Studio conversations through the official Go SDK.🤷 Why
#289 shipped the Agents resource. Conversations is the next sibling module under
agentstudio(not nested underagents), using the same SDK client.🔍 How
algolia agentstudio conversationswith list/get/export/delete/purge calling the matching SDK methods.deleteandpurgerequire--confirmoff TTY.purgealso requires--start-dateand/or--end-dateso the delete is bounded.list/get/exportprint JSON. Dates areYYYY-MM-DD. IDs in examples are UUID-shaped. No file reads or writes.🧪 Testing
Stacked on #289. Merge that first, or check out this branch which includes it.
Reads and deletes need an API key with
logs(admin keys skip the CLI ACL check). Replace<APP_ID>and<agent-id>with an Agent Studio app that already has conversations. Agent and conversation IDs are UUIDs. Pass--application-idif the selected profile app does not resolve.Quick checks
task build go test ./pkg/cmd/conversations/... ./pkg/cmd/agentstudio ./pkg/cmd/root -count=1 ./algolia agentstudio conversations --help ./algolia agentstudio conversations list --help ./algolia agentstudio conversations purge --helpExpect tests green,
conversationsbesideagentsunderagentstudio, and subcommandslist,get,export,delete,purge.purge --helpstates a date bound is required.Scenario 1 — list, get, export
Action: list conversations, get one, export a date range.
Expectation:
listreturnsdata[]andpagination.getreturns that conversation with amessagesarray.exportprints a JSON array of full conversations.Scenario 2 — delete confirmation (failure mode)
Action: delete without
--confirmin a non-TTY, then with--confirm.