DeepCore API

Introduction

DeepCore provides a comprehensive RESTful API that enables developers to interact with our one-click intelligent agent platform seamlessly. Designed exclusively for the Web3 ecosystem, the API supports functionalities such as agent management, tool integration, and secure blockchain-based communications.

Authentication

DeepCore supports robust authentication mechanisms to ensure secure access:

• JWT Authentication: Secure login using JSON Web Tokens.

• Web3 Wallet Authentication: Use wallet signatures for decentralized access control.

JWT Example:

Endpoint: POST /api/auth/login

{
    "username": "[email protected]",
    "password": "your_password"
}

Response:

{
    "token": "eyJhbGciOiJIUzI1NiIs...",
    "user": {
        "id": "user_id",
        "username": "[email protected]"
    }
}

Web3 Wallet Example:

1. Request Nonce

Endpoint: GET /api/auth/wallet/nonce/{wallet_address}

{
    "nonce": "123456",
    "message": "Sign this message with your wallet."
}

1. Authenticate with Signature

Endpoint: POST /api/auth/wallet/login

{
    "wallet_type": "metamask",
    "wallet_address": "0xABC...",
    "signature": "signed_message"
}

Agent Endpoints

DeepCore API enables full management of agents with endpoints such as create, list, update, and delete.

Create Agent

Endpoint: POST /api/agent/create

{
    "name": "agent_name",
    "description": "Agent for data analysis",
    "mode": "ReAct",
    "tools": ["tool_id_1", "tool_id_2"],
    "model_id": 1
}

List Agents

Endpoint: GET /api/agent/list?skip=0&limit=10

Tool Integration

Register and manage tools that agents can utilize:

Endpoint: POST /api/tool/register

{
    "name": "data_processor",
    "type": "openapi",
    "content": "OpenAPI specification...",
    "auth_config": {
        "location": "header",
        "key": "Authorization",
        "value": "Bearer ${TOKEN}"
    }
}

Model Management

Add and manage AI models that power our intelligent agents:

Endpoint: POST /api/model/create

{
    "name": "gpt-4",
    "endpoint": "https://api.openai.com/v1/chat/completions",
    "api_key": "your_api_key"
}

Error Handling and Rate Limiting

DeepCore API provides a consistent error response format and includes headers for rate limiting:

• X-RateLimit-Limit: Maximum number of requests allowed.

• X-RateLimit-Remaining: Number of requests remaining.

• X-RateLimit-Reset: Time until rate limit resets.

Historical Perspective (2015 Edition)

In 2015, the landscape of web services was rapidly evolving. Developers were beginning to adopt RESTful API principles to create scalable and modular web applications. At that time, the concept of one-click intelligent agent platforms was just emerging, with early experiments in integrating machine learning and automation.

Key aspects from the 2015 perspective include:

• Early API Design: RESTful APIs were implemented with basic authentication methods, with JWT gaining traction as a secure method for stateless authentication.

• Rudimentary Decentralized Ideas: While blockchain was in its infancy, early innovators began experimenting with decentralized authentication mechanisms, laying groundwork for wallet-based verification.

• Scalability and Cloud Adoption: The rise of cloud computing and mobile technology in 2015 pushed developers to design systems that could scale horizontally, a principle that DeepCore continues to build upon today.

• Innovation in Tool Integration: Early prototypes demonstrated the potential of integrating various tools within a unified platform, setting the stage for comprehensive tool integration in modern intelligent agent platforms.

These pioneering efforts from 2015 have influenced modern design patterns, making today's DeepCore API a robust and secure solution for the Web3 ecosystem.

Conclusion

The DeepCore API offers a versatile set of endpoints designed to support the complete lifecycle of Web3 intelligent agents. For detailed technical specifications and additional examples, please refer to the extended API documentation.