Quickstart (v1)

This is archived v1 documentation. For the current v2 docs, see the Agentic Framework overview and v2 quickstart. For migrating from v1 to v2, see the migration guide.

This guide will walk you through setting up your first agent and getting it running end-to-end.

After completing this quickstart, you’ll have a working agent and know where to go next based on your use case.

Prerequisites

API access credentials
Development environment set up
Basic understanding of REST APIs

Create a Project in the Corti Console

Start by creating a project in the Corti Console. This gives you a workspace and access to manage your clients and credentials. If you haven’t set up authentication before, follow the Creating Clients and authentication quickstart guides.

Create Your First Agent

Use the Corti Agentic API to create your first agent. You’ll need an access token (obtained using your client credentials) and your tenant name.

# Replace these with your values
ENVIRONMENT="<eu-or-us>"
TENANT="<your-tenant-name>"
TOKEN="<your-access-token>"

curl -X POST "https://api.${ENVIRONMENT}.corti.app/agents" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Tenant-Name: ${TENANT}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Agent",
    "description": "A simple agent to get started with the Corti Agentic Framework"
  }'

Run Your Agent

Use your stored credentials to authenticate, then run your agent end-to-end and verify it processes input and returns the expected outputs.

# Replace these with your values
AGENT_ID="<your-agent-id>"
ENVIRONMENT="<eu-or-us>"
TENANT="<your-tenant-name>"
TOKEN="<your-access-token>"

curl -X POST "https://api.${ENVIRONMENT}.corti.app/agents/${AGENT_ID}/v1/message:send" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Tenant-Name: ${TENANT}" \
  -H "Content-Type: application/json" \
  -d '{
    "message": {
      "role": "user",
      "parts": [{ "kind": "text", "text": "Hello there. This is my first message." }],
      "messageId": "550e8400-e29b-41d4-a716-446655440000",
      "kind": "message"
    }
  }'

Next Steps

Depending on your use case:

Building custom agents: See Core Concepts
Integrating with existing systems: See SDKs & Integrations
Understanding the architecture: See Architecture Overview
Working with protocols: See A2A Protocol and MCP Protocol

Please contact us if you need more information about the Corti Agentic Framework.

Beginners' Guide Core Concepts

⌘I

Quickstart

Concepts

Guides

Reference

Registry Connectors

Agent SDK

v1 Documentation (archived)

Prerequisites

Create a Project in the Corti Console

Create Your First Agent

Run Your Agent

Next Steps

​Prerequisites

Create a Project in the Corti Console

Create Your First Agent

Run Your Agent

​Next Steps

Prerequisites

Next Steps