Corral
Learn > Documentation

Agent Tools

Tools extend what your agents can do beyond conversation, enabling them to search, calculate, and interact with external systems.

Built-in Tools

ToolDescription
Knowledge SearchSearch uploaded documents
Web SearchSearch the internet (configurable)
CalculatorPerform calculations
Code InterpreterExecute Python code

Custom Tools

Create custom tools to integrate with your systems:

{
  name: "get_order_status",
  description: "Get the status of a customer order",
  parameters: {
    type: "object",
    properties: {
      order_id: {
        type: "string",
        description: "The order ID to look up"
      }
    },
    required: ["order_id"]
  }
}

Tool Security

Tools respect your security boundaries:

  • API Keys: Stored securely in Azure Key Vault
  • Permissions: Tools can only access authorized resources
  • Audit Logging: All tool usage is logged

Best Practices

  1. Be Specific: Clear tool descriptions help the AI use them correctly
  2. Limit Scope: Only expose necessary capabilities
  3. Handle Errors: Tools should return helpful error messages

Next Steps