wip(documentation): Notes on agents

Signed-off-by: Diwank Singh Tomer <[email protected]>

documentation/docs/advanced/agentic-patterns.mdx

@@ -4,6 +4,7 @@ description: 'Learn about common patterns and best practices for building Julep
 icon: 'sitemap'
 ---
 
+> Need to implement the [agentic patterns](https://www.anthropic.com/research/building-effective-agents)
 
 Coming soon...
 

documentation/docs/concepts/agents.mdx

@@ -4,7 +4,126 @@ description: 'Understanding Julep Agents and their capabilities'
 icon: 'lightbulb'
 ---
 
+## Overview
 
-Learn about Julep Agents and how they power your AI applications.
+Agents in Julep are:
+- simple stateful entities
+- the main components of your AI applications
+- they have access to [tools](/docs/concepts/tools), [sessions](/docs/concepts/sessions) and [multi-step tasks](/docs/concepts/tasks)
+- you can associate [docs](/docs/concepts/docs) (for retrieval) and [files](/docs/concepts/files) (for storage) with an agent
+- you can create [tasks](/docs/concepts/tasks) and start executing them
+- you can add one or more agents to a [session](/docs/concepts/sessions) and chat with them (enabling multi-agent conversations)
 
-[Placeholder content] 
+## Agent Configuration Options
+
+When creating an agent, you can specify several configuration options:
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `name` | string | The name of your agent |
+| `model` | string | The language model to use (e.g., "claude-3.5-sonnet", "gpt-4") |
+| `about` | string | A description of your agent's purpose and capabilities |
+| `instructions` | string \| array | Instructions for the agent to follow |
+| `metadata` | object | Additional metadata for your agent |
+| `tools` | array | List of tools the agent can use |
+
+> You can find supported models [here](/docs/concepts/models)
+> You can find supported tools [here](/docs/concepts/tools)
+
+```mermaid
+graph LR
+    Agent((Agent)) --> Tools[Tools]
+    Agent --> Sessions[Sessions]
+    Agent --> Tasks[Tasks]
+    Agent --> Docs[Docs]
+    Agent --> Files[Files]
+    
+    style Agent fill:#f9f,stroke:#333,stroke-width:4px
+    style Tools fill:#dfd,stroke:#333
+    style Sessions fill:#dfd,stroke:#333  
+    style Tasks fill:#dfd,stroke:#333
+    style Docs fill:#dfd,stroke:#333
+    style Files fill:#dfd,stroke:#333
+
+```
+
+## Anatomy of an Agent
+
+
+This is what an agent looks like. You can create an agent using either the Python or Node.js SDK:
+
+<CodeGroup>
+    ```yaml YAML
+    name: "My Agent"
+    model: "claude-3.5-sonnet"
+    about: "A helpful AI assistant that specializes in data analysis"
+    instructions: "You are a helpful AI assistant that specializes in data analysis"
+    metadata:
+      type: "data-analysis"
+    tools:
+      - name: "calculate_total"
+        description: "Calculate the total of a list of numbers"
+        function:
+          parameters:
+            type: "object"
+            properties:
+              numbers:
+                type: "array"
+                items:
+                  type: "number"
+    ```
+
+    ```python Python
+    from julep import Julep
+
+    client = Julep(api_key="your_api_key")
+
+    agent = client.agents.create(
+        name="My Agent",
+        model="claude-3.5-sonnet",
+        about="A helpful AI assistant that specializes in data analysis",
+        instructions="You are a helpful AI assistant that specializes in data analysis",
+        metadata={"type": "data-analysis"},
+        tools=[
+            {
+                "name": "calculate_total",
+                "description": "Calculate the total of a list of numbers",
+                "function": {
+                    "parameters": {"type": "object", "properties": {"numbers": {"type": "array", "items": {"type": "number"}}}}
+                }
+            }
+        ]
+    )
+    ```
+
+    ```javascript JavaScript
+    import { Julep } from '@julep/sdk';
+
+    const client = new Julep({ apiKey: 'your_api_key' });
+
+    const agent = await client.agents.create({
+        name: "My Agent",
+        model: "claude-3.5-sonnet",
+        about: "A helpful AI assistant that specializes in data analysis",
+        instructions: "You are a helpful AI assistant that specializes in data analysis",
+        metadata: {"type": "data-analysis"},
+        tools: [
+            {
+                "name": "calculate_total",
+                "description": "Calculate the total of a list of numbers",
+                "function": {
+                    "parameters": {"type": "object", "properties": {"numbers": {"type": "array", "items": {"type": "number"}}}}
+                }
+            }
+        ]
+    });
+    ```
+</CodeGroup>
+
+## What's Next?
+
+- [Creating an Agent](/docs/building-blocks/agents/creating-agents)
+- [Agent Tools](/docs/building-blocks/agents/agent-tools)
+- [Agent Tasks](/docs/building-blocks/agents/agent-tasks)
+- [Agent Sessions](/docs/building-blocks/agents/agent-sessions)
+- [Agent Docs](/docs/building-blocks/agents/agent-docs)

documentation/docs/introduction/try_it_out.mdx

@@ -6,6 +6,29 @@ icon: 'laptop'
 
 This guide will help you get started with Julep in just 5 minutes. You'll learn how to create your first AI agent and execute a simple task.
 
+### What we'll build
+
+We'll build a simple agent that uses tasks to write a short story.
+
+
+```yaml Agent
+name: Story Generator
+model: claude-3.5-sonnet
+about: A helpful AI assistant that specializes in writing and editing.
+```
+
+```yaml Task
+name: Write a short story
+description: Write a short story about a magical garden
+main:
+- prompt:
+  - role: system
+    content: You are a creative story writer.
+  - role: user
+    content: Write a short story about {{inputs[0].topic}}
+```
+
+
 ### Prerequisites
 
 - Python 3.8+ or Node.js 16+