BAML快速入门：5个步骤从零开始创建你的第一个AI函数

BAML是一个用于构建强类型LLM函数的编程语言，专为AI工作流和智能体设计。它通过将提示工程转变为模式工程，让开发者能够更可靠地构建AI应用。在本指南中，我将带你通过5个简单步骤创建你的第一个AI函数。

🚀 什么是BAML？

BAML全称"Basically a Made-up Language"，是一种简单但强大的提示语言，专注于构建可靠的AI工作流和智能体。BAML让提示工程变得简单，通过将重点放在提示模型上，从而获得更可靠的输出。

核心优势：

• 强类型系统确保AI函数输出可靠
• 支持多种LLM模型（OpenAI、Anthropic、Gemini等）
• 内置测试和可观察性功能
• 完全开源，支持离线使用

📋 准备工作

在开始之前，确保你的开发环境已经就绪：

1. 安装BAML CLI
2. 选择目标编程语言（Python、TypeScript、Ruby、Go等）
3. 配置API密钥（如OpenAI API密钥）

🛠️ 步骤1：创建BAML项目

首先创建一个新的BAML项目：

# 创建项目目录
mkdir my-baml-project
cd my-baml-project

# 初始化项目
baml init

这个命令会生成项目基础结构，包括配置文件和一些示例文件。

📝 步骤2：编写你的第一个AI函数

在项目中创建.baml文件，定义你的AI函数：

function ExtractResumeInfo(resume_text: string) -> ResumeInfo {
    client "openai/gpt-4o-mini"
    
    prompt #"
        分析以下简历文本，提取关键信息。
        
        简历内容：
        {{ resume_text }}
        
        请按照要求格式输出信息。
    "#
}

class ResumeInfo {
    name string
    email string
    skills string[]
    experience_years int
}

⚙️ 步骤3：生成客户端代码

使用BAML编译器生成目标语言的客户端代码：

baml generate

这个命令会根据你的.baml文件生成对应的客户端库，让你可以在Python、TypeScript等语言中调用这些AI函数。

🔧 步骤4：在代码中调用AI函数

现在你可以在你的应用程序中调用刚刚定义的AI函数了：

Python示例：

from baml_client import b

# 调用AI函数
resume_info = b.ExtractResumeInfo("张三，5年软件开发经验...")
print(f"姓名: {resume_info.name}")
print(f"技能: {', '.join(resume_info.skills)}")

🧪 步骤5：测试和迭代

BAML提供了强大的测试工具，让你能够快速测试和迭代你的AI函数：

1. 使用VS Code扩展进行可视化测试
2. 并行运行测试以提高迭代速度
3. 实时查看提示效果和API请求

🎯 BAML的核心特性

强类型系统

BAML提供完整的类型安全，确保AI函数的输入和输出都符合预期。

多模型支持

轻松在数百个模型之间切换，只需修改几行代码：

function Extract() -> ResumeInfo {
    client openai/o3-mini  // 只需修改这一行
    // ... 其他代码保持不变
}

流式处理

BAML支持流式响应，让你能够构建实时的AI应用：

# 流式调用
stream = b.stream.ExtractResumeInfo(resume_text)
for partial_result in stream:
    # 处理部分结果
    update_ui(partial_result)

📊 实际应用场景

BAML适用于多种AI应用场景：

• 智能客服聊天机器人
• 文档分析和信息提取
• 代码生成和辅助编程
• 数据清洗和格式化

🔍 常见问题解答

Q: 我需要在BAML中编写整个应用程序吗？ A: 不需要！你只需要在BAML中编写提示部分，其他业务逻辑仍然使用你熟悉的编程语言。

Q: BAML支持哪些编程语言？ A: 目前支持Python、TypeScript、Ruby、Go等主流语言。

Q: BAML是免费的吗？ A: 是的，BAML是完全开源的，采用Apache 2许可证。

🏆 总结

通过这5个简单步骤，你已经成功创建了第一个BAML AI函数。BAML的强大之处在于它简化了AI应用的开发流程，让你能够专注于业务逻辑而不是复杂的提示工程。

记住，BAML的核心思想是"LLM提示就是函数" - 每个提示都是一个接受参数并返回类型的函数。这种抽象让你能够像调用普通函数一样调用AI能力，大大提高了开发效率。

现在就开始你的BAML之旅吧！🚀