Contextual AIInstall

Overview

The node "Contextual AI" provides access to various Contextual AI tools, including managing agents, parsing, querying, and reranking. Specifically, the "List Agents" operation retrieves a list of agents from the Contextual AI service. This is useful when you want to programmatically fetch and manage multiple AI agents configured in your Contextual AI environment.

Common scenarios include:

• Displaying or processing a paginated list of AI agents.
• Integrating agent data into workflows for monitoring or reporting.
• Automating management tasks that require knowledge of existing agents.

Example: You might use this node to retrieve up to 50 agents at a time, then process each agent's details in subsequent workflow steps.

Properties

Output

The node outputs an array of JSON objects representing agents retrieved from the Contextual AI service. Each object corresponds to an individual agent with its associated properties as returned by the API.

If pagination is used, the output may include metadata such as a cursor for fetching the next set of results.

No binary data output is indicated.

Dependencies

• Requires an API key credential for authenticating requests to the Contextual AI service.
• The node depends on the external Contextual AI API endpoint to list agents.
• Proper configuration of the API key credential within n8n is necessary.

Troubleshooting

• Empty results: Ensure the "Limit" property is set correctly and that there are agents available in the Contextual AI account.
• Invalid cursor: Using an expired or incorrect cursor value may result in errors or empty responses. Reset the cursor or start a new listing.
• Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
• Network issues: Check connectivity to the Contextual AI API endpoint.

Links and References

• Contextual AI official documentation (example placeholder link)
• n8n documentation on creating API key credentials