Skip to content

Agents

Overview

An Agent is the quickest way to get started with Griptape. Agents take in tools and input directly, which the agent uses to add a Prompt Task.

You can access the final output of the Agent by using the output attribute.

Agent Tools

from griptape.structures import Agent
from griptape.tools import CalculatorTool

agent = Agent(input="Calculate the following: {{ args[0] }}", tools=[CalculatorTool()])

agent.run("what's 13^7?")
print("Answer:", agent.output)

[02/27/25 20:27:58] INFO     PromptTask b01ef6f2df44408ab55cc6c9f4e8bc1c        
                             Input: Calculate the following: what's 13^7?       
[02/27/25 20:27:59] INFO     Subtask 55f186e0ce5040f6a8e91f6bd2f75f77           
                             Actions: [                                         
                               {                                                
                                 "tag": "call_EkyljA8FEDA2R8TZktNu8nAs",        
                                 "name": "CalculatorTool",                      
                                 "path": "calculate",                           
                                 "input": {                                     
                                   "values": {                                  
                                     "expression": "13**7"                      
                                   }                                            
                                 }                                              
                               }                                                
                             ]                                                  
                    INFO     Subtask 55f186e0ce5040f6a8e91f6bd2f75f77           
                             Response: 62748517                                 
[02/27/25 20:28:00] INFO     PromptTask b01ef6f2df44408ab55cc6c9f4e8bc1c        
                             Output: The result of \(13^7\) is 62,748,517.      
Answer: The result of \(13^7\) is 62,748,517.

Agent Input

from griptape.structures import Agent

agent = Agent(
    input="Write me a {{ args[0] }} about {{ args[1] }} and {{ args[2] }}",
)

agent.run("Haiku", "Skateboards", "Programming")

[02/27/25 20:27:49] INFO     PromptTask 883015011f22460082f152115126353b        
                             Input: Write me a Haiku about Skateboards and      
                             Programming                                        
[02/27/25 20:27:50] INFO     PromptTask 883015011f22460082f152115126353b        
                             Output: Wheels spin on pavement,                   
                             Code flows like a river's path—                    
                             Balance in both worlds.