CodeBuddy Agent SDK

SDK for building AI agents with CodeBuddy Code's capabilities. Programmatically interact with AI to build autonomous agents that can understand codebases, edit files, and execute workflows.

Installation

``bash
npm install @tencent-ai/agent-sdk
`

Quick Start

`typescript
import { query } from '@tencent-ai/agent-sdk';

const response = query({
prompt: 'What files are in this directory?',
options: {
permissionMode: 'bypassPermissions',
},
});

for await (const message of response) {
if (message.type === 'assistant') {
for (const block of message.message.content) {
if (block.type === 'text') {
console.log(block.text);
}
}
}
}
`

API Reference

$3

Create a query to interact with the agent.

`typescript
const q = query({
prompt: string, // The prompt to send
options: {
model?: string, // Model to use
permissionMode?: 'default' | 'acceptEdits' | 'bypassPermissions',
maxTurns?: number, // Maximum conversation turns
cwd?: string, // Working directory
hooks?: HookCallback[], // Event hooks
agents?: Record, // Custom agents
},
});

// Iterate over messages
for await (const message of q) {
// Handle message
}

`

$3

- system - Session initialization info
- assistant - Agent responses (text, tool calls)
- result` - Query completion status

Related Links

- CodeBuddy Code CLI
- Documentation
- Issues

Feedback

- Submit issues at Issues
- Contact: codebuddy@tencent.com