AgentForce ADK Awesome- The Agent Development Kit Examples

Awesome AgentForce ADK Examples - try the agentic typescript library

Quick Start • Basic Agents • Skill Agents • Tool Agents

visit also the

The AgentForceZone Documentation Page

We are in Beta!

This project is in early development and is not yet production-ready. It is intended for testing and experimentation only. Use at your own risk.

Current Version: 0.10.2

Overview

This repository contains examples of how to use the AgentForce ADK (Agent Development Kit) to create and manage AI agents in TypeScript. The examples demonstrate various features of the ADK, including agent creation, configuration, and interaction.

Quick Start

1. Clone the repository:

   git clone https://github.com/agentforcezone/agentforce-adk-awesome.git
   cd agentforce-adk-awesome

2. Install dependencies:

   bun i

3. Initialize skills (optional):

   Copy the default Agentforce skills to your local project:

   bun init-skills

   This will copy the skills from node_modules/@agentforce/adk/lib/_assets/skills to ./skills directory.

4. Run the minimal agent example:

   All examples can be executed using the bun script commands. For example, to run the minimal agent example, use:

   bun minimal-agent

Env File Setup

To run the examples, you need to set up your environment variables. Create a .env file in the root directory of the project from the env.example file.

and add your API keys and configuration settings. For example:

.env

# This will help you control the verbosity of logs.
LOG_LEVEL=DEBUG

# Replace the placeholder with your actual API key.
OPENROUTER_API_KEY=sk-or-v1-your-api-key

# ASSETS: Skills, Prompts, Templates, etc. for the agent (optional)
AGENT_ASSETS_PATH=assets/

Basic Agents

Minimal Agent: A simple agent that demonstrates basic AgentForce ADK functionality and installation verification.

bun minimal-agent

Basic Agent: An agent that showcases how to create and configure an agent with a system prompt and user prompt using the default Ollama provider.

bun basic-agent

OpenRouter Agent: An agent that uses the OpenRouter API to generate pirate-themed responses, demonstrating external API integration.

bun openrouter-agent

File Agent: An agent that generates API documentation and saves it to a file, showcasing file output capabilities.

bun file-agent

Skill Agents

Product Owner Agent: An agent that demonstrates skill-based functionality using the Product Owner skill set for Agile environments.

bun product-owner-agent

Tool Agents

Simple Tool Agent: A basic file management assistant that demonstrates tool usage with file system operations.

bun simple-tool-agent

OS Tool Agent: An agent that executes system commands (like 'ls -la') and formats the output as JSON, demonstrating OS interaction capabilities.

bun os-tool-agent

OpenRouter Tool Use Agent: A sophisticated agent that uses OpenRouter with tool calling capabilities to create file structures and ASCII trees.

bun openrouter-tool-use-agent

Browser Use Agent: An agent that automates web browsing tasks, searches for AI news on Google, and creates markdown summaries with structured output.

bun browser-use-agent