Skip to content

fix: replace generic API structure with CLI flag mapping in knowledge output#11

Merged
moekatib merged 1 commit intomainfrom
fix/knowledge-cli-flag-guidance
Mar 24, 2026
Merged

fix: replace generic API structure with CLI flag mapping in knowledge output#11
moekatib merged 1 commit intomainfrom
fix/knowledge-cli-flag-guidance

Conversation

@moekatib
Copy link
Contributor

Summary

  • Replaces the generic {{PATH}}, {{BODY}}, {{QUERY_PARAMS}} placeholders in knowledge output with an explicit CLI PARAMETER MAPPING section
  • Shows agents exactly which flags to use: --path-vars for URL placeholders, --query-params for query parameters, -d for request body
  • Includes a ready-to-use example command template with the actual platform and actionId
  • Warns agents not to pass path/query params in the -d body flag

Test plan

  • Run one --agent actions knowledge gmail <actionId> and verify the output includes the CLI PARAMETER MAPPING section
  • Verify the example command includes the correct platform and actionId
  • Test that an agent can follow the knowledge output to correctly execute an action with path vars and query params on first attempt

Closes #8

🤖 Generated with Claude Code

…ledge output

The knowledge output had generic placeholders ({{PATH}}, {{BODY}},
{{QUERY_PARAMS}}) that didn't tell agents which CLI flags to use.
Agents would stuff everything into -d and get 403 errors.

Now shows explicit flag mapping (--path-vars, --query-params, -d)
with an example command template using the actual platform and actionId.

Closes #8

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@moekatib moekatib merged commit 74ffe11 into main Mar 24, 2026
@moekatib moekatib deleted the fix/knowledge-cli-flag-guidance branch March 24, 2026 18:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Agent fails to use correct CLI flags for path/query params — knowledge output doesn't bridge to CLI usage

1 participant