Straico Official icon

Straico Official

Get data from Straico API

Actions14

Overview

The node integrates with the Straico API to manage and update "Agent" resources. Specifically, the Update Agent operation allows users to modify details of an existing agent by providing its ID along with updated properties such as name, custom prompt, default language model, description, and tags.

This node is useful in scenarios where you need to programmatically maintain or adjust AI agents' configurations within Straico, for example:

  • Updating an agent's prompt or description based on new requirements.
  • Changing the default language model used by the agent.
  • Managing metadata tags for better organization or filtering of agents.

Practical example: You have an AI assistant configured as an agent, and after gathering user feedback, you want to update its prompt and description to improve responses without manually editing it in the Straico dashboard.

Properties

Name Meaning
Agent ID The unique identifier of the agent to update (e.g., "agent_123456789").
Name The new or updated name of the agent.
Custom Prompt A custom prompt string that defines how the agent should respond or behave.
Default LLM The default language model identifier to be used by the agent.
Description A textual description explaining the purpose or details of the agent.
Tags JSON array of tags (strings) for categorizing or labeling the agent, e.g., ["assistant","rag"].

Output

The output is a JSON object representing the response from the Straico API after updating the agent. It typically contains the updated agent details or confirmation of the update operation.

Example structure (simplified):

{
  "id": "agent_123456789",
  "name": "Updated Agent Name",
  "custom_prompt": "New prompt text",
  "default_llm": "model_identifier",
  "description": "Updated description",
  "tags": ["assistant", "rag"],
  ...
}

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Straico API.
  • Needs an API authentication token or API key credential configured in n8n under the generic "an API key credential" for Straico.
  • The node sends HTTP PUT requests to the Straico API endpoint for agents.

Troubleshooting

  • Error: No binary data property found — Not applicable for this operation since it does not handle binary data.
  • Invalid JSON in Tags — The "Tags" property expects a valid JSON array string. Ensure the input is correctly formatted, e.g., ["assistant","rag"].
  • API Authentication Errors — Make sure the API key credential is correctly set up and has permissions to update agents.
  • Agent Not Found — If the provided Agent ID does not exist, the API will return an error. Verify the Agent ID is correct.
  • Malformed Request — Ensure all required fields (Agent ID, Name, Custom Prompt, Default LLM, Description) are provided and valid.

Links and References

Discussion