Private Beta
Building, testing, and publishing agents are only available to a limited set of developers at this time.
The following documentation provides an early preview of the SDK, and the specifics are subject to change.
Build your first agent in 5 minutes¶
You can build an agent for Superhuman Go in only a few minutes, without leaving your browser. This quick tutorial walks you through building, deploying, and testing your agent end-to-end.
Before you begin¶
Before you can start coding, there are a few things you need:
- Grammarly Account
-
If you don’t already have one, sign up for a free account here: grammarly.com/signup
Individual accounts only
At the moment, you can only use agents with individual Grammarly accounts. If you have an account on a team plan (Pro or Enterprise), it won’t be compatible. As a workaround, select another email address and create a new Grammarly account on the Free plan.
- Coda account
-
If you don't already have one, sign up for a free account here: coda.io/signup
Ensure the emails match
Please ensure that you use the same email address to sign up for both Coda and Grammarly. The email address is the key being used to link both accounts.
- Grammarly for Chrome
-
Install it from the Chrome web store. Once installed, click on the Grammarly icon in the extension toolbar and enable the option Use Superhuman Go.
Google Chrome only
Although other browsers support Chrome extensions (Arc, Opera, etc), only Google Chrome is supported at this time.
Create the agent¶
Superhuman Go agents are built using Coda Packs. Follow the steps below to create a Coda Pack that will work as an agent.
Visit https://pack.new to open the Pack Studio web editor and create a new Pack. Select the option Start with an empty Pack. The Pack Studio is an online IDE for building and managing Packs. It's also possible to build them locally and upload them with the Packs CLI.
Delete all of the original code and replace it with the code shown. This code:
import * as coda from "@codahq/packs-sdk";
export const pack = coda.newPack();
pack.addSkill({
name: "SecretPassword",
displayName: "Secret password",
description: "Tell the secret password.",
prompt: `
When the user asks for the secret password,
tell them it's "foobar".
`,
tools: [],
});
Click the Build button to compile and upload the Pack. Building the Pack creates a new version, which acts as a checkpoint for your code.
When prompted to Create a test doc, dismiss the dialog with the X icon in the upper right. It can be useful to test your agent's tools in a Coda doc, where you can more precisely control the inputs and view the outputs, but this agent doesn't have any tools.
Click on the name of the Pack in the upper left, and rename it to "Secret". The Listing and Agent Listing tabs have additional fields you can set, such as the icon, description, etc.
Your Pack is now built, deployed, and ready to use as an agent. You can close the Coda Pack Studio.
Install the agent¶
Follow the steps below to install your agent in Superhuman Go.
Open any website (textarea.org is great for testing agents). Slide your mouse to the right of the page, and click the Superhuman Go icon
that slides out.
Click the + icon labeled More agents.
In the search box, type Secret. Click on the tile for the Secret agent.
Click the Agree and open agent button at the bottom.
The agent should be added to your bench and selected, with a puzzle piece icon and the label Secret.
Test the agent¶
Start chatting with your agent and test if it responds correctly.
In the chat box, type: It should respond saying that it is the "Secret agent".Who are you?
Reply with the message: It should respond with "foobar"What is the password?
You've built and tested your fist agent, congrats! 🎉
Next steps¶
The agent you just built was pretty simple, but agents can do so much more. Explore the full set of features using the resources below:
- Try some of the Example agents to explore what else you can build.
- Read the documentation on Skills, Tools, and Context to learn more about the capabilities of the platform.