Quickstart Guide

npm install agent-corex

pip install agent-corex

import { AgentCorex } from 'agent-corex';

const agent = new AgentCorex({
  apiKey: process.env.AGENT_COREX_API_KEY
});

// Step 1: Retrieve tools for a specific task
const tools = await agent.retrieveTools({
  query: "Create a GitHub PR and notify the team on Slack",
  topK: 5
});

console.log('Available tools:', tools);
// Output:
// [
//   { name: 'create-pull-request', score: 0.98 },
//   { name: 'list-repositories', score: 0.95 },
//   { name: 'send-slack-message', score: 0.92 },
//   { name: 'post-comment', score: 0.88 }
// ]

// Step 2: Execute a tool
const result = await agent.executeTool({
  toolName: 'create-pull-request',
  params: {
    repository: 'owner/repo',
    title: 'Auto-generated feature PR',
    body: 'This PR was created automatically by Agent-CoreX',
    fromBranch: 'feature/auto-deploy',
    toBranch: 'main'
  }
});

console.log('PR Created:', result);
// {
//   success: true,
//   pullRequestUrl: 'https://github.com/owner/repo/pull/123'
// }

// Step 3: Chain tools (bonus!)
await agent.executeTool({
  toolName: 'send-slack-message',
  params: {
    channel: '#deployments',
    message: `🚀 New PR created: ${result.pullRequestUrl}`
  }
});

from agent_corex import AgentCorex

agent = AgentCorex(api_key="your_api_key")

# Retrieve tools
tools = agent.retrieve_tools(
    query="Create a GitHub PR and notify the team on Slack",
    top_k=5
)

print("Available tools:", tools)

# Execute a tool
result = agent.execute_tool(
    tool_name="create-pull-request",
    params={
        "repository": "owner/repo",
        "title": "Auto-generated feature PR",
        "body": "Created by Agent-CoreX",
        "from_branch": "feature/auto-deploy",
        "to_branch": "main"
    }
)

print("PR Created:", result)

# 1. Retrieve tools
curl -X GET "https://api.agent-corex.com/retrieve_tools?query=Create%20a%20GitHub%20PR" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

# 2. Execute a tool
curl -X POST "https://api.agent-corex.com/execute_tool" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_name": "create-pull-request",
    "params": {
      "repository": "owner/repo",
      "title": "Auto-generated feature PR",
      "from_branch": "feature/auto-deploy",
      "to_branch": "main"
    }
  }'

// Find the right tool first
const tools = await agent.retrieveTools({
  query: "Deploy to production using Terraform"
});

// Execute the top-ranked tool
const deployment = await agent.executeTool({
  toolName: tools[0].name,
  params: { environment: 'production' }
});

// Step 1: Create task
const task = await agent.executeTool({
  toolName: 'create-jira-issue',
  params: { title: 'Deploy v2.0' }
});

// Step 2: Update Slack
await agent.executeTool({
  toolName: 'send-slack-message',
  params: {
    channel: '#deployments',
    message: `New deployment task: ${task.id}`
  }
});

// Step 3: Trigger deployment
const deployment = await agent.executeTool({
  toolName: 'deploy-terraform',
  params: { version: '2.0' }
});

try {
  const result = await agent.executeTool({
    toolName: 'create-pull-request',
    params: { /* ... */ }
  });
} catch (error) {
  if (error.code === 'TOOL_NOT_FOUND') {
    // Tool not connected, guide user to marketplace
  } else if (error.code === 'RATE_LIMITED') {
    // Retry with backoff
  } else {
    // Handle other errors
  }
}