Ajan çerçevesi kurulum kılavuzu

Hangi uç nokta kullanılmalı?

İki uç nokta — doğru olanı seçin

Tokonomix iki ağ geçidi uç noktası sunar. Seçim, ajanınızın araç çağrıları kullanıp kullanmadığına bağlıdır.

Hangi uç nokta ne zaman kullanılır

OpenClaw

OpenClaw, Anthropic temel URL'si aracılığıyla Tokonomix'e bağlanır. Araç çağırma ve akış kullanıma hazır çalışır.

# OpenClaw config (config.toml or .openclaw)
[api]
base_url = "https://tokonomix.ai/api/anthropic"
api_key  = "tok-your-key"

# For consensus (single-model passthrough via OpenAI endpoint):
# base_url = "https://tokonomix.ai/api/v1"
# model    = "tokonomix-consensus"

# Tool-calling agents: use the Anthropic base URL (Mode B).
# Consensus sessions: switch to the OpenAI-compat base URL above.

LangChain

Özel temel URL ile ChatOpenAI sınıfını kullanın. Araç çağıran ajanlar için Anthropic Messages uç noktasına geçin.

# Python — plain chat or consensus
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="tokonomix-consensus",          # or any model slug
    base_url="https://tokonomix.ai/api/v1",
    api_key="tok-your-key",
)

# Tool-calling agents: switch to the Anthropic endpoint
from langchain_anthropic import ChatAnthropic

tool_llm = ChatAnthropic(
    model="claude-sonnet-4-6",
    base_url="https://tokonomix.ai/api/anthropic",
    api_key="tok-your-key",
)
# Bind tools as usual:
# agent_llm = tool_llm.bind_tools([my_tool])

AutoGen

AutoGen'in OpenAIChatCompletionClient'ı özel temel URL kabul eder. Bunu sohbet ve konsensüs için Tokonomix OpenAI uyumlu uç noktasına ayarlayın.

# Python — AutoGen 0.4+ (autogen-agentchat)
from autogen_ext.models.openai import OpenAIChatCompletionClient

# Plain chat or consensus
client = OpenAIChatCompletionClient(
    model="tokonomix-consensus",          # or any model slug
    base_url="https://tokonomix.ai/api/v1",
    api_key="tok-your-key",
)

# Tool-calling agents: use OpenAI client pointed at the OpenAI-compat endpoint.
# Consensus: pass model="tokonomix-consensus"; remove any tools= argument.
# Note: do NOT pass tools= when using tokonomix-consensus — that model does not
# accept tool definitions and will return a 400 error.

Claude Code MCP

Claude Code, MCP sunucusu aracılığıyla Tokonomix'i alır. Yapılandırıldıktan sonra Claude Code doğrudan tokonomix_consensus_ask ve tokonomix_single_ask'ı çağırabilir.

// ~/.claude/settings.json  (or project .claude/settings.json)
{
  "mcpServers": {
    "tokonomix": {
      "command": "npx",
      "args": ["-y", "tokonomix-mcp"],
      "env": {
        "TOKONOMIX_API_KEY": "tok-your-key"
      }
    }
  }
}

// Available MCP tools after setup:
//   tokonomix_consensus_ask   — ask a question across multiple models at once
//   tokonomix_single_ask      — single-model call with full token accounting
//   tokonomix_get_balance     — check remaining token balance
//   tokonomix_list_models     — enumerate available models and capabilities
//
// Example usage in Claude Code:
//   tokonomix_consensus_ask({ prompt: "Review this function for edge cases", ... })
//
// Note: the MCP tools use the gateway internally — no separate endpoint config needed.

Yaygın hatalar ve düzeltmeler