Server-side Usage
Prerequisite
- Scoopika account. create one here.
- Scoopika access token. generate one here.
- Initialized Scoopika instance. check the quickstart.
Initialize Agents
Before being able to use agents, you need to intialize them:
import { Agent } from "@scoopika/scoopika";
const agent = new Agent("AGENT_ID", scoopika); // replace with your Scoopika instance
Run Agent
const response = await agent.run({
inputs: {
message: "Hello!"
},
hooks: {
onToken: (t) => console.log(t) // capture each token the agent outputs in real-time
}
})
console.log(response);
The agent.run
method takes an object with the properties inputs and hooks, learn more.
Load Agent Data
The agent data, like its name, are not loaded from the platform once you initialize the agent, and instead are loaded after the first time you use the agent or run it. so you can pre-load it to get access to it before making a run:
// Pre load agent data
await agent.load();
const agentData = agent.agent;
// get specific info (no need for pre-loading)
const agentName = await agent.info("name"); // string
Add Tools to Agent
You can add custom functions as tools to agents that they can use when needed based on context.
Notice that this page does not show how you can build a tool schema, check Tools documentation for that.
const toolSchema = {...}; // Replace with your tool schema
function toolFunc = () => {}; // Replace with your custom function
agent.addTool(toolFunc, toolSchema);
To learn more, check the full docs.
Pass Agents as Tools to Other Agents
You can pass an agent as tool to another agent, so the primary agent can call the tool agent when it needs to. You can use this in bigger systems where you have multiple agents for different tasks and set of tools.
const agent1 = new Agent("AGENT_ID-1", scoopika);
const agent2 = new Agent("AGENT_ID-2", scoopika);
await agent1.addAgentAsTool(agent2);
Was this page helpful?