camile-ai 0.1.0

SDK oficial da Camile AI — plataforma de IA empresarial

Camile AI — SDK Python

SDK oficial da Camile AI — plataforma de IA empresarial com agentes autônomos, RAG, capacidades modulares e multi-tenancy.

Instalação

pip install camile-ai

Uso Básico

Chat

from camile import CamileAI

client = CamileAI(api_key="cml_live_sua_chave_aqui")

response = client.chat.completions.create(
    messages=[
        {"role": "system", "content": "Você é um assistente útil."},
        {"role": "user", "content": "Qual é a capital do Brasil?"},
    ],
    model="camile-v1",
)

print(response.choices[0]["message"]["content"])
# → Brasília

Agentes

# Listar agentes
agents = client.agents.list()
for agent in agents:
    print(f"{agent.id}: {agent.name}")

# Criar agente
agent = client.agents.create(
    name="Atendimento",
    description="Agente de atendimento ao cliente",
)

# Executar agente
result = client.agents.execute(
    agent_id=agent.id,
    input="Qual o horário de funcionamento?",
)
print(result["response"])

Capacidades

# Catálogo de capacidades
caps = client.capabilities.list()
for cap in caps:
    print(f"  {cap.icon or '🔧'} {cap.name} — {cap.description}")

# Vincular capacidade a um agente
client.capabilities.attach(agent_id="ag_xxx", slug="web-search")

RAG (Busca Semântica)

# Criar coleção de conhecimento
col = client.rag.create_collection(
    name="Base de conhecimento",
    description="Documentos da empresa",
)

# Buscar informações
results = client.rag.search(
    collection_id=col.id,
    query="Qual o prazo de entrega?",
    top_k=5,
)
for r in results:
    print(f"[{r.score:.2f}] {r.text[:100]}...")

Memória do Agente

# Salvar memória
client.memory.save(
    agent_id="ag_xxx",
    content="Cliente prefere atendimento via WhatsApp",
    type="long_term",
)

# Consultar
memories = client.memory.list(agent_id="ag_xxx")
for mem in memories:
    print(f"  • {mem.content} ({mem.type})")

Documentação

Documentação completa: docs.camile.ia.br

Desenvolvimento

# Clone o monorepo
git clone https://github.com/CamileAI/camile.git
cd camile/api/sdk/python

# Instale em modo editável
pip install -e .

# Teste
python -c "from camile import CamileAI; print('SDK carregado com sucesso')"

Licença

MIT © Camile AI