Skip to content

Guardrails

GuardrailsOutputParser #

Bases: ChainableOutputParser

Guardrails输出解析器。

Source code in llama_index/output_parsers/guardrails/base.py 
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
class GuardrailsOutputParser(ChainableOutputParser):
    """Guardrails输出解析器。"""

    def __init__(
        self,
        guard: Guard,
        format_key: Optional[str] = None,
    ):
        """初始化Guardrails输出解析器。"""
        self.guard: Guard = guard
        self.format_key = format_key

    @classmethod
    @deprecated(version="0.8.46")
    def from_rail(cls, rail: str) -> "GuardrailsOutputParser":
        """从rail。"""
        if Guard is None:
            raise ImportError(
                "Guardrails is not installed. Run `pip install guardrails-ai`. "
            )

        return cls(Guard.from_rail(rail))

    @classmethod
    @deprecated(version="0.8.46")
    def from_rail_string(cls, rail_string: str) -> "GuardrailsOutputParser":
        """来自铁轨字符串。"""
        if Guard is None:
            raise ImportError(
                "Guardrails is not installed. Run `pip install guardrails-ai`. "
            )

        return cls(Guard.from_rail_string(rail_string))

    def parse(self, output: str, *args: Any, **kwargs: Any) -> Any:
        """解析、验证和通过程序自动纠正错误。"""
        return self.guard.parse(output, *args, **kwargs).validated_output

    def format(self, query: str) -> str:
        """使用结构化的输出格式指令格式化查询。"""
        output_schema_text = deepcopy(self.guard.rail.prompt)

        # Add format instructions here.
        format_instructions_tmpl = self.guard.raw_prompt.format_instructions
        # NOTE: output_schema is fixed
        format_instructions = format_instructions_tmpl.format(
            output_schema=output_schema_text
        )

        if self.format_key is not None:
            fmt_query = query.format(**{self.format_key: format_instructions})
        else:
            fmt_query = query + "\n\n" + format_instructions

        return fmt_query

from_rail classmethod #

from_rail(rail: str) -> GuardrailsOutputParser

从rail。

Source code in llama_index/output_parsers/guardrails/base.py 
29
30
31
32
33
34
35
36
37
38
@classmethod
@deprecated(version="0.8.46")
def from_rail(cls, rail: str) -> "GuardrailsOutputParser":
    """从rail。"""
    if Guard is None:
        raise ImportError(
            "Guardrails is not installed. Run `pip install guardrails-ai`. "
        )

    return cls(Guard.from_rail(rail))

from_rail_string classmethod #

from_rail_string(
    rail_string: str,
) -> GuardrailsOutputParser

来自铁轨字符串。

Source code in llama_index/output_parsers/guardrails/base.py 
40
41
42
43
44
45
46
47
48
49
@classmethod
@deprecated(version="0.8.46")
def from_rail_string(cls, rail_string: str) -> "GuardrailsOutputParser":
    """来自铁轨字符串。"""
    if Guard is None:
        raise ImportError(
            "Guardrails is not installed. Run `pip install guardrails-ai`. "
        )

    return cls(Guard.from_rail_string(rail_string))

parse #

parse(output: str, *args: Any, **kwargs: Any) -> Any

解析、验证和通过程序自动纠正错误。

Source code in llama_index/output_parsers/guardrails/base.py 
51
52
53
def parse(self, output: str, *args: Any, **kwargs: Any) -> Any:
    """解析、验证和通过程序自动纠正错误。"""
    return self.guard.parse(output, *args, **kwargs).validated_output

format #

format(query: str) -> str

使用结构化的输出格式指令格式化查询。

Source code in llama_index/output_parsers/guardrails/base.py 
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
def format(self, query: str) -> str:
    """使用结构化的输出格式指令格式化查询。"""
    output_schema_text = deepcopy(self.guard.rail.prompt)

    # Add format instructions here.
    format_instructions_tmpl = self.guard.raw_prompt.format_instructions
    # NOTE: output_schema is fixed
    format_instructions = format_instructions_tmpl.format(
        output_schema=output_schema_text
    )

    if self.format_key is not None:
        fmt_query = query.format(**{self.format_key: format_instructions})
    else:
        fmt_query = query + "\n\n" + format_instructions

    return fmt_query