Agents

Documentation Index

Fetch the complete documentation index at: https://docs.gurubase.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

• orchestrate multiple tools and actions
• make autonomous decisions about which tools to use
• chain tool calls together for complex workflows
• handle nested agent calls (agents calling other agents)
• process structured or free-form responses

​

How Agents Work

1. When to Trigger This Agent: The Guru checks if the user’s question matches your defined conditions
2. Tool Selection: The agent selects from its available tools (actions or other agents) based on the task
3. Execution: The agent makes autonomous decisions about which tools to call and in what order
4. Nested Execution: Agents can call other agents, creating nested execution chains
5. Response Handling: The Usage Instructions guide the AI on how to interpret and present the agent’s response

​

Creating an Agent

1. Basic Information
2. Tool Selection
3. Agent Configuration
4. Usage Instructions, Scheduling, and Testing

​

Basic Information

• Agent Name: Provide a descriptive name that appears in your agents list (e.g., “Address manager”)
• When to Trigger This Agent: Be specific about keywords, patterns, or user intents to ensure it only runs when appropriate
  • Example: “When the user wants to do any operation regarding their address or wants to guess the secret”

​

Agent Configuration

• System Prompt: Required instructions that define the agent’s behavior and capabilities
  • Example: “You are an assistant that manages addresses. You can either get or update addresses. You are also used for guessing the secret”
• Output Schema (Optional): JSON schema for structured output. Leave empty for free-form responses
  • Example:
  {
    "message": "string",
    "reasoning": "string"
  }
  
• Max Tool Calls: Maximum number of tool calls per execution (1-100)
  • Limits how many tools the agent can call in a single execution
  • Default: 10
• Max Depth: Maximum nesting depth for agent calls (1-10)
  • Controls how deeply agents can call other agents
  • Default: 5
  • Prevents infinite recursion in nested agent scenarios

​

Tool Selection

• Actions: Python Code and API Call actions you’ve created
• Other Agents: Other agents in your Guru (enabling nested agent calls)

• Use the search bar to filter available tools
• Selected tools appear as tags that can be removed individually
• Use “Clear all” to deselect all tools
• The agent will intelligently choose which tools to use based on the user’s question

​

Usage Instructions and Testing

• Usage Instructions: Provide instructions for how the AI should interpret and present the agent’s response to users
  • Example: “Extract the message and reasoning from the JSON response and present them in a clear format”

• Use the “Test Agent” button to verify your configuration
  • Tools will be mocked (not actually executed) during testing
  • Test results show the agent’s decision-making process and tool selection

​

Scheduling

• Enable scheduling using the toggle switch
• Configure the execution schedule using a cron expression in standard format: minute hour day month weekday
  • Example: 0 9 * * * runs daily at 9 AM
  • Example: */5 * * * * runs every 5 minutes
• Scheduled agents display their cron expression in the agents list

​

Managing Agents

• View all configured agents with their name, number of tools, status (Enabled/Disabled), and schedule (cron expression if scheduled)
• Click the menu icon (⋮) next to any agent to:
  • Edit: Modify the agent’s configuration
  • Disable: Temporarily disable without deleting
  • Delete: Permanently remove the agent
• Click “View Code” to see integration code samples for the agent
• Enable or disable agents at any time
• Disabled agents won’t be triggered by user questions
• Note: If a tool (action or agent) used by an agent is deleted, that agent will be automatically disabled

​

Agent History

• Status: Execution outcome (Completed or Failed)
• Action Name: Name of the executed agent
• Type: Always “Agent” for agent executions
• Source: How the agent was triggered (Api, Scheduled, Test, etc.)
• Started At: Date and time when execution began
• Duration: Execution time in seconds
• Test: Whether the execution was a test run

• Top-level agent execution
• Indented tool calls showing which tools were called
• Further indentation for nested agent calls
• Each level shows its own status, duration, and type

• Execution Info: Unique execution ID, status, depth, agent name, source, and test flag
• Timing: Start time, duration, and completion time
• Input Data: Parameters and values used during execution (collapsible)
• Output Data: Agent’s response data (collapsible)
• Tool Calls: List of all tool calls made during execution (collapsible)
• Nested Executions: Immediate childrens of the agent (collapsible)

​

Integration

from openai import OpenAI

client = OpenAI(
    api_key="<api_key>",
    base_url="<base_url>"
)

response = client.chat.completions.create(
    model="gurubase/dd99f96a-9220-48c9-8abe-941e250dbb30",
    messages=[
        {"role": "user", "content": "Sample usage"}
    ],
    user="user_id"  # For memory tracking
)

​

Common Mistakes to Avoid

​

Next Steps