multi-agent WIP

Signed-off-by: Grant Linville <[email protected]>

Author: g-linville

docs/docs/02-examples/06-multi-agent.md

@@ -0,0 +1,97 @@
+# Multi-Agent Chat
+
+In this example, we will create a tool that combines the [CLI Guide](./01-cli.md) and [API Guide](./02-api.md).
+This tool will be an agent with the ability to hand control over to two other agents:
+one with access to the `gh` CLI for GitHub, and one with access to the DigitalOcean API.
+
+:::warning
+This script **does not install** or configure `gh`. We assume you've done that already.
+You must be logged in via `gh auth login`. [See here for more details](https://docs.github.com/en/github-cli/github-cli/quickstart)
+:::
+
+## Creating the Main Agent
+
+First, create the main agent in a new file called `agent.gpt`:
+
+```
+Chat: true
+Agents: gh-agent.gpt, digitalocean-agent.gpt
+Context: github.com/gptscript-ai/context/multi-agent
+
+You are a helpful assistant designed to assist the user with GitHub and DigitalOcean.
+Start by asking the user what they would like to do.
+```
+
+This tool is a chatbot that can hand control over to two other agents: `gh-agent` and `digitalocean-agent`.
+The multi-agent context tool provides some additional information to the agent about how it can use the other agents available to it.
+
+## Creating the GitHub Agent
+
+Next, create the GitHub agent in a new file called `gh-agent.gpt`:
+
+```
+Name: GitHub Agent
+Description: An agent with access to the GitHub CLI
+Chat: true
+Context: github.com/gptscript-ai/context/cli
+Context: learn-gh
+Param: request: the task that the user requested
+
+You have the gh CLI for GitHub available to you. Use it to accomplish the requested task.
+
+---
+Name: learn-gh
+
+#!/usr/bin/env bash
+
+echo "The following is the help text for the gh cli and some of its sub-commands. Use these when figuring out how to construct new commands. Note that the --search flag is used for filtering and sorting as well; there is no dedicated --sort flag."
+gh --help
+gh repo --help
+gh issue --help
+gh issue list --help
+gh issue create --help
+gh issue comment --help
+gh issue delete --help
+gh issue edit --help
+gh pr --help
+gh pr create --help
+gh pr checkout --help
+gh release --help
+gh release create --help
+```
+
+This tool is largely the same as the one in the [CLI Guide](./01-cli.md), but with the addition of a `request` parameter that specifies the task the user requested.
+This allows the main agent to provide additional information to the GitHub agent when handing control to it.
+We also added a name and a description to this agent, so that the main agent better understands what to do with the GitHub agent.
+
+
+## Creating the DigitalOcean Agent
+
+Next, create the DigitalOcean agent in a new file called `digitalocean-agent.gpt`:
+
+```
+Name: DigitalOcean Agent
+Description: An agent with access to the DigitalOcean API to manage droplets and databases
+Chat: true
+Tools: droplets* from openapi.yaml
+Tools: databases* from openapi.yaml
+Tools: images* from openapi.yaml
+Tools: regions_list from openapi.yaml
+Tools: tags* from openapi.yaml
+Tools: sizes_list from openapi.yaml
+Tools: sshKeys_list from openapi.yaml
+Tools: sys.time.now
+Param: request: the task that the user requested
+
+You are a helpful assistant with access to the DigitalOcean API to manage droplets and databases.
+Before creating, updating, or deleting anything, tell the user about the exact action you are going to take, and get their confirmation.
+Accomplish the requested task using the DigitalOcean API.
+```
+
+This tool is largely the same as the one in the [API Guide](./02-api.md), but once again with an added `request` parameter and a name and description.
+
+Make sure you also have a copy of the openapi.yaml file for DigitalOcean. Instructions for this are [here](./02-api.md#getting-started).
+
+## Running the Multi-Agent Chat
+
+